Reference
Keyboard shortcuts
Every Escouade shortcut, grouped by use: navigation, conversation, questions and permissions, editor, terminals, panels, tickets, and settings. Each one says where it works; the page also covers what changes on macOS and what stays with the shell inside a terminal.
Reading this page
Shortcuts are written the way the app writes them in English: Ctrl+Shift+A, Ctrl+Enter, Esc. The “Where” column says where each one works:
- “Everywhere”: anywhere in the window, as long as no dialog (settings, commit, ticket…) is open. On Windows and Linux, though, a terminal that has focus keeps some of these keys for its shell: see Terminals.
- “Everywhere, terminals included”: even when a terminal has focus.
- A specific place (the message field, the editor, a form…): the shortcut only works there.
Esc closes the open dialog. Two notes on the keyboard:
- Global shortcuts ignore any combination with
Alt, becauseCtrl+AltisAltGron a French keyboard. The shortcuts that useAltbelong to one area:Alt+1…Alt+9(questions),Alt+←andAlt+→(editor),Alt+↑andAlt+↓(worktree settings),Alt+click(editor). - The digits of
Ctrl+1…Ctrl+9andAlt+1…Alt+9are read from the physical key: on an AZERTY keyboard, you don’t needShift.
On macOS
Ctrl becomes ⌘, and Ctrl+Shift becomes ⇧⌘: Ctrl+N is written ⌘N, Ctrl+Shift+A is written ⇧⌘A. The exceptions:
| Windows and Linux | macOS |
|---|---|
Ctrl+Tab, Ctrl+Shift+Tab |
Unchanged: ⌘Tab switches applications. |
Alt+1 … Alt+9, Alt+↑, Alt+↓, Alt+click |
Unchanged: Alt is the Option key (⌥). |
Alt+←, Alt+→ (editor) |
⌃-, ⌃⇧-, with the Control key rather than ⌘. |
Ctrl+click (editor) |
⌘+click. |
Ctrl+Y (editor, redo) |
⇧⌘Z. |
Del (editor file tree) |
⌘⌫; the Del key works too. |
Ctrl+C, Ctrl+V (terminal) |
⌘C, ⌘V. The Ctrl keys go to the shell. |
Navigation
| Shortcut | Action | Where |
|---|---|---|
Ctrl+1 … Ctrl+9 |
Go to project n, in the order of the tabs. | Everywhere, terminals included |
Ctrl+Tab / Ctrl+Shift+Tab |
Next / previous agent of the project on screen. | Everywhere, terminals included |
Ctrl+Shift+A |
Open or close the overview, which gathers the agents of all projects. | Everywhere, terminals included |
Ctrl+K |
Search the conversations: what you and your agents wrote, commands, files, and tool outputs, ignoring case and accents. A result opens the agent on the message. | Everywhere |
Ctrl+P |
Open a file by its name. name:42 opens it at line 42, name:42:7 at line 42, column 7. The file is looked up in the editor’s source if it is open, otherwise in the worktree of the agent on screen, otherwise in the project folder. |
Everywhere |
Palettes and lists
| Where | Keys |
|---|---|
Ctrl+K and Ctrl+P |
↑ / ↓ choose, Enter opens, Esc closes. With nothing typed, Ctrl+P offers the files opened last: Enter reopens the one before the file on screen. |
| Overview | ↑ / ↓, Home and End change line. Enter or Space opens the agent on the line. Esc goes back to the view you came from. |
| Branch picker (status bar) | ↑ / ↓ choose, Enter confirms the chosen line, Esc closes. |
| Branch in the picker, commit in the git graph | Menu or Shift+F10 opens the menu that a right click opens. |
| Context menu | ↑ / ↓, Home and End choose, Esc closes. |
| Settings tabs | ↑ / ↓, Home and End change tab. |
| Kanban ticket card | Enter or Space opens it: the ticket form if it is in “To do”, otherwise its agent. |
Agents and conversation
| Shortcut | Action | Where |
|---|---|---|
Ctrl+N |
New agent in the project on screen. | Everywhere |
Ctrl+J |
Go to the next agent that is waiting for your answer or needs a look (a question, or an end or error you haven’t seen yet), across all projects, and put the cursor in its message field. | Everywhere, terminals included |
Enter |
Send the message. While Claude is working, it takes the message into account at its next step. | Message field |
Shift+Enter |
New line. | Message field |
Esc |
Interrupt Claude. | Message field, while the agent is working |
↑ |
Recall the last message sent, to send it again as is or edited (the original stays in the conversation). | Empty message field |
↑ / ↓, Enter or Tab, Esc |
Choose, accept, or close an @file or /command suggestion. |
Message field, list open |
Questions and permissions
When Claude asks a question or requests a permission, you can handle the card from the keyboard:
| Shortcut | Action |
|---|---|
Ctrl+Enter |
“Allow” the pending request (“Approve the plan” for a plan). For a question, submits the answer once it is complete (“Submit”). |
Ctrl+Shift+Enter |
“Always allow” (“Approve and accept edits” for a plan), only if the card offers that button. |
Alt+1 … Alt+9 |
Pick option n of the pending question; for a multiple choice, tick or untick it. |
Text in the message field, then Enter |
Deny the request with that text as the message, or answer the question freely. |
These keys work in the conversation, message field included, or when nothing else has focus. They don’t work in a terminal, in the editor, or while a dialog is open. The details:
- Several requests can be waiting: the keyboard answers the first one.
- A request that has just arrived ignores these keys for half a second,
Enterin the message field included: the text you have already typed stays there. So aCtrl+Entermeant to send your message doesn’t answer a request that arrives at the same moment, and a secondCtrl+Enterdoesn’t answer the next request. A key held down answers only once. - A request that Claude Code would deny by default can only be allowed with its button.
- A single-choice question is sent as soon as you pick an option. With several questions or a multiple choice,
Ctrl+Entermoves on to the next question that has no answer, then submits once all of them have one. - In the overview,
Ctrl+Enterdoes nothing: a permission that can be read in full there is allowed or denied with its buttons.
Editor
The built-in editor. Its shortcuts work as long as it is open.
The text
| Shortcut | Action | Where |
|---|---|---|
Ctrl+S |
Save the file. | Editor open |
Ctrl+Shift+F |
Search all the files of the source. | Editor open |
Ctrl+F |
Search in the file. F3 or Ctrl+G goes to the next match, with Shift to the previous one. |
File text |
Ctrl+click or F12 |
Go to what the word points to: an imported file, a link, a path, the definition of a name. If there are several definitions, a list opens. | File text |
Shift+F12 |
Find the references of the name under the cursor. | File text |
Alt+← / Alt+→ |
Go back to where you were before a jump / go forward again. The mouse’s “back” and “forward” buttons do the same. | File text |
Alt+click |
Add a cursor. | File text |
Ctrl+Z / Ctrl+Y |
Undo / redo. | File text |
Tab / Shift+Tab |
Indent / unindent. | File text |
The text is a CodeMirror editor: its other usual shortcuts work there too.
The file tree
These keys apply when a row of the file tree has focus.
| Shortcut | Action |
|---|---|
↑ / ↓, Home, End |
Change row. |
→ |
Expand the folder, then go to its first item. |
← |
Collapse the folder, or go to the parent folder. |
Enter or Space |
Open the file, or expand the folder. |
F2 |
Rename. |
Del |
Delete to the trash, after confirmation. |
In the results of “Search in files”, Enter in the field runs the search, ↓ moves to the results, and ↑ from the first one goes back to the field.
Terminals
| Shortcut | Action | Where |
|---|---|---|
Ctrl+T |
New terminal in the project on screen. | Everywhere |
Ctrl+Shift+F |
Search the output. Enter goes to the next match, Shift+Enter to the previous one, Esc closes the search. |
Terminal, log of a launch command |
Ctrl+C |
Copy the selection; with no selection, the key goes to the shell (interrupt). | Terminal, on Windows and Linux |
Ctrl+V |
Paste. | Terminal, on Windows and Linux |
Ctrl+Shift+C |
Copy the selection. | Terminal, on Windows and Linux |
⌘C / ⌘V |
Copy / paste. | Terminal, on macOS |
Shift+PageUp, Shift+PageDown, Shift+Home, Shift+End |
Scroll the log. | Log of a launch command (read-only) |
The log of a launch command is read-only: apart from copying and scrolling, all its keys go to the app, Ctrl+K and Ctrl+P included.
What stays with the shell
On Windows and Linux, a terminal that has focus keeps Ctrl plus a letter for its shell, including Ctrl+K (cut to the end of the line), Ctrl+P (previous command), Ctrl+N, and Ctrl+T: to search the conversations, open a file, or create an agent or a terminal, click outside the terminal first. The app only takes Ctrl+Tab and Ctrl+Shift+Tab, Ctrl+1 … Ctrl+9, Ctrl+J (to a shell it is only a line feed, which Enter already sends), Ctrl+,, and Ctrl+Shift+A. Ctrl+Shift plus a letter sends nothing to the shell: Ctrl+Shift+B and Ctrl+Shift+L work in a terminal too, where Ctrl+Shift+F searches its output.
On macOS, the app’s shortcuts use ⌘, which the shell never receives: they all work in a terminal, except ⌘C, ⌘V, and ⌘A (select all), which are the terminal’s own. The Ctrl keys go to the shell.
Panels and layout
| Shortcut | Action | Where |
|---|---|---|
Ctrl+Shift+L |
Switch between the classic layout and “Conversation and files side by side”. | Everywhere, terminals included |
Ctrl+Shift+B |
Show or hide the panel of uncommitted files. | Everywhere, terminals included, in the classic layout (side by side, the panel is always shown) |
A separator that has focus (with Tab) can be adjusted from the keyboard:
- The editor’s files column:
←/→narrow or widen it,HomeandEndgo to the minimum and maximum width. - The task list of the “Plan” banner:
↑/↓change its height,HomeandEndgo to the minimum and maximum,EnterorEscrestore the usual height.
A double click on a separator restores its size too.
Tickets
| Shortcut | Action | Where |
|---|---|---|
Ctrl+Enter |
Add or save the ticket, from any field. | Ticket window |
Enter |
Add or save the ticket. In multi-line fields, Enter starts a new line. |
Ticket title |
Esc |
Close the window; if you have typed something, the app first asks whether to discard it. | Ticket window |
Settings
| Shortcut | Action | Where |
|---|---|---|
Ctrl+, |
Open the settings. | Everywhere, terminals included |
Esc |
Close the settings. | Settings open |
Alt+↑ / Alt+↓ |
Move a setup or teardown command up / down, from any field of the command. | Project settings, worktree command lists |