Keyboard Shortcuts

The command palette and its prefixes, Zen Mode, rebindable shortcuts, per-shortcut terminal passthrough, and the default bindings.

Cordy is keyboard-first. This page lists the default shortcuts, explains how to rebind them, and covers the one thing that makes shortcuts in a terminal app tricky: deciding whether a key press drives Cordy or falls through to the shell.

Throughout, Cmd/Ctrl means the primary modifier — Cmd (⌘) on macOS, Ctrl on Windows and Linux.

Command palette

Press Cmd/Ctrl+K to open the command palette from anywhere — it opens even while a terminal has focus. The input says Run command...; by default it lists commands and files. Start the input with a prefix to change mode:

PrefixMode
>Commands only, hiding files
:Go to a line in the active editor
%Search text across the project
?List these prefixes

Backspace on an empty prefixed input returns to the default mode; Escape closes the palette.

Commands are grouped, in this order:

GroupCommands
WorkspaceNew workspace, Rename workspace, Toggle Browser, Export note for Notion…, Import into note… (while the note pane is open), Close workspace
TabNew terminal tab, Next tab, Previous tab, Split terminal right, Split terminal down, Pin tab / Unpin tab, Close tab (not for a pinned tab), Close other tabs, Arrange panes: <preset>, Arrange panes: Even out
Switch WorkspaceSwitch to workspace: <name> for the other workspaces of the active project
EditorFind in file
Project ToolsShow Git changes, Show files, Reveal active file in Files, Search in project
AgentLaunch <preset>, Split with <preset>
Stop AgentStop <agent>
ExternalOpen in editor, Open external terminal
ProjectAdd repository…
AppOpen performance monitor (hidden in Zen Mode)

Commands that do not apply right now are hidden or shown disabled with the reason, such as "This workspace has no note". Settings opens from the sidebar, not from the palette.

Zen Mode

Press Cmd/Ctrl+Shift+Z to toggle Zen Mode, which collapses the app chrome and spotlights the active workspace's agent terminal. In Zen Mode:

  • the top bar, the left navigation sidebar, and the right Project Tools panel are all hidden; a slim window bar keeps only the drag area and the window buttons (on macOS, room for the window controls);
  • keyboard focus is moved into the agent's terminal so your keystrokes reach it immediately; and
  • a small Exit Zen chip appears, showing the shortcut, so you always have a way out.

Escape is deliberately not bound to exit Zen Mode — the agent CLIs own Escape for their own use. Because Ctrl+Shift+Z is Zen Mode, redo in a note on Windows is Ctrl+Y.

Customizing shortcuts

Every shortcut is rebindable in Settings → Shortcuts. Shortcuts are organized into four groups — Global, Workspace, Editor, and Notes — each shown in a table with the action, its current binding, an In terminal toggle, and an edit control.

To rebind:

  1. Click a shortcut's binding to start recording ("Press shortcut").
  2. Press the new combination. Escape cancels; Backspace or Delete clears the binding.
  3. Most shortcuts require at least one modifier — a bare key is rejected (except the two Vim-style navigation keys). If your combination is already used by another shortcut, Cordy tells you which one.

Each row can be reset to its default, and a Reset all button restores every binding and terminal setting at once. Your customizations are stored locally on your machine; they are not synced anywhere.

Shortcuts in the terminal

Cordy embeds real terminals, and shells and TUIs use their own control-key combinations (for example Ctrl+C, Ctrl+D, Ctrl+K). So when a terminal has focus, Cordy must decide, per keystroke, whether to run its own shortcut or let the raw key through to the shell.

The default: Cordy-first

By default, a configured, modifier-bearing Cordy shortcut wins even while a terminal is focused; any key that does not match a Cordy shortcut falls through to the shell or TUI. Clipboard keys (paste, and copy-with-selection) always fall through so normal terminal copy/paste keeps working.

These keys stay with the shell by default:

  • The alternate workspace keys Alt+↑ / Alt+↓, because CLIs such as Codex bind them. Cmd/Ctrl+↑ / Cmd/Ctrl+↓ still switch workspaces from a terminal.
  • The Editor group (Cmd/Ctrl+S, Cmd/Ctrl+F), so the shell keeps Ctrl+S and Ctrl+F.
  • The Notes group, which only acts inside a note.
  • The Vim-style navigation keys (J / K, which have no modifier), always.

