Install

1. Open the DMG file
2. Drag CMD Palette to your Applications folder
3. Launch it from Applications — you'll see a small icon in your menu bar

Set Up Your Projects

1. Click the CMD Palette icon in your menu bar to open the palette
2. You'll see a Set Projects Folder button at the top — click it
3. A folder picker will open — navigate to the folder where you keep your coding projects (e.g. ~/repos)
4. CMD Palette will scan that folder and list every subdirectory as a project

Launch a Project

Each project in the list has up to three actions:

• Terminal — Opens a new Terminal.app window at the project directory
• Dev — Starts the dev server (detected automatically, or configured via .cmdpalette.json)
• Browser — Opens the project's localhost URL in your default browser

Click any action directly, or use keyboard navigation:

1. Press Cmd+Shift+< to open the palette from anywhere
2. Arrow Down/Up to highlight a project
3. Arrow Left/Right to switch between Terminal, Dev, and Browser
4. Press Enter to execute

If a project has a .cmdpalette.json file in its root, CMD Palette will use it for the dev command and URL:

{
  "dev": "npm run dev",
  "url": "http://localhost:3000"
}

Without a config file, CMD Palette auto-detects the dev command from your project files (package.json, Cargo.toml, etc.). Static HTML projects with an index.html get a one-click browser open.

Copy Commands

CMD Palette includes a searchable library of common dev commands (git, npm, process management, etc.).

1. Click a category to expand it, or just start typing in the search bar to filter
2. Click any command to copy it to your clipboard
3. Paste it into your terminal

A green checkmark confirms the copy. Search works across command names, descriptions, and the actual command text.

Keyboard Shortcuts