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
Default shortcuts
Section titled “Default shortcuts”Search
Section titled “Search”| 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. |
Navigation
Section titled “Navigation”| 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. |
Workspace
Section titled “Workspace”| 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. |
Running
Section titled “Running”| 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. |
Menus and pickers
Section titled “Menus and pickers”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.
Mac app
Section titled “Mac app”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.
Change a shortcut in the app
Section titled “Change a shortcut in the app”- Open Settings and select Shortcuts.
- Select the shortcut you want to change. When it shows Type shortcut, press the new keys. Hansard saves the change right away.
- To turn a shortcut off, press Backspace or Delete while recording. Press Escape to cancel without changing anything.
- 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.