Keyboard shortcuts

⌘ — Cmd on macOS, Ctrl on Windows and Linux. The full list is always available in the application: Settings → Keys — one list “command · keys” with search by name and by keys (“palette”, “cmd j”, “⌘ J”, “ctrl+shift+]” find the same line). There, combinations are reassigned, and overrides are written to a file: “Export to file” writes JSON (pulse.shortcuts.v1, only what you changed) to the folder exports application data, “Import...” accepts such JSON as an insert or file and replaces the entire overrides, naming the discarded one. ⌘ / in any section, opens a cheat sheet - a side panel with the keys of this section and their current combinations; closes the same ⌘ / or Esc.

Global

Keyboard shortcuts Action Reassigned
⌘ N New task (focus in composer) yes
⌘ ⇧ N New window yes
⌘ , Settings yes
⌘ 1 … ⌘ 6 Sections: Dashboard · Tasks · Repositories · Activity · Settings · Terminal in full screen (repeat - back) yes, each section separately
⌘ ⇧ G Agent Graph of the entire board; from the “Terminal” screen - the task graph of the current tab (its CLI agent node is highlighted; the tab outside the tasks - in words that there is no task) yes
⌘ J Bottom terminal panel: open or close; on the “Terminal” screen - collapse to panel yes
⌘ K Palette: tasks, application commands, project scripts, command history (opens from the board in the tasks section) yes
⌘ / Cheat sheet on section keys (repeat - close) yes

Board

Keyboard shortcuts Action Reassigned
Click in the search field Filter boards by title, ID and branch; from the keyboard - palette command “Search by tasks on the board” no: input field, ⌘ K given to the palette
Click · double click · ↵ Open task no: mouse and normal input
Esc Return to the board from an open task no: Esc closes everywhere

Problem

Keyboard shortcuts Action Reassigned
⌘ F Search by transcript yes
⌘ T New terminal in the “Terminal” tab yes
⌘ ⇧ ] · ⌘ ⇧ [ Next/previous task session; with the panel open ⌘ J - her tabs yes
⌘-click · ⇧-click in the tree Multiple file selection in diff no: mouse
⌘ A in the tree Select all diff files no: system “select all”

Terminal

Blocks mode in the panel ⌘ J and in the "Terminal" section. The block is selected by clicking or using the keyboard; combinations affect the selected one.

Keyboard shortcuts Action Reassigned
⌘ ↑ Select the last block (from the input line - go to blocks) yes
⌘ ⇧ D · ⌘ ⇧ E Cut the panel to the right / down - only in the "Terminal" section (⌘ 6), no more than four panels; new panel - another terminal of the same folder (tab · N); close the panel - there is a cross next to its tab yes
⌘ ⇧ ↵ Expand the active panel to full screen and back yes
⌘ ⌥ = · ⌘ ⌥ - · ⌘ ⌥ 0 The terminal font is larger / smaller / as in the settings - only for this tab (⌘ = and ⌘ - change the scale of the entire window) yes
⌘ ⌥ S Synchronous input: a command launched in the focus panel by ↵ goes entirely to all panels of the group (the bar at the bottom - recipients and checkmarks); ⌘ ⌥ I, like Warp, occupied by developer tools yes
⌘ ⌥ ← · ⌘ ⌥ → · ⌘ ⌥ ⇧ ↑ · ⌘ ⌥ ⇧ ↓ To the adjacent panel on the left / right / top / bottom (up and down - from ⇧because ⌘ ⌥ ↑ and ⌘ ⌥ ↓ busy with failures). On Linux and Windows - Ctrl ⌥; in GNOME Ctrl ⌥ ←/→ may take a change of desktop - reassign yes
⌘ ⌥ ↑ · ⌘ ⌥ ↓ To the previous / next failure: in “Blocks” - select a block with a non-zero code or an interrupted one and scroll to it, in a stream - scroll to its command line (by shell markers). On Linux and Windows - Ctrl ⌥; in GNOME this combination can be taken by changing the desktop - reassign yes
↑ · ↓ Adjacent block; in the input editor ↑ from the first line scrolls through the history of commands by the typed beginning, ↓ from the last one - back; inside multiline text, arrows move the cursor no
⇧ ↵ · ⌥ ↵ New line in the input editor; ↵ sends the entire command (multi-line - one entry) no
↵ Repeat: command of the selected block - into the input line no
⌘ ⇧ C Copy the command of the selected block yes
⌘ ⌥ ⇧ C Copy output of selected block yes
⌘ ⇧ P Pin or unpin a block (pinned ones are at the top of the list) yes
⌘ ⇧ F Find: searches for the terminal itself in the stream, by blocks - with highlighting in cards; ↵ / ⇧ ↵ — next/previous, Esc closes yes
Esc In the editor with text - clear it; otherwise deselect the block, return to the input line no

Everything that is copied from the block comes without ANSI codes and without secrets - see. Tasks and worktree.

Composer

Keyboard shortcuts Action Reassigned
↵ Run a task (floating composer) no: input field key
⇧ ↵ New line no: input field key
⌘ ↵ Send next step to session no: input field key
/ Menu of skills and commands no: input field key

Reassignment

Settings → Keys → “Change” for the desired action → enter a new combination. Esc cancels the recording. While recording is in progress, not a single window combination works: destination ⌘ K does not open the palette at the same time.

What the application will not accept and why - it says in text on the spot:

  • Combination without modifier. Needed ⌘ or ⌥ (Ctrl or Alt): otherwise the combination would work during normal typing.
  • Busy combination. The refusal names the action and the section that supports it, so as not to manually search for a conflict.
  • System combination. ⌘ Q, ⌘ W, ⌘ R, ⌘ H, ⌘ M, window scale, screenshot, etc., which is captured by the system or window shell. Such clicks do not reach the window, and assigning them means promising an action that will not happen. The list depends on the system: ⌘ H busy only in macOS, Alt F4 - only on Windows and Linux.

Reset - with the “Reset” button next to the changed action or “Reset all” in the page header.

Your combinations are stored in the window (localStorage, key pulse.shortcuts.v1) and survive the restart - like the height of the terminal panel and other workplace settings. They are not included in the settings of the main process or in transferring settings between machines.

How it works in code

The only source of bindings is src/renderer/src/shortcuts.ts. Catalog of actions, parsing combinations, checking for system and busy ones - pure logic in src/shared/shortcuts.ts (covered by tests).

The window listens to keys in several places and they all ask for a match from the same source - shortcutHit(event, 'action id'):

Where What catches
src/renderer/src/hooks/useGlobalShortcuts.ts rail sections, new task, new window, settings, search, Agent Graph, neighboring session
components/terminal/TerminalPanel.tsx open/close the panel, its tabs (interception to the shell)
components/transcript/Transcript.tsx search by transcript
components/terminal/TerminalView.tsx new terminal in the tasks tab
components/terminal/BlocksPane.tsx block selection, copy, pin, command repeat

There should not be a second set of bindings: the new combination is added to the directory SHORTCUT_ACTIONS, and the handler calls shortcutHit, but does not compare event.key myself

The comparison is based on the physical key (KeyboardEvent.code), and not by character: on the Russian layout key at ⌘ N - “t”, and binding by symbol would stop working when changing the layout.