pattermDocsGitHub

Keyboard shortcuts

View as Markdown

Patterm keeps its own shortcuts to a few chords so that everyday terminal keys still reach your agents.

The tables use Ctrl, which is what Patterm shows on Linux. The command palette, sidebar, board and copy shortcuts also accept Cmd where a Cmd key exists. The font-size and navigation-mode shortcuts need Ctrl.

Anywhere in the workspace##

Shortcut What it does
Ctrl+K Opens or closes Search or jump to, the command palette. See below.
Ctrl+Space Turns navigation mode on or off. See below.
Ctrl+Shift+B Shows or hides the sidebar, in sidebar mode.
Ctrl+Shift+Space Opens the project board, or goes back from it, in sidebar mode.

Patterm catches these before a focused terminal sees them, so the terminal does not also receive them. The one exception is Ctrl+K: with the palette open and the search box empty, pressing Ctrl+K again closes the palette and sends Ctrl+K to the terminal.

Press Ctrl+Space to switch between tabs and agents without reaching for the mouse. A Navigate hint appears at the bottom of the workspace. It works with focus in a terminal or an Integrated composer, but not in other text fields.

Key What it does
A Previous tab
D Next tab
W Previous agent in the family, such as the parent of a subagent
S Next agent in the family, such as the first subagent
1 to 9 Jump to that tab, counting from the left, with pinned tabs first
Esc, Enter or Ctrl+Space Leave navigation mode

Any other key leaves navigation mode and goes to the focused terminal or input. Clicking anywhere or switching windows also leaves it. The keys use their physical positions, so W, A, S and D stay in place on other keyboard layouts.

Command palette##

Key What it does
Up, Down Move through the results
Enter Run the highlighted result
Tab Open the highlighted result's actions, if it has any
Shift+Tab, or Backspace in an empty search box Go back one level
Esc Go back one level, or close the palette from the top level

Terminal##

Shortcut What it does
Ctrl+V or Shift+Insert Paste
Ctrl+Shift+C Copy the current selection
Ctrl++ (or Ctrl+=) Increase the terminal font size by 1 px, up to 24
Ctrl+- Decrease the terminal font size by 1 px, down to 10
Shift+drag Select text in a program that captures the mouse
Ctrl+click (or Cmd+click) Open a link in a program that captures the mouse

Everything else you type goes to the program in the terminal. See Terminal.

With a row in the sidebar focused:

Key What it does
Up, Down Move to the previous or next row
Home, End Jump to the first or last row
Right Expand the agent, or step into its first child
Left Collapse the agent, or step out to its parent
Alt+Up, Alt+Down Move a top-level agent or process up or down in its group

On the sidebar's resize handle, Left and Right change the width by 20 px, Home sets the minimum width and End the maximum. Double-click the handle to reset the width.

Project board##

With the board open (sidebar mode):

Key What it does
Arrow keys Move to the nearest block in that direction
Home, End Jump to the first or last block
Esc Close the board and go back to where you were

Session context panel##

Key What it does
Esc Close the panel
Left, Right on the divider Left makes the panel 20 px wider, Right makes it 20 px narrower

Integrated composer##

These apply to the message box of an Integrated agent.

Key What it does
Enter Send the message, or accept the highlighted item in an open @ or / menu
Shift+Enter Insert a new line
Tab Accept the highlighted item in an open menu
Up, Down Move through an open menu
Esc Close an open menu

Diff review##

Key What it does
] Next file
[ Previous file
v Mark the file as viewed and move to the next one that is not. Review deck layout only.
Esc Close the review
Up, Down, Home, End Move through the file tree
Right, Left Expand or collapse a folder in the file tree

The single-key shortcuts do not fire while you are typing in a field or have a menu open. See Diff review.

Tabs##

Esc cancels a tab you are dragging and puts it back where it was.