A keyboard-first window switcher for macOS. Press both ⌘ keys at once to fan every visible window out into a grid of live previews, then jump straight to the one you want.
Requires macOS 14+.
brew install --cask peterp/tap/cmdcmdOr download cmdcmd.zip from the latest release, unzip it, and drag cmdcmd.app to /Applications.
⌘ + ⌘ — tap left and right Command at the same time (no other key in between). Tap again, or press esc, to dismiss.
| Key | Action |
|---|---|
| arrow keys | Move selection |
| type a tile's prefix | Pick that tile (e.g. gc for Google Chrome — see Tile labels below) |
return | Pick selected tile |
space (hold) | Peek (zoom selected tile while held) |
| click / drag | Pick or drag-to-reorder |
| ⌘ + arrow | Swap selected tile with neighbour in that direction |
| ⌘W | Close selected window |
| ⌘F | Search / filter visible windows (substring match on app + title) |
⌥g/b/r/y/o/p | Tag selected tile (green/blue/red/yellow/orange/purple) |
⌥0 | Clear tag on selected tile |
delete | Pop the last char from the pick buffer |
esc | Clear pick buffer, or dismiss overlay |
Each tile gets a 2-char prefix derived from its app name — gc for Google Chrome, wa for WhatsApp, cu for Cursor, cc for Claude Code. Type the prefix to pick + activate the window; the matched portion highlights in yellow as you type, and tiles whose prefix doesn't match dim.
A second window of the same app keeps the first letter and grabs the next home-row letter (gj, gk, …). Cross-app collisions extend to 3 chars (Calendar vs Camera → ca vs cam). Assignments are sticky — closing one window doesn't reshuffle the others.
Switch to numeric 1–9 picks (and wasd movement, ⌃+letter app jump) by setting "tilePicks": "numbers" in the config or via Settings.
Tile order persists per display via UserDefaults. Idle windows (no draw activity for ~2.5s) get a subtle indicator dot.
Right-click the ⌘ ⌘ Dock icon and pick Open Config… — that opens ~/Library/Application Support/cmdcmd/config.json in your default editor. The file is auto-created on first launch, pre-populated with every default binding annotated by an inline // comment. Loaded at app launch; restart after edits. // line comments are stripped before JSON parsing.
{
"animations": true,
"animationSpeed": 1.0,
"trigger": "cmd-cmd",
"bindings": {
"h": "move-left",
"j": "move-down",
"k": "move-up",
"l": "move-right",
"cmd+x": "close"
}
}animations: false skips the show / pick zoom transitions.
animationSpeed is a multiplier for animated transitions: 1.0 is normal, 2.0 is twice as fast, and 0.5 is half speed.
trigger chooses what summons the overlay. Default "cmd-cmd" is the both-Command-keys chord. Anything else is treated as a regular hotkey spec — e.g. "cmd+shift+space" or "f13" (uses the same shortcut grammar as bindings). Hotkeys other than the chord require Accessibility permission to be globally observable.
Binding spec — modifier tokens: cmd, shift, opt (or option/alt), ctrl. Special keys: esc, space, return, delete, left, right, up, down. Anything else is a single character.
Actions: pick, dismiss, move-left|right|up|down, swap-left|right|up|down, pick-1 … pick-9, close, search, tag-green|blue|red|yellow|orange|purple|clear.
./build-app.sh # debug build → cmdcmd.app
./build-app.sh release # release build
open cmdcmd.appOr run the binary directly:
swift build
.build/debug/cmdcmdEach user-visible change drops a markdown entry into .changeset/:
./changeset.sh "Short description"# patch (default)
./changeset.sh minor "New feature"
./changeset.sh major "Breaking change"Cut a release with:
./release.shThat bumps the version (highest level across pending changesets wins), prepends a CHANGELOG.md section, regenerates appcast.xml, builds + signs the zip with the Sparkle key from 1Password, tags, pushes, creates the GitHub release, and updates the Homebrew tap. Pending .changeset/*.md files are removed by the same commit. See .changeset/HOWTO.md for the file format.
On first launch you'll see an onboarding window explaining what the app needs and why:
- Screen Recording — for live tile previews (ScreenCaptureKit).
- Accessibility — for the ⌘⌘ chord listener and to raise / forward keys to the chosen window.
Each row has a Grant button that opens the matching pane in System Settings. Click Continue once both are toggled on. Both are required; the app does nothing without them.
The app shows in the Dock as ⌘ ⌘. Right-click it for Open Config… (or quit it the normal way).
Sources/cmdcmd/
main.swift # entry point, AppDelegate (Dock menu), trigger wiring
AppIcon.swift # ⌘⌘ glyph icon, also writes the iconset for make-icon.sh
Onboarding.swift # first-run permission window
Overlay.swift # overlay window, tile grid, selection, animations
OverlayView.swift # NSWindow + NSView event router for the overlay
HintPill.swift # bottom-center mode-hint label
Config.swift # JSON config loader (animations, speed, trigger, bindings)
Keymap.swift # default shortcuts + override resolver
HotkeyMonitor.swift # global hotkey trigger (alternative to CmdChord)
Tile.swift # per-window SCStream preview layer
GridLayout.swift # grid sizing for N tiles at the screen aspect ratio
CmdChord.swift # left+right Command chord detector
SpaceTracker.swift # private CGS/SkyLight space + window enumeration
Log.swift # stderr logger
Resources/ # Info.plist + AppIcon.icns + AppIcon.png
build-app.sh # swift build → .app bundle + ad-hoc codesign
make-icon.sh # regenerate Resources/AppIcon.icns + .png
Pre-release.