Launcher Plus (Shortcuts)

🎉 What's New in v1.4.0

🔥 Built-in Default Shortcuts

No more manual configuration! Launcher Plus now includes 50+ pre-configured shortcuts for common development tasks:

• ✅ Terminal & Shell: cmd, PowerShell, WSL, Git Bash
• ✅ NPM/Yarn: install, start, test, dev, build
• ✅ Git: status, log, and more
• ✅ Docker: Docker Desktop, docker-compose
• ✅ Languages: Python, Go, Rust, Java, .NET
• ✅ VS Code Extension: compile, watch, package, publish (vsce/ovsx)
• ✅ Browsers: Chrome with dev tools, localhost shortcuts
• ✅ System Tools: Explorer, Task Manager

You only need to add YOUR custom shortcuts! 🎯

// .vscode/launcher-putra.json - Only your custom commands!
[
  {
    "id": "my-deploy",
    "label": "Deploy to Production",
    "program": "cmd.exe",
    "args": ["/c", "deploy.bat"],
    "icon": "rocket"
  }
]

✨ My Shortcuts Group

Your custom shortcuts automatically appear in a dedicated "My Shortcuts" group:

• 📍 Positioned right below Favorites
• 🎨 Strong pink color for visibility
• ✨ Sparkle icon for easy identification
• 🔍 Auto-detected (no configuration needed)

📖 Read the Migration Guide | 📚 Custom Shortcuts Guide | ✨ My Shortcuts Group

✨ Features

🎯 Core Capabilities

• 🌳 Tree View Panel - Organized shortcuts in Explorer sidebar with intuitive navigation
• ⚡ Quick Pick - Lightning-fast command palette integration (Ctrl+Alt+L)
• 🔧 Context Variables - Dynamic path resolution with ${file}, ${workspaceFolder}, ${relativeFile}, ${lineNumber}, ${selectedText}
• 📂 Default App Handler - Open files with OS default applications seamlessly
• 🕐 Recent Items - Track and quickly access recently used shortcuts
• 🎨 Custom Icons - Use VS Code codicons or custom images for visual appeal

🚀 Advanced Features

• ▶️ Play Button Interface - Clean inline play buttons for each shortcut (no more accidental clicks!)
• 🎨 Smart Color Grouping - 17 distinct colored categories for instant visual recognition
• 🔄 Sequence Execution - Chain multiple commands (serial or parallel execution)
• 👥 Profile Management - Filter shortcuts by active profile (dev, ops, testing, etc.)
• 🔍 Auto-Discovery - Automatically detect installed apps (Chrome, Office, Git Bash, WSL)
• 📤 Import/Export - Share configurations across workspaces and teams
• ⚙️ Task Generation - Convert shortcuts to VS Code tasks for build integration
• ✏️ Visual Editor - Edit shortcuts with built-in webview editor interface

🎨 Smart Color Grouping (v1.1.0)

17 Intelligent Categories with Unique Colors:

🎉 What's New in v1.2.0

🖥️ Terminal Internal    🔄 Auto Detection        🚀 VSCE/OVSX Shortcuts
⚡ Development Commands  📊 Status Bar Messages   🔍 Error Handling
🛠️ VS Code Integration  🚫 No External Windows   🔐 Build & Publish

🌟 Major Enhancements:

• 🖥️ Terminal Internal Integration - Development commands like npm run compile now run directly in VS Code's internal terminal, not in separate windows!
• 🔄 Auto Detection - Launcher Plus automatically detects commands that should run in internal terminal (npm, yarn, node, python, go, cargo, dotnet, etc.)
• 💬 Toast/Flash Info - Non-intrusive visual feedback via status bar messages instead of popup notifications
• 🛡️ Error Handling - Terminal stays open when errors occur so you can read error messages
• 🚀 VSCE/OVSX Shortcuts - Pre-configured shortcuts for extension development: compile, package, publish to VS Code Marketplace and OpenVSX
• 🔧 Build Commands - Complete set of shortcuts for extension development workflow

📋 New Commands:

• 🔧 npm run compile - TypeScript compilation
• 📦 npm run package - Create .vsix package
• 🚀 npm run publish:vsce - Publish to VS Code Marketplace
• 🚀 npm run publish:ovsx - Publish to OpenVSX
• 🧹 npm run clean - Clean build artifacts
• 🔨 npm run build - Complete build process

🔄 Terminal Integration: When you run development shortcuts, they automatically:

• Create a new terminal in VS Code named Launcher: [command name]
• Execute the command directly in that terminal (no external CMD windows!)
• Show status bar messages like "🖥️ Running [name] in terminal..." (3 seconds)
• Keep terminal open for monitoring output and error messages
• All extension development commands (compile, package, publish) run in VS Code terminal

