zidaneDesktop
Desktop keyboard map
Every desktop app shortcut on macOS and Linux, and how to rebind them.
These tables are generated from the app's source. In the app, Control YY shows the same list, as does ? when you are not typing and no dialog is open. On Linux, cmd is the Super key.
Prompt#
| Action | Keys | Description |
|---|---|---|
| Send message | KeysReturn | DescriptionSend the message. During a run it waits in the queue, or steers the run when Queue messages is off. |
| New line | KeysShift Return | DescriptionStart a new line in the message. |
| Previous history entry | KeysUp Arrow | DescriptionBring back the previous message you sent, from an empty composer. |
| Next history entry | KeysDown Arrow | DescriptionStep forward again through the messages you sent. |
| Mention a file | Keys@@ | DescriptionOpen the mention menu to attach a file or folder to the message. |
| Use a skill | Keys// | DescriptionOpen the slash menu: commands and the skills the agent can use. |
Session#
| Action | Keys | Description |
|---|---|---|
| New session | KeysControl NNorCommand NN | DescriptionLeave the active session and start a fresh one. |
| Back to the main session | KeysControl Shift MM | DescriptionJump to (or lazily create) the pinned "Main" orchestration session for the active directory. |
| Browse messages | KeysControl SS | DescriptionEnter select-turn mode to navigate previous messages. |
| Session details | KeysControl Shift XX | DescriptionOpen the session details modal (rename, export, delete). |
| Switch agent | KeysShift Command II | DescriptionCycle to the next agent profile. |
| Switch model | KeysControl MM | DescriptionOpen the cross-provider model picker. |
| Reasoning effort | KeysControl LL | DescriptionOpen the reasoning-effort picker (when the active model supports it). |
| Todo list | KeysControl TT | DescriptionOpen the Inbox: what waits on you, the plan in progress and the recent ones. |
| Artifacts | KeysControl Shift AA | DescriptionToggle the side panel (artifacts the session produced, plus extension panels). |
| Stop the current work | KeysControl KK | DescriptionCancel a running tool call or background task. |
Session actions#
| Action | Keys | Description |
|---|---|---|
| Generate title | KeysControl Shift TT | DescriptionGenerate a title for the session via the active provider/model. |
| Compact conversation | KeysControl Shift KK | DescriptionCompact older turns via an LLM summary (model still sees everything from the boundary down). |
| Export as Markdown | KeysControl Shift EE | DescriptionExport the session as Markdown under .zidane/sessions/. |
| Export as JSON | KeysControl Shift JJ | DescriptionExport the session as JSON under .zidane/sessions/. |
| Copy session id | KeysControl Shift CC | DescriptionCopy the full session id to the clipboard. |
| Add to or remove from favorites | KeysUnbound | DescriptionAdd the session to favorites, or remove it. |
| Delete session | KeysControl Shift DD | DescriptionDelete the entire session (confirm dialog). |
Panels and tabs#
| Action | Keys | Where | Description |
|---|---|---|---|
| Next panel | KeysControl Shift ]] | WhereAnywhere | DescriptionCycle to the next side-panel tab (opens the panel). |
| Previous panel | KeysControl Shift [[ | WhereAnywhere | DescriptionCycle to the previous side-panel tab (opens the panel). |
| Next tab, file or terminal (else next space) | KeysCommand Option Right Arrow | WhereFocused area | DescriptionNext tab where the focus is: open file, changed file, terminal; elsewhere the next space (Spaces on) or side-panel tab. |
| Previous tab, file or terminal (else previous space) | KeysCommand Option Left Arrow | WhereFocused area | DescriptionPrevious tab where the focus is: open file, changed file, terminal; elsewhere the previous space (Spaces on) or side-panel tab. |
| Close tab, file or terminal | KeysControl WWorCommand WW | WhereFocused area | DescriptionClose the open file in Files, the terminal, or else the active side-panel tab. |
| Split the panel tab right | KeysCommand \\ | WhereAnywhere | DescriptionSplit the side panel's active tab into a new group on the right. |
| Split the panel tab down | KeysOption Command \\ | WhereAnywhere | DescriptionSplit the side panel's active tab into a new group below. |
| Find in the file or diffs (in Files and Diffs) | KeysCommand FForControl FF | WhereFiles, Diffs | DescriptionFind text in the open file or in the diffs. |
| Search across files (in Files and Diffs) | KeysCommand Shift FForControl Shift FF | WhereFiles, Diffs | DescriptionSearch across the workspace files. |
| Show or hide the terminal | KeysControl ``orCommand JJ | WhereAnywhere | DescriptionShow or hide the terminal drawer under the chat. |
| New terminal | KeysControl Shift `` | WhereAnywhere | DescriptionOpen a new terminal in the session's environment (shows the drawer). |
| Annotate the page (in the Browser tab) | KeysCommand .. | WhereAnywhere | DescriptionMark elements and areas of the page in the Browser tab for the agent, or stop marking. |
App#
| Action | Keys | Description |
|---|---|---|
| Command palette | KeysCommand KK | DescriptionToggle the command palette: search every action, command, panel, session and setting. |
| Show or hide the sidebar | KeysCommand BB | DescriptionShow or hide the chats sidebar. |
| Back to the previous conversation | KeysCommand Left ArroworCommand [[ | DescriptionGo back to the conversation shown before, like a browser. |
| Forward to the next conversation | KeysCommand Right ArroworCommand ]] | DescriptionGo forward again to the conversation you went back from. |
| Usage | KeysControl PP | DescriptionOpen the usage panel (rate-limit windows and credits per provider, GitHub API limits). |
| Settings | KeysCommand ,, | DescriptionOpen the Settings modal (toggles, theme, keybindings). |
| Keybindings | KeysControl YYor?? | DescriptionOpen the shortcut reference. |
| Zoom in | KeysCommand PlusPlus | DescriptionIncrease the interface size. |
| Zoom out | KeysCommand MinusMinus | DescriptionDecrease the interface size. |
| Reset zoom | KeysCommand 00 | DescriptionReset the interface size to 100%. |
Keys you cannot rebind#
These keys act only where shown and are not in keybindings.json.
| Where | Keys |
|---|---|
| Anywhere but a dialog | Command FF finds in the conversation, unless Files, Diffs or the editor has the focus |
| Tool approval | Command Return Allow once, Command Shift Return Always allow, Escapeesc Deny |
| File edit approval | AA Allow, SS Allow for session, PP Always allow, DD or Escapeesc Deny |
| Browsing messages (Control SS) | Up Arrow Down Arrow move, Return details, CC copy, FF fork, Escapeesc exit |
| Conversation search | Return next match, Shift Return previous, Escapeesc close |
| Editing a queued message | Return save, Shift Return new line, Command Return send now, Escapeesc cancel |
| Model picker | Tab add or remove a fallback, Control Shift Up Arrow Control Shift Down Arrow reorder |
| Files and Diffs | Command Return attach a review comment, Command SS save the open file |
| Composer, empty | ! shell mode, ? search the transcript |
| Command palette | Up Arrow Down Arrow move, Return run, Escapeesc close |
Rebind a key#
Both apps read the same keybindings.json (location, format).
- In Settings › Interface › Keybindings (read-only), click Edit in file.
- Change a binding and save the file.
- Click Reload. The desktop app applies the keys at once.
The TUI reads the file only at start. Restart the TUI to pick up the change.
Reference#
- Command palette: every action with its shortcut, searchable.
KeyCombo: how the kit draws a chord.