Turning passthrough off per shortcut

Each shortcut has an In terminal switch in Settings → Shortcuts. Turn it off for a shortcut, and while a terminal is focused that key is handed to the shell instead of triggering Cordy. This is how you reclaim, say, Ctrl+D for shell EOF if you'd rather not use it to duplicate a workspace.

Terminal control-key conflicts

On Windows and Linux, Cordy's primary modifier is Ctrl — the same modifier shells use — so some Cordy defaults shadow a shell binding when a terminal is focused. Settings flags each one: "In a focused terminal <combo> overrides <shell action>. Turn off "In terminal" to keep the shell binding." Common shell/readline keys to be aware of:

KeyWhat the shell normally does
Ctrl+CInterrupt (SIGINT) — or copy, when there's a selection
Ctrl+DEnd of input (EOF)
Ctrl+KKill to end of line
Ctrl+A / Ctrl+EMove to start / end of line
Ctrl+U / Ctrl+WDelete to start of line / delete previous word
Ctrl+RReverse history search
Ctrl+LClear screen
Ctrl+SPause output (XOFF)
Ctrl+ZSuspend (SIGTSTP)

The tab shortcuts use Ctrl+Alt (Ctrl+Alt+T, Ctrl+Alt+W, Ctrl+Alt+←/→) so that Ctrl+T and Ctrl+W stay with the shell.

On macOS there is no conflict: Cordy uses Cmd while the shell uses Ctrl, so both coexist. If a specific Cordy default gets in your way in a terminal, turn off its In terminal switch or rebind it. Ctrl+C has special copy-vs-interrupt behavior covered in Troubleshooting.

Default shortcuts

Global

ActionShortcut
Open command paletteCmd/Ctrl+K
Add repository…Cmd/Ctrl+Shift+O

Workspace navigation

ActionShortcut
Next workspaceCmd/Ctrl+↓ (also Alt+↓, off in terminals)
Previous workspaceCmd/Ctrl+↑ (also Alt+↑, off in terminals)
Next workspace (page)Alt+PageDown
Previous workspace (page)Alt+PageUp
First workspaceAlt+Home
Last workspaceAlt+End
Jump to workspace 1–9Cmd/Ctrl+1 … Cmd/Ctrl+9
Jump to workspace 10Cmd/Ctrl+0
Next workspace (Vim)J
Previous workspace (Vim)K

Workspace actions

ActionShortcut
New workspaceCmd/Ctrl+Shift+↓
Duplicate workspaceCmd/Ctrl+D
Close workspaceCmd/Ctrl+Shift+W
Toggle Zen ModeCmd/Ctrl+Shift+Z
Focus TUICmd/Ctrl+←
Focus notesCmd/Ctrl+→
Increase TUI fontCmd/Ctrl+=
Decrease TUI fontCmd/Ctrl+-

Tabs

ActionShortcut
New terminal tabCmd/Ctrl+Alt+T
Close terminal tab (a pinned tab ignores it)Cmd/Ctrl+Alt+W
Next tab (terminal tabs, then file tabs)Cmd/Ctrl+Alt+→
Previous tabCmd/Ctrl+Alt+←

On some Intel graphics drivers, Ctrl+Alt+Arrow rotates the display before Cordy sees it; rebind Next/Previous tab if that happens.

Editor

ActionShortcutIn terminal
Save fileCmd/Ctrl+SOff (shell keeps Ctrl+S)
Save noteCmd/Ctrl+SOff
Find in fileCmd/Ctrl+FOff

Notes

The Notes group holds the note editor's formatting, block, and Turn into shortcuts. See Notes for the full list.

The J / K navigation keys are bare (no modifier) and only act outside a focused terminal or text input.

No OS-global hotkeys

Cordy registers no operating-system-global hotkeys. Every shortcut here works only while a Cordy window has keyboard focus; nothing fires when Cordy is in the background. Closing to the tray does not leave a global key listener behind — the runtime keeps your work alive without one.

  • Workspaces — the panels these shortcuts navigate.
  • Notes — note editor shortcuts.
  • Agents — launching agents from the palette.
  • Troubleshooting — Ctrl+C copy vs. interrupt in the terminal.