Skip to content

Keyboard shortcuts

The app has keyboard shortcuts for search and navigation. You can change any of them except the Mac app’s history and view keys. On a Mac, Primary means Command; elsewhere it means Control.

App
Settings → Shortcuts
Action Shortcut What it does
Command palette Primary+K Search conversations, open a view, or run one of the page’s actions.
Search / Focus the search field in Sessions, Memories, or Settings.
Find in page Primary+F Find text in the open conversation or memory.
Next match in page Primary+G Jump to the next match of Find in page.
Previous match in page Primary+Shift+G Jump to the previous match of Find in page.
Next search result N Jump to the next matching message in archive search.
Previous search result Shift+N Jump to the previous matching message in archive search.
Action Shortcut What it does
Toggle sidebar Primary+\ Show or hide the sidebar.
Next sidebar item J Move to the next conversation or memory in the sidebar.
Previous sidebar item K Move to the previous conversation or memory in the sidebar.
Open boards Primary+Shift+M Browse project discussions and shared topics.
Open Deep Recall Primary+Shift+K Research a question across your archive with Deep Recall.
Open settings Primary+, Open Settings, or leave it when it is already open.
Action Shortcut What it does
Toggle workspace Primary+B Show or hide the changes, files, and terminals beside a conversation.
Open terminal Primary+J Open a terminal in the conversation’s folder, or return to the conversation from it.
Show changes Primary+Shift+B Show or hide the conversation’s changes beside it.
Show changed files Primary+Shift+Y Show or hide the list of changed files in Changes, opening Changes when it is closed.
Go to file Primary+E Find and open a file in the conversation’s project. In a text field, the key stays with the field.
End terminal agent Primary+. End the agent in the conversation terminal the way its own CLI ends.
Switch terminal and transcript Primary+Shift+J Minimize the conversation terminal to read the transcript, or bring the terminal back.
Action Shortcut What it does
Next agent that needs you Primary+Shift+U Open Running at the next agent that waits on you.
Next pane Primary+} Move to the next agent in Running’s Terminals display.
Previous pane Primary+{ Move to the previous agent in Running’s Terminals display.

Every menu and picker, such as Actions, the composer’s pickers, and row menus, uses the same keys. These keys are fixed.

Key What it does
Up, Down Move to the previous or next item.
Page Up, Page Down Move ten items.
Home, End Move to the first or last item.
Right Open a submenu.
Left Close a submenu.
A letter Jump to the next item whose name starts with what you type.
Escape Close the submenu, or the menu.

A disabled item keeps focus and names the reason it is unavailable.

The Mac app has no browser toolbar, so it adds fixed history and view keys. Back and Forward also sit at the left of the title bar, and the mouse’s side buttons move back and forward. The browser viewer leaves these keys to the browser.

Action Shortcut What it does
Back Command+[ Return to the previous view or conversation.
Forward Command+] Go forward again after Back.
Open a view Command+1 to Command+9, then Command+0 Open the first ten dock views in order: Sessions, Running, Review, Projects, Boards, Teams, Graph, Stats, Memories, and Skills & plugins.
Built-in Browser Option+Command+B Open the built-in browser from any view. This key is fixed.

Hold Command for a moment to see the keys that complete each shortcut on screen: the dock’s numbers, , on Settings, \ on the sidebar button, F on Find, [ and ] on Back and Forward, and J, ⇧B, and E on Show terminal, Show changes, and Show files.

  1. Open Settings and select Shortcuts.
  2. Select the shortcut you want to change. When it shows Type shortcut, press the new keys. Hansard saves the change right away.
  3. To turn a shortcut off, press Backspace or Delete while recording. Press Escape to cancel without changing anything.
  4. To restore every default, select Restore defaults.

Shortcuts are saved in this app or browser profile, so the Mac app and the browser viewer keep their own sets.