CommandPad
Your launchpad for scripts & configs.
Run targets, navigate functions, lint issues — across Makefiles, Shell, PowerShell, Batch, .env and config files.
Why CommandPad?
Ever worked with Makefiles, shell scripts, and .env files in the same project? You need different tools for each. CommandPad gives you one unified experience:
- See a
▶ Run button above every target and function
- Pick & run any target from a quick menu
- Get warned about common mistakes before you run
- Navigate all targets in the sidebar Outline view
No configuration needed. Just install and open a supported file.
Features at a Glance
▶ CodeLens — Run Anything with One Click
Every make target, shell function, PowerShell function, and batch label gets an inline Run button:
# Makefile
▶ Run build ← click to run
build: deps
gcc -o app main.c
▶ Run test
test:
./run_tests.sh
# deploy.sh
▶ Run deploy_staging ← click to run
deploy_staging() {
rsync -avz ./dist/ server:/app/
}
🔍 Quick Pick — Find & Run Any Target
Open the Command Palette (Ctrl+Shift+P) → CommandPad: Pick & Run Target
┌─ Select a Makefile target to run ───────────────┐
│ ƒ build Makefile target — line 3 │
│ ƒ test Makefile target — line 7 │
│ ƒ deploy Makefile target — line 12 │
│ ƒ clean Makefile target — line 18 │
└──────────────────────────────────────────────────┘
🔎 Workspace-Wide Target Search
CommandPad: List All Targets in Workspace — search across all script files in your project:
┌─ Select a target to run from workspace ─────────────────────┐
│ ƒ build Makefile — Makefile:3 │
│ ƒ deploy Shell — scripts/deploy.sh:5 │
│ ƒ Get-Config PowerShell — tools/setup.ps1:12 │
│ ƒ DB_HOST Environment — .env:4 │
└──────────────────────────────────────────────────────────────┘
⚠️ Diagnostics — Catch Mistakes Early
| File Type |
What's Detected |
| Makefile |
Spaces instead of tabs in recipes |
| Shell |
Missing shebang (#!/bin/bash) |
| PowerShell |
Unix aliases (ls, cat, rm) that break portability |
| .env |
Duplicate keys, empty values, unquoted spaces |
| Config |
Duplicate keys within sections |
📋 Outline & Breadcrumbs
All targets and functions appear in VS Code's Outline panel and breadcrumb navigation — jump to any target instantly.
⚡ Auto-Detected Tasks
All targets show up in Terminal → Run Task automatically. No tasks.json configuration needed.
Supported Languages
| Language |
File Types |
Detected Targets |
| Makefile |
Makefile, *.mk, GNUmakefile |
Targets (build:, clean:) |
| Shell / Bash |
*.sh, *.bash, *.zsh |
Functions (my_func() { }) |
| PowerShell |
*.ps1, *.psm1, *.psd1 |
Functions (function Verb-Noun) |
| Batch |
*.bat, *.cmd |
Labels (:build, :deploy) |
| .env |
.env, .env.*, .env.local |
Variables (DB_HOST=localhost) |
| Config / INI |
*.ini, *.cfg, *.conf, *.config |
Sections & keys ([section], key=val) |
Commands
| Command |
Shortcut |
Description |
CommandPad: Run Target |
via CodeLens |
Run the target under the cursor |
CommandPad: Pick & Run Target |
Ctrl+Shift+P |
Pick a target from the current file |
CommandPad: List All Targets |
Ctrl+Shift+P |
Pick a target from all workspace files |
Settings
| Setting |
Default |
Description |
commandpad.makeCommand |
make |
Make executable path |
commandpad.shellCommand |
bash |
Shell for .sh scripts |
commandpad.powershellCommand |
pwsh |
PowerShell executable |
commandpad.enableCodeLens |
true |
Show ▶ Run buttons |
commandpad.enableDiagnostics |
true |
Enable linting |
Getting Started
- Install CommandPad from the VS Code Marketplace
- Open any supported file (Makefile,
.sh, .ps1, .bat, .env, .ini)
- You'll see
▶ Run buttons above targets — click to run
- Use
Ctrl+Shift+P → CommandPad: Pick & Run Target for the quick menu
That's it. No configuration required.
Development
git clone https://github.com/sed-23/commandpad.git
cd commandpad
npm install
npm run compile
# Press F5 to launch Extension Development Host
Contributing
PRs welcome! Open an issue or submit a pull request.
License
MIT © sed-23
