Keyboard Shortcuts

Terminal & Panel Management

Directional Navigation

Agent Shortcuts

Voice Input

This shortcut is context-sensitive. When the hybrid input bar has focus, it pastes clipboard content as plain text. Otherwise, it toggles voice dictation for the focused terminal. See Voice Input for setup and usage.

Worktree Shortcuts

Navigation & Palettes

System

Chord Shortcuts

Chord shortcuts are two key combinations pressed in sequence. Press the first combo, release, then press the second within one second. All chord sequences currently use Cmd+K as their first key.

When you press the first key and pause, a floating indicator appears at the bottom of the screen after about 200ms. It shows which second keys are available, grouped by category. If you type the full chord quickly, the indicator never appears, so it won't slow you down. Press Esc to cancel a pending chord.

Terminal Chords

Worktree Session Chords

Navigation Chords

Portal Shortcuts

These shortcuts are active when the Portal has focus:

Diagnostics

Customization

Every shortcut can be customized in Settings > Keyboard:

• Search — filter by name or key combination
• Rebind — click a shortcut and press your preferred key combo
• Conflict detection — warns you if your new binding is already in use
• Reset — reset individual shortcuts to defaults, or reset all at once

Your custom bindings are stored as overrides, not replacements. The defaults are always preserved, so you can reset individual shortcuts or everything at once.

Customized shortcuts display their key combo in accent color, making them easy to spot in the list.

Shortcut Profiles

Share your shortcut configuration with teammates or sync it across machines using the Export and Import buttons in the Settings > Keyboard toolbar.

Export saves a .json file containing only your overrides (not every default binding), keeping profiles lightweight. Import merges the file's overrides onto your existing configuration. It does not replace your current bindings.

The profile format looks like this:

{
  "schemaVersion": 1,
  "exportedAt": "2026-04-04T12:00:00.000Z",
  "app": "canopy",
  "overrides": {
    "terminal.new": ["Cmd+Alt+T"],
    "terminal.duplicate": ["Cmd+T", "Cmd+Shift+D"]
  }
}

On import, Canopy validates the file size (100 KB max) and schema version. Any action IDs that don't exist in the current app version are silently skipped, so profiles are safe to share across different Canopy releases.

Worktree List Navigation

The worktree list supports arrow keys and optional Vim-style navigation:

• Default — arrow keys, Enter/Space, and quick actions shown above
• Vim-style bindings — j/k for worktree list movement

Cmd+T and the Last-Closed Terminal

Cmd+T does more than open a blank terminal. In the panel grid, when panels are open, it duplicates the focused panel. When all panels have been closed, it creates a fresh terminal seeded from the configuration of the last panel you closed.

This means if you close a Claude terminal and press Cmd+T, you get a new Claude terminal in the same working directory, with the same model and launch flags. The snapshot captures:

• Agent type (Claude, Gemini, Codex, OpenCode, or plain terminal)
• Working directory and worktree
• Model ID and agent launch flags
• The original command string (preserved verbatim)

This is different from Cmd+Shift+T, which restores the actual terminal instance from the trash (scrollback history and all). Cmd+T starts a fresh process using the last-closed configuration as a template. See Terminals & Panels for more on panel types and the grid layout.