# Keyboard shortcuts > Every diri keyboard shortcut grouped by task, plus which surface wins a contested key, how to rebind, and the Linux equivalents. diri is keyboard-first. This page groups every default binding by what you are trying to do. Unless a row says otherwise, a shortcut works whenever the main window is focused, including while you type in a terminal. Modifiers use the macOS glyphs: ⌘ Command, ⇧ Shift, ⌥ Option, ⌃ Control. For a gentler introduction to the handful worth learning first, read [Shortcuts worth learning](/guides/shortcuts/). ## Change a shortcut Open **Settings → Shortcuts** to see every command with its description and rebind or clear it. Custom bindings take precedence over the defaults below, and the native menus, the command palette and the hold-⌘ hints all follow them. ### Linux On Linux, ⌘ becomes Ctrl and ⌃⌘ becomes Ctrl+Shift. A few bindings move to avoid collisions: | Command | macOS | Linux | | --- | --- | --- | | Toggle inspector | ⇧⌘D | Ctrl+Shift+D | | Delegate session | ⌃⌘D | Ctrl+Alt+D | | To-dos | ⌃⌘T | Ctrl+Alt+Shift+T | | Focus pane left / right / up / down | ⌃⌥ + arrow | Ctrl+Alt+H / L / K / J | | Hide diri | ⌘H | none | ## See shortcuts in place Hold ⌘ on its own for a moment (700 ms) and the ⌘ shortcuts appear on the controls they operate: ⌘1 … ⌘9 on session rows and tabs, ⌘T on New Agent and the new-tab button, ⌘B on the sidebar toggle, ⇧⌘D on the inspector toggle, ⇧⌘H on search, and ⌘W under the selected tab's close button. Release ⌘ and they fade out. Pressing another key or clicking while ⌘ is down counts as a shortcut, so the labels never flash during ⌘C or ⌘T. A command rebound away from ⌘ shows nothing. With Reduce Motion they appear and disappear without a fade. ## Sessions | Shortcut | Action | | --- | --- | | ⌘N | Show or hide the launcher: pick a project and agent, then type the first prompt | | ⌘T | Start a session with the default agent, no launcher | | ⌥⌘T | Start a plain terminal session | | ⌥⇧⌘N | Start a Codex session | | ⌥⌘N | New note in the current project | | ⌘R | Rename the selected session in place | | ⌃⌘D | Delegate: mark the selected session as a handoff source; select a target and press again to review and send | | ⌥⇧⌘W | Archive the selected session | | ⌘W | Close a focused auxiliary terminal; otherwise close the selected session, or the window when none is selected | | ⇧⌘T | Reopen the most recently closed session | | ⇧⌘N | New window for the current workspace | | ⇧⌘W | Close the window; sessions keep running | | ⌘Q | Quit diri; the Engine keeps sessions alive | | ⌘H | Hide diri | Set the default agent for ⌘T in **Settings → General → Default agent**. ## Move between sessions | Shortcut | Action | | --- | --- | | ⌘1 … ⌘8 | Select the nth session; hold ⌘ to see each row's number | | ⌘9 | Select the last session | | ⌘[ / ⌘] | Previous / next session in sidebar order, wrapping | | ⌥⌘← / ⌥⌘→ | Previous / next session | | ⌥⌘↑ / ⌥⌘↓ | Previous / next session | | ⌃⌘↑ / ⌃⌘↓ | Move the selected row up or down among its siblings | | ⇧⌘J | Jump to the next session that needs you | | ⌃⇥ | Most-recently-used switcher; hold ⌃ and press ⇥ again to advance | | ⌃⇧Space | Peek tabs: preview sessions across projects without switching | | ⇧⌘B | Move keyboard focus to the sidebar | Selecting a session also focuses its terminal. While the switcher is open: ⇧⌃⇥ cycles backwards, ← ↑ go back, → ↓ go forward, ↵ commits the highlighted session, Esc cancels, and releasing ⌃ commits. Every other key is swallowed until it closes. ## Surfaces | Shortcut | Action | | --- | --- | | ⌘K | Command palette | | ⌘P | Open project (the palette's project page) | | ⇧⌘H | Search chats (the palette's history page) | | ⇧⌘F | Search notes | | ⌃⌘T | To-dos across every note | | ⇧⌘I | Notifications inbox | | ⇧⌘O | Session overview | | ⌥⌘W | Worktrees overview | | ⌘, | Settings | | ⌘B | Show or hide the sidebar (or the top bar with horizontal tabs) | | ⇧⌘S | Switch tabs between the sidebar and the top | | ⇧⌘D | Show or hide the inspector | | ⌘J | Show or hide an auxiliary terminal below the selected session | ⌘K, ⌘P and ⇧⌘H open the same palette on different pages. The palette lists most commands with their shortcuts, so it doubles as a reminder for the ones you use least. **Check for Updates…**, **What's New** and **Review session launches** have no default shortcut and live in the palette. ## Panes | Shortcut | Action | | --- | --- | | ⌘D | Split right and choose a session for the new pane | | ⇧⌥⌘D | Split below and choose a session | | ⇧⌘↵ | Zoom the focused pane, or restore the layout | | ⌃⌥ + arrow | Focus the nearest pane in that direction | | ⌥⇧⌘ + arrow | Resize the nearest split divider by five percent | Swapping, moving and removing panes are in the command palette without default shortcuts. Removing a pane keeps its session running. ## Inside the palette | Shortcut | Action | | --- | --- | | ↑ / ↓ | Move the highlight | | ⌃P / ⌃N | Move the highlight, readline style | | ↵ | Run the highlighted entry | | ⌘↵ | Open project only: open a plain terminal in that folder instead of the default agent | | ⌘[ | Back to the previous palette page | | ⌫ with an empty query | Back to the previous palette page | | Esc | Close the palette and cancel any theme preview | Choose **Settings → Color theme** in the palette, or search for **Color theme**. Arrow keys and hover preview each theme across the app. Enter or a click saves it; Escape, Back or switching pages restores the saved theme. ## Inside the launcher | Shortcut | Action | | --- | --- | | ⇥ / ⇧⇥ | Cycle the agent forward or backward | | ↵ | Start the session | | ⇧↵ | New line in the prompt | | ⌘R | Show saved recipes | | ⌘S | Save the prompt as a recipe, or update the active one | | ⌘1 … ⌘3 | With an empty prompt, run the first three recipes | | ⇧⌘A | Choose the account (Claude Code and Codex) | | Esc | Close the launcher | When the agent or project picker is open it takes the arrows first: ↑ ↓ move the highlight, ↵ commits it, and Esc closes the picker without closing the launcher. Recipes are covered in [Recipes and scheduled tasks](/docs/scheduled-tasks/). A handoff opens in the same surface with the generated context editable. Nothing is sent until you activate **Send handoff** or press Return. Esc cancels without sending. ## Inside the overview | Shortcut | Action | | --- | --- | | Arrow keys | Move focus between sessions | | ↵ | Activate the focused session | | ⌘A | Select every session | | Any character | Add to the filter query | | ⌫ / ⌦ | Delete from the query; with an empty query and a selection, close the selected sessions | | Esc | Step back, then close | In Settings and the worktrees overview, Esc closes the surface. In Settings, Esc first dismisses an open menu or the remote-host editor. Inside the inspector, the ask and commit composers take ↵ to submit and Esc to cancel. ## Terminal | Shortcut | Action | | --- | --- | | ⌘F | Find in the terminal | | ⌘G / ⇧⌘G | Next / previous match | | ⌥⌘F | Find the selected text | | ⌘C | Copy the selection | | ⌘V | Paste, including images | | ⌥⌘C | Keyboard copy mode | | ⇧⌘C | Quote the selection into this session's composer | | ⌥⇧⌘C | Send the selection to another session | | ⌘E | Insert path: pick a file under the session's folder and type its path | | ⇧⌘E | Open the scrollback in your text editor | | ⇧⌘↑ / ⇧⌘↓ | Previous / next shell prompt (OSC 133) | | ⌘= or ⌘+ | Bigger text | | ⌘- | Smaller text | | ⌘0 | Reset text size | With the find bar open, ↵ jumps to the next match, ⇧↵ to the previous one, and Esc closes it. Apart from ⌃⇥ and the surface shortcuts above, keys without ⌘ go to the running program, modifiers and all. Keys with ⌘ do not reach the program, with one exception: ⌥⌫ and ⌘⌫ still delete a word or a line in the shell. ## Notes These work while a note's editor has focus. | Shortcut | Action | | --- | --- | | ⌃⌘↵ | Start an agent on the to-do under the caret | | ⌘↵ | Tick or untick a to-do | | ⌥⌘↵ | Fold or unfold | | ⌘B / ⌘I | Bold / italic | | ⌘E | Inline code | | ⇧⌘X | Strikethrough | | ⌘K | Link | | ⌥⌘0 … 3 | Turn into text, heading 1, 2 or 3 | | ⇧⌘8 / 7 / 9 | Turn into bulleted list / numbered list / to-do | | ⌥⌘Q / ⌥⌘C | Turn into quote / code | | ⌥⇧↑ / ↓ | Move the block up or down | | ⌃↵ | Table menu | | ⌘Z / ⇧⌘Z | Undo / redo | See [Notes](/docs/notes/) for blocks, mentions and starting agents from to-dos. ## Text fields The command palette, the terminal find bar, the history filter, the launcher prompt and the inspector composers share one keymap. | Shortcut | Action | | --- | --- | | ⌘A | Select all | | ⌘C / ⌘X / ⌘V | Copy, cut, paste | | ← / → | Move the caret; ⇧ extends the selection | | ⌥← / ⌥→ | Move by word | | ⌘← / ⌘→ | Start or end of the line | | Home / End | Start or end of the line | | ⌫ / ⌦ | Delete a character; ⌥ deletes a word, ⌘ deletes to the line edge | | ⌃A / ⌃E | Start or end of the line | | ⌃B / ⌃F | Back or forward one character | | ⌃H / ⌃D | Delete the character before or after the caret | | ⌃W | Delete the word before the caret | | ⌃U / ⌃K | Delete to the start or end of the line | ## When two surfaces want the same key diri asks which surface is in front, then falls back to the terminal. - **An unhandled global shortcut is not swallowed.** ⌘R or ⌘J with nothing selected, or ⌘9 with no sessions, leaves the keystroke alone. - **The launcher takes everything while it is open**, except ⌘N, which closes it. - **Settings and the worktrees overview take everything** except ⇧⌘H, ⌘K, ⌘P and ⌘,. - **The switcher and the overview own the arrow keys** while they are visible, so ⌥⌘↑, ⌘[ and ⌃⌘↑ stand down. - **Esc is shared.** With the overview closed, Esc clears a multi-session sidebar selection but still reaches the focused terminal, so Esc in vim never depends on the sidebar. - **⌘W is three commands.** It closes a focused auxiliary terminal first, then the selected session, and only with no session selected the window. - **⌘J and ⇧⌘J are unrelated.** ⌘J toggles the auxiliary terminal; ⇧⌘J jumps to the next session that needs you.