Keyboard shortcuts

Polycode keeps its menu-command shortcuts in a single catalog of thirteen entries, and renders that same catalog in-app under Settings → Appearance → Shortcuts (“Keyboard reference. Current bindings for every menu command.”), so what you see in the app and what you see here can’t drift apart.

CommandShortcutWhat it does
New Session⌘NStart a new chat in the active project.
New Window⌘⇧NOpen a second main window.
Rename Session⌘SRename the active session.
Archive Session⌘⌫Archive the active session (reversible).
Delete Session⌘⇧⌫Permanently delete the session and its history (asks to confirm).
Find in Session⌘FFocus search, scoped to the active session.
Find Across All Sessions⌘⇧FFocus search across every session.
Focus Composer⌘KMove the cursor to the composer.
Cancel In-Flight Query⌘.Stop the streaming response.
Toggle Sidebar⌘\Show/hide the session sidebar.
Toggle Inspector⌘⇧IShow/hide the per-provider trace panel.
Switch Project⌘⇧OOpen the project picker.
Settings⌘,Open the Settings window.

A few things worth knowing:

  • Find in Session (⌘F) and Find Across All Sessions (⌘⇧F) focus the same sidebar search field — the only difference is scope. Search runs locally over Polycode’s full-text index.
  • Archive is reversible (it just sets an archived flag); Delete is a hard, confirmed delete that also removes the session’s exchanges, traces, and search-index rows.
  • Every command except New Window and Settings targets the focused window, so it’s disabled when no Polycode window has focus. New Window always works, and Settings (⌘,) comes from the Settings window itself, so it opens whether or not a main window is in front.
  • Five commands need more than a focused window: Rename, Archive, Delete, and Find in Session stay greyed out until a session is active, and Cancel In-Flight Query (⌘.) lights up only while a response is streaming.
  • Toggle Inspector (⌘⇧I) is also a toolbar button, which carries no binding of its own. Switch Project (⌘⇧O) is also the sidebar project picker, which registers ⌘⇧O itself alongside the menu command.

Composer and Quick Prompt keys

These are context-local and aren’t part of the menu catalog above:

KeyWhereWhat it does
⌘⏎ComposerSend the prompt.
EscComposer (while streaming)Cancel the in-flight query.
@ComposerAttach a project file.
!!ComposerTarget a model for one send.
⌘↵Quick Prompt overlaySubmit to consensus.
/ Quick Prompt overlayMove the highlight.

For the composer accelerators in depth, see composing prompts; for the global hotkey that opens Quick Prompt from any app, see Quick Prompt & system integration.

What’s next