🧩 Extension Development Workflow:

🔧 Compile → 📦 Package → 🚀 Publish (OVSX) → 🚀 Publish (VSCE)

All commands run seamlessly in VS Code's integrated terminal!

🎉 Previous Features (v1.1.0)

• ▶️ Play Button Interface - Clean inline play buttons replace click-to-run for better UX
• 🎨 Smart Color Grouping - 17 intelligent categories with unique colored icons
• 🧩 Extension Development - Auto-detected shortcuts for VS Code extension projects
• 🔇 Reduced Notifications - Silent execution with only essential error messages
• 🎯 Improved Detection - Enhanced pattern matching for better categorization

🚀 Previous Features (v1.0.0):

• 🌍 Global Shortcuts - Define shortcuts once, use everywhere across all workspaces
• 🎉 Auto-Initialization - Default shortcuts auto-created on first install with 90+ ready-to-use commands
• 🔄 Auto-Recovery - Deleted shortcuts file? No problem! Automatically restored from template
• 🛡️ Double-Click Prevention - Smart 300ms cooldown prevents accidental multiple executions
• 📊 Loading Indicators - Real-time visual feedback with status bar messages
• 🔍 Smart Validation - Automatic program path verification with detailed reports
• 🔧 Auto-Fix Engine - Intelligent detection and fixing of invalid program paths
• 🚫 Duplicate Prevention - Advanced deduplication by ID ensures clean shortcut list
• 🔐 SSH Shortcuts - Built-in SSH/SCP templates for localhost and remote connections
• ⚡ Build Commands - Pre-configured shortcuts for npm, go, cargo, docker, maven, gradle, dotnet, make

Cross-Platform Support

• ✅ Windows
• ✅ macOS
• ✅ Linux
• ✅ Compatible with VS Code, Cursor, Windsurf, and other VS Code variants

📦 Installation

From VS Code Marketplace (Recommended)

1. 🚀 Open VS Code/Cursor/Windsurf
2. 🔍 Search for "Launcher Plus" in Extensions panel
3. 📥 Install by PutraAdiJaya
4. 🎉 Enjoy 100+ pre-configured shortcuts with smart color grouping!

From VSIX (Manual)

1. 📥 Download the latest .vsix file from releases
2. 🚀 Open VS Code/Cursor/Windsurf
3. ⚙️ Run command: Extensions: Install from VSIX...
4. 📂 Select the downloaded file

⚙️ Configuration

Quick Setup

1. Open Settings File: Click the {} icon in Launcher Plus panel or use Ctrl+Shift+P → Launcher Plus: Open Settings File
2. Choose Scope:
   • 🌍 Global Shortcuts - Available in ALL workspaces (recommended)
   • 📁 Workspace Shortcuts - Only for current project
3. Auto-Creation: File is created automatically with 90+ default shortcuts on first open
4. Edit & Save: Modify shortcuts and save the file
5. Reload: Use the 🔄 reload button in Shortcuts panel or reload window

Manual Setup

Add shortcuts to your settings (JSON):

{
  "launcher.shortcuts": [
    {
      "id": "open-browser",
      "label": "Open in Chrome",
      "icon": "browser",
      "program": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
      "args": ["${file}"],
      "platform": "win"
    },
    {
      "id": "open-terminal",
      "label": "Open Terminal Here",
      "icon": "terminal",
      "program": "wt.exe",
      "args": ["-d", "${workspaceFolder}"]
    }
  ]
}

Default Shortcuts

The extension automatically creates default shortcuts on first install with 90+ pre-configured commands!

File Locations:

Global (Recommended):

• Windows: %APPDATA%\Code\User\launcher-putra.json
• macOS: ~/Library/Application Support/Code/User/launcher-putra.json
• Linux: ~/.config/Code/User/launcher-putra.json

Workspace-Specific (Optional):

• VS Code: .vscode/launcher-putra.json
• Cursor: .cursor/launcher-putra.json
• Windsurf: .windsurf/launcher-putra.json
• Kiro: .kiro/launcher-putra.json

🎯 Loading Priority:

1. Global shortcuts loaded first (available everywhere)
2. Workspace shortcuts loaded after (can override global by ID)
3. Automatic deduplication prevents duplicates

Developer-Focused Shortcuts (100+ Commands):

🧩 VS Code Extension Development (Internal Terminal):

