v0.1.4

First release that should auto-update from a previous v0.1.3 install via Sparkle. No user-facing changes — this is a test of the update pipeline.

If you're installing manually:

1. Download cmdcmd.zip and unzip.
2. Drag cmdcmd.app to /Applications.
3. Strip quarantine: xattr -dr com.apple.quarantine /Applications/cmdcmd.app (or System Settings → Privacy & Security → Open Anyway after the first failed launch).
4. Grant Screen Recording + Accessibility on first launch.

Requires macOS 14+. Apple-silicon build.

v0.1.3

What's new

• Auto-updates via Sparkle. Future versions install on quit. cmdcmd checks the appcast on launch (and once a day after that). You can also right-click the ⌘ ⌘ Dock icon and pick Check for Updates….

This is the first build that ships Sparkle, so this version still needs to be installed manually — every release after this one will offer to install itself.

Install

1. Download cmdcmd.zip and unzip.

2. Drag cmdcmd.app to /Applications.

3. macOS will refuse to open it the first time because the app is not Apple-notarized. Strip the quarantine attribute:

   xattr -dr com.apple.quarantine /Applications/cmdcmd.app

   Or open it once, then go to System Settings → Privacy & Security and click Open Anyway.

4. On first launch cmdcmd asks for Screen Recording (live tile previews) and Accessibility (the trigger, raising / closing windows). Both are required.

Requires macOS 14+. Apple-silicon build.

v0.1.2

What's new

• Discoverable default config. ~/Library/Application Support/cmdcmd/config.json is auto-created on first launch, pre-populated with every default binding in aligned columns. Each line carries an inline // comment describing what the action does, and animations / trigger each have a header comment explaining the value.
• JSONC parsing. // line comments are stripped before JSON decoding, so you can keep the descriptions (or add your own) in the live file.

Install

1. Download cmdcmd.zip and unzip.

2. Drag cmdcmd.app to /Applications.

3. macOS will refuse to open it the first time because the app is not Apple-notarized. Strip the quarantine attribute:

   xattr -dr com.apple.quarantine /Applications/cmdcmd.app

   Or open it once, then go to System Settings → Privacy & Security and click Open Anyway.

4. On first launch cmdcmd asks for Screen Recording (live tile previews) and Accessibility (the trigger, raising / closing windows). Both are required.

Requires macOS 14+. Apple-silicon build.

v0.1.1

What's new

• WASD now works as default movement aliases for the grid (alongside the arrow keys).
• ⌘W closes the selected window via Accessibility and removes the tile from the grid.
• Configurable shortcuts and trigger — drop a JSON file at ~/Library/Application Support/cmdcmd/config.json to override key bindings, the summon trigger, or to disable animations. Right-click the ⌘ ⌘ Dock icon and pick Open Config… to create the file (with a template) and open it in your default editor.
• Smoother show/pick — the previously-focused window's tile zooms out from full-screen to its grid slot when you open the overlay; the selected tile zooms back in when you pick or hit ⌘⌘ to dismiss. The selection ring no longer flickers during the zoom.

Install

1. Download cmdcmd.zip and unzip.

2. Drag cmdcmd.app to /Applications.

3. macOS will refuse to open it the first time because the app is not Apple-notarized. Strip the quarantine attribute:

   xattr -dr com.apple.quarantine /Applications/cmdcmd.app

   Or open it once, then go to System Settings → Privacy & Security and click Open Anyway.

4. On first launch cmdcmd asks for Screen Recording (live tile previews) and Accessibility (the trigger, raising / closing windows). Both are required.

Requires macOS 14+. Apple-silicon build.

v0.1.0

First release of cmd & cmd — a keyboard-first window switcher for macOS.

Tap left ⌘ and right ⌘ at the same time to fan every visible window on the current monitor out into a grid of live previews. Tap again, or press `esc`, to dismiss.

Requires macOS 14+. Apple-silicon build.

Install

1. Download `cmdcmd.zip` and unzip.

2. Drag `cmdcmd.app` to `/Applications`.

3. macOS will refuse to open it the first time because the app is not Apple-notarized. Strip the quarantine attribute:

   ```sh
   xattr -dr com.apple.quarantine /Applications/cmdcmd.app
   ```

   Or open it once, then go to System Settings → Privacy & Security and click Open Anyway.

4. On first launch cmdcmd asks for Screen Recording (live tile previews) and Accessibility (the ⌘⌘ chord and to raise the chosen window). Both are required.

Keys (overlay)

Key	Action
arrow keys	Move selection
`1`–`9`	Pick that tile
`return`	Pick selected tile
`space` (hold)	Peek (zoom selected tile while held)
⌘ + arrow	Swap selected tile with neighbour
⌘`delete`	Ignore / un-ignore selected window
⌘Y	Toggle "show hidden" view
⌥`g`/`b`/`r`/`y`/`o`/`p`	Tag selected tile
⌥`0`	Clear tag
`esc`	Dismiss overlay