• 🔧 Compile: npm run compile - TypeScript compilation in VS Code terminal
• 📦 Package: npm run package - Create .vsix file in VS Code terminal
• 🚀 Publish OpenVSX: npm run publish:ovsx - Publish to open-vsx.org in VS Code terminal
• 🚀 Publish Marketplace: npm run publish:vsce - Publish to VS Code Marketplace in VS Code terminal
• 👀 Watch: npm run watch - Development watch mode in VS Code terminal
• 🧹 Clean: npm run clean - Clean build artifacts in VS Code terminal
• 🔍 Lint: npm run lint - Code linting in VS Code terminal
• ✨ Format: npm run format - Code formatting in VS Code terminal
• 📦 Direct VSCE Package: vsce package - Direct VSCE packaging in VS Code terminal
• 🚀 Direct VSCE Publish: vsce publish - Direct VSCE publishing in VS Code terminal
• 🚀 Direct OVSX Publish: ovsx publish - Direct OpenVSX publishing in VS Code terminal
• 🔨 Build: npm run build - Complete build process in VS Code terminal

🖥️ All extension development commands run in VS Code's integrated terminal - no external windows!

💻 Terminals & Shells:

• Command Prompt, PowerShell, WSL, Git Bash
• Ubuntu/Debian/Kali Linux (WSL distributions)
• PowerShell Core (pwsh), Windows Terminal

⚡ Build Commands (All Platforms):

• Node.js: npm run serve/dev/start/build/test/lint
• Go: go run main.go, go build, go test
• Rust: cargo run/build/test
• Python: python main.py, Django runserver
• Java: mvn clean install, mvn test
• Gradle: gradle build/test (gradlew)
• .NET: dotnet run/build/test
• Docker: docker-compose up/down
• Make: make, make clean

🔐 SSH & Remote Access:

• SSH to localhost (multiple ports)
• SSH with custom user
• SSH key generation (RSA 4096)
• SSH copy ID (authorized_keys)
• SCP file upload/download
• SSH config testing

📦 Package Managers:

• npm install/start/test, yarn install
• Automatic detection from package.json scripts

🔧 Development Tools:

• Node.js REPL, Python REPL, Docker Desktop
• Git Status, Git Log (Graph)
• Postman, Chrome Dev Mode

🌐 Web Development:

• localhost shortcuts (3000, 8080)
• Port checker utilities
• Browser launchers with dev tools

📁 File & System:

• Explorer shortcuts (Downloads, Documents, Desktop)
• Task Manager, Control Panel
• Registry Editor, Device Manager
• Services, Event Viewer

Auto-Discovery: The extension automatically detects and adds shortcuts for installed applications:

• 🌐 Browsers: Chrome, Firefox, Edge
• 📝 Editors: VS Code variants, Notepad++, Sublime Text
• 💻 Terminals: Git Bash, Windows Terminal, PowerShell Core
• 📊 Office: Word, Excel, PowerPoint, Outlook
• 🔧 Development: Node.js, Python, Git Bash

Shortcut Properties

Available Variables

• ${file} - Current file path
• ${workspaceFolder} - Workspace root path
• ${relativeFile} - File path relative to workspace
• ${lineNumber} - Current cursor line number
• ${selectedText} - Currently selected text

📚 Examples

Open File with Default App

{
  "id": "open-default",
  "label": "Open in Default App",
  "program": "",
  "args": ["${file}"]
}

Multi-Step Workflow (Serial)

{
  "id": "daily-routine",
  "label": "Daily Startup Routine",
  "icon": "rocket",
  "sequence": [
    {"program": "chrome.exe", "args": ["https://mail.google.com"]},
    {"program": "explorer.exe", "args": ["C:\\Users\\%USERNAME%\\Downloads"]},
    {"program": "code", "args": ["C:\\Projects"]}
  ]
}

Parallel Execution

{
  "id": "dev-environment",
  "label": "Start Dev Environment",
  "icon": "server",
  "sequenceMode": "parallel",
  "sequence": [
    {"program": "docker-compose", "args": ["up"], "cwd": "${workspaceFolder}"},
    {"program": "npm", "args": ["run", "dev"], "cwd": "${workspaceFolder}"}
  ]
}

Profile-Based Shortcuts

{
  "id": "ops-tools",
  "label": "Operations Dashboard",
  "profile": "ops",
  "icon": "dashboard",
  "sequence": [
    {"program": "bash", "args": ["-c", "htop"]},
    {"program": "powershell", "args": ["-NoLogo"]}
  ]
}

Set active profile: "launcher.activeProfile": "ops"

SSH Connection

{
  "id": "ssh-server",
  "label": "🔐 SSH to Production Server",
  "program": "cmd.exe",
  "args": ["/c", "ssh", "user@server.com", "-p", "22"],
  "icon": "lock",
  "platform": "win"
}

Build Command with Variables

{
  "id": "go-run-current",
  "label": "⚡ go run ${file}",
  "program": "cmd.exe",
  "args": ["/c", "go", "run", "${file}", "&", "pause"],
  "cwd": "${workspaceFolder}",
  "icon": "play"
}

🎯 Usage

Commands

Access via Command Palette (Ctrl+Shift+P):

Main Commands:

• Launcher Plus: Open Shortcuts - Show quick pick menu
• Launcher Plus: Run Shortcut by ID - Execute specific shortcut
• Launcher Plus: Open Settings File - Choose Global or Workspace shortcuts file
• Launcher Plus: Search Shortcuts - Search and run shortcuts by name
• Launcher Plus: Open CLI Terminal - Open integrated CLI terminal
• Launcher Plus: Run Deployment Tool - Launch deployment interface

Configuration:

• Launcher Plus: Open Settings - Configure extension settings
• Launcher Plus: Open Shortcut Editor - Visual editor (webview)
• Launcher Plus: Validate Shortcuts - Check program paths and show report
• Launcher Plus: Clean Invalid Shortcuts - Remove broken shortcuts

Import/Export:

• Launcher Plus: Import Shortcuts (JSON) - Import configuration
• Launcher Plus: Export Shortcuts (JSON) - Export configuration
• Launcher Plus: Import Shortcuts into Workspace - Workspace-specific import
• Launcher Plus: Export Shortcuts to Workspace - Workspace-specific export

Advanced:

• Launcher Plus: Set Active Profile - Switch profile (dev/ops/etc)
• Launcher Plus: Generate tasks.json - Create VS Code tasks from shortcuts
• Launcher Plus: Rescan Auto-Discovered Apps - Refresh app detection
• Launcher Plus: Clear Cooldowns & Cache - Reset all caches
• Launcher Plus: Debug Info - Show diagnostic information

Keybindings

Default: Ctrl+Alt+L (macOS: Cmd+Alt+L) - Open quick pick

Custom keybindings:

[
  { "key": "ctrl+alt+1", "command": "launcher.run", "args": "open-browser" },
  { "key": "ctrl+alt+2", "command": "launcher.run", "args": "open-terminal" },
  { "key": "ctrl+alt+t", "command": "launcher.openCLI" },
  { "key": "ctrl+alt+d", "command": "launcher.deploy" }
]

Tree View

Shortcuts appear in the Explorer sidebar. Click any item to execute it.

📖 Documentation

Auto-Discovery

Enable automatic detection of common applications:

{
  "launcher.enableAutoDiscover": true,
  "launcher.autoDiscoverPlatforms": ["win", "mac", "linux"]
}

Detected apps include:

• Windows: Chrome, Edge, Office Suite, Notepad, Git Bash, WSL, PowerShell
• macOS: Safari, Chrome, Terminal
• Linux: Common browsers and terminals

Import/Export

Export to file:

1. Run Launcher: Export Shortcuts (JSON)
2. Choose save location

Import from file:

1. Run Launcher: Import Shortcuts (JSON)
2. Select JSON file

Workspace-specific:

• Use Launcher: Export/Import Shortcuts to/into Workspace for project-level configs

Task Generation

Convert shortcuts to VS Code tasks for integration with build systems:

1. Run Launcher: Generate tasks.json from Shortcuts
2. Tasks are created in .vscode/tasks.json
3. Each shortcut becomes a shell task with label launcher:{id}

🔒 Security

⚠️ Important Security Notes:

• Always verify program paths and args before running shortcuts from untrusted workspaces
• Admin elevation (runAsAdmin) shows a warning - run your editor as administrator if needed
• Be cautious with shortcuts that execute shell commands or scripts
• Review imported configurations before applying them

🛠️ Development

Build from Source

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch mode
npm run watch

# Package extension
npm run package

# Lint code
npm run lint

# Format code
npm run format

Publishing

# Publish to Open VSX
npm run publish:ovsx

# Publish to VS Code Marketplace
npm run publish:vsce

Requires tokens: OVSX_TOKEN and VSCE_PAT

🗺️ Roadmap

• [x] CLI Integration and Terminal Mode (v1.2.0)
• [x] Deployment Tools (v1.2.0)
• [ ] Automated Windows admin elevation
• [ ] Shortcut templates library
• [ ] Cloud sync for configurations
• [ ] Macro recording
• [ ] Conditional execution based on file types
• [ ] Enhanced CLI with argument support

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines for details on:

• Code of conduct
• Development setup
• Coding standards
• Pull request process
• Testing requirements

Quick start for contributors:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Make your changes and test thoroughly
4. Run npm run lint and npm run format
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

💬 Support

• 📖 Quick Start Guide - Get started in 5 minutes
• 🖥️ CLI Usage Guide - Learn how to use the terminal integration
• 📧 Report Issues - Bug reports and feature requests
• 💬 Discussions - Questions and community support
• 🔒 Security Policy - Report security vulnerabilities
• 🚀 Deployment Guide - For maintainers
• ⭐ Star the repo if you find it useful!