Keyboard shortcuts
This page lists every key Atelier binds, with its default. Keyboard shortcuts under More in the sidebar opens a short version of the first two tables inside the app, with the keys you set.
Changing a shortcut
Section titled “Changing a shortcut”Settings › Shortcuts changes the keys of the shortcuts in the first table and of Upload or add files,
Change effort and Dictate. Change waits for the new combination (Esc cancels), Turn off removes a shortcut and
Reset brings back its default; Reset all does that for every one. A shortcut needs ⌘ or ⌃ (Ctrl on Windows and
Linux), unless it is a function key such as F6. Atelier refuses a combination another of its shortcuts already has
and one the system or the text box uses (⌘C, ⌘V, ⌘Z, ⌘Q, ⌘W and the like), and says why. Send, new line, Stop, /,
@ and the other keys of the message box can’t be changed. Your shortcuts belong to your account, so they follow
you to every device you sign in on; in the desktop app the menu bar shows them too.
Keys are given for macOS, then Windows and Linux: ⌘ becomes Ctrl, ⇧ becomes Shift, and ↵ is Enter. Where one column is given, the key is the same everywhere.
Everywhere
Section titled “Everywhere”| Action | macOS | Windows / Linux | Notes |
|---|---|---|---|
| New chat or Code session | ⌘N | Ctrl+N | Starts a new one in the mode you are in. |
| New temporary chat | ⇧⌘N | Ctrl+Shift+N | Opens a temporary chat from any page (from Code it switches to Chat). See Temporary chats. |
| Search | ⌘K | Ctrl+K | The search palette. |
| Settings | ⌘, | Ctrl+, | |
| Show or hide the sidebar | ⌘B | Ctrl+B | |
| Report an issue, with a screenshot | F1 | F1 | Opens the report with a picture of the window as it was when pressed (desktop only; in a browser it opens without one). Also Help › Report an Issue…. |
| Lock Atelier | ⇧⌘L | Ctrl+Shift+L | Desktop, and only on “Run on this computer”; also Lock Atelier in the profile menu and the File menu. Without a screen lock set it says “Set a PIN or password first” and opens the setting. |
The message box
Section titled “The message box”These work in the message box of Chat and Code (and project chats).
| Action | macOS | Windows / Linux | Notes |
|---|---|---|---|
| Send | Enter | Enter | While the model works, a sent message waits for its next step (Take back and edit, Send now). |
| New line | ⇧Enter | Shift+Enter | |
| Stop the reply | Esc | Esc | Only while the box is empty. |
| Upload or add files | ⌘U | Ctrl+U | Opens the file picker. In a split view, acts in the active session only. |
| Change effort | ⇧⌘E | Ctrl+Shift+E | Opens the effort popover on models that have it. In a split view, the active session. |
| Dictate | ⇧⌘Space | Ctrl+Shift+Space | Starts and stops dictation; held, records until you let go (with Hold to record on). While dictating, ↵ sends and Esc drops what was said. |
| Switch permission mode | ⇧Tab | Shift+Tab | Code only, only while the box is empty. Cycles Auto → Ask → Accept edits → Plan; Bypass is chosen from the menu only. |
| Start a slash command or skill | / |
/ |
As the first character; see below. |
| Mention a file | @ |
@ |
Code (a session with a folder). See below. |
Pasting or dropping a file attaches it. Editing a message of yours: Enter saves it, Shift+Enter adds a line, Esc cancels.
Slash commands
Section titled “Slash commands”Typing / as the first thing in the box opens a list. It holds the built-in commands the current page offers,
then your skills and custom commands. ↑ and ↓ move, Enter or Tab picks, Esc closes it (until the text changes). Names
that start with what you typed come first, then names that contain it (review finds plugin:review). Picking a command that takes no argument runs it at once; one with an argument
puts /name in the box.
Built-in commands
Section titled “Built-in commands”| Command | What it does | Offered in |
|---|---|---|
/model |
Opens the model picker. | Everywhere with a message box: chat home, chats, project chats, Code |
/clear |
Starts a new session: in a chat, a new chat (a new temporary chat from a temporary chat, the project’s page from a project chat); in Code, the home page with the same folder chosen. | Chats, Code sessions |
/btw [question] |
Asks a side question in a panel on the right; it reads the conversation, changes nothing and adds nothing to it. /btw alone opens an empty one. See Chat. |
Chats, Code sessions |
/loop [interval] <prompt> |
Sends the prompt now and again every interval while the session is idle. See below and Loops. | Chats (not temporary ones), Code sessions |
/compact [focus] |
Summarizes the conversation so far to free up context; the optional text says what to keep. The same as the context popover’s Compact session. | Code only (Chat compacts by itself) |
/rewind |
Restores the code, the conversation or both to an earlier point. | Code only |
/loop forms:
| You type | Result |
|---|---|
/loop 5m check the build |
A loop that sends “check the build” now and every 5 minutes. Intervals are 30s, 5m, 2h, 1d or a combination in that order (1h30m). |
/loop check the build |
The same every 10 minutes (the default). |
/loop or /loop list |
Shows the session’s loops. |
/loop stop |
Stops all of the session’s loops. |
/loop stop 2 |
Stops one, by its number in the list (or its id). |
An interval is at least 1 minute (shorter ones are rounded up) and at most a day. The other limits are on Loops.
Skills and custom commands
Section titled “Skills and custom commands”After the built-ins the list shows every skill you may start and every custom command (a Markdown prompt in a
commands folder of .atelier or, with Claude Code compatibility on, .claude, or one that comes with a plugin; a
plugin’s are named plugin:name), each with its description and an argument hint if it takes one. Typing /name args
and sending expands the skill or command into the message. A built-in command wins over a skill with the same name.
The + › Skills menu offers the same skills. See Customize.
Mentioning files
Section titled “Mentioning files”In a Code session, @ at the start of a word lists files in the folder (matching as you type);
↑ and ↓ move, Enter or Tab inserts @path, Esc closes the list. The model reads the file when it needs it. Attach as
context in the Files pane’s right-click menu inserts the same mention.
Answering a question or permission prompt
Section titled “Answering a question or permission prompt”An ask from the model appears above the message box, and its keys work even while the cursor is in the box.
| Ask | Key | Does |
|---|---|---|
| Permission (“Allow Atelier to run …?”) | 1 or Esc | Deny |
| R | Deny with reason…: type, then Enter sends it and Esc puts the field away. On the folder, connector and computer use cards it is Say why… | |
| 2 or ⇧⌘↵ | Always allow (the chevron picks this session, this project or everywhere). Absent for dangerous commands, which are approved one call at a time | |
| 3 or ⌘↵ | Allow once (2 when there is no Always allow) | |
| F | Show the whole file, for an edit. The keys above work there too, except Esc, which leaves the view | |
| Folder change | 1 or Esc | Stay here |
| ⌘↵ | Move here | |
| Plan | Esc | Revise… |
| ⌘↵ | Accept and auto mode | |
| ⇧⌘↵ | Accept (approve each edit) | |
| Questions | 1–9 | Picks that option, for a single question |
| Esc | Skip | |
| ⌘↵ | Submit, once every question is answered |
Digits count only while focus is on the prompt and not in a text field. The prompt takes focus when it appears, unless you are typing.
The search palette
Section titled “The search palette”| Key | Does |
|---|
| ↑ ↓ | Move through actions and chats. | | ↵ | Opens the highlighted one. | | Esc | Closes it. |
Settings has its own search box: ↑ ↓ choose a result, Enter opens it, Esc clears the text.
Session menus
Section titled “Session menus”With a Code session’s menu open, or a former Cowork task’s in the Chat sidebar (⋯ on its row, or right-click), the letter beside an item does it. No ⌘ or Ctrl is needed.
| Key | Item |
|---|---|
| P | Pin or Unpin |
| U | Mark as unread or Mark as read |
| R | Rename |
| F | Fork |
| A | Archive or Unarchive |
| D | Delete |
| 1, 2, 3 … | In Open in ›: the places in order (Split view, New window, then Cursor, VS Code, Finder). In Move to group ›: the first nine groups. |
Split view and dividers
Section titled “Split view and dividers”| Key | Does |
|---|---|
| ⌘U, ⌘⇧E | Act in the active session of a split view. Clicking or focusing a cell makes it active. |
| ← → (on a focused vertical divider) | Move the divider 2%; with Shift, 10%. |
| ↑ ↓ (on a horizontal divider, between stacked panes) | The same. |
| Home, End | Move the divider to its smallest or largest position. |
| Double-click a divider | Even sizes. |
Sliders, lists and viewers
Section titled “Sliders, lists and viewers”| Where | Keys |
|---|---|
| Effort slider | ← or ↓ lower, → or ↑ higher, Home or Page Down lowest, End or Page Up highest. |
| Image viewer (click any image) | ← and → to the previous and next image, Esc to close. |
| Files pane (Code) | The menu key or Shift+F10 on a focused row opens its menu (Attach as context, Copy ›, Open in ›); Esc clears the filter. |
| Reply button over selected text | Esc hides it. |
| Plan pane (Code): comment box | Esc discards the comment. |
| Open a repository… (Code › Cloud): search box | Enter opens the top match. |
| Editing in place (project name and description) | Enter saves, Esc cancels (Shift+Enter adds a line in the description). |
| Memory bar (“Tell Atelier what to change”) | Enter sends, Shift+Enter adds a line. |
| Projects page search | Esc clears it and closes it. |
The desktop menu
Section titled “The desktop menu”The desktop app has a menu bar. Its own items, with their default keys (the menu shows the ones you set in Settings › Shortcuts):
| Menu | Item | macOS | Windows / Linux |
|---|---|---|---|
| Atelier (macOS) | Settings… | ⌘, | |
| File | New Chat | ⌘N | Ctrl+N |
| File | New Temporary Chat | ⇧⌘N | Ctrl+Shift+N |
| File | Join a Co-op Session… (paste an invite link) | ||
| File | Lock Atelier (only on “Run on this computer”) | ⇧⌘L | Ctrl+Shift+L |
| File (Windows / Linux) | Settings… | Ctrl+, | |
| File (Windows / Linux) | Quit | ||
| View | Toggle Sidebar | ⌘B | Ctrl+B |
| View | Search | ⌘K | Ctrl+K |
| Help | Report an Issue… | F1 | F1 |
| Help | Request a Feature… | ||
| Help | Atelier Documentation (opens this site) |
The rest comes from the system’s standard menus (Atelier, Edit, View and Window on macOS; Edit, View and Window on Windows and Linux), with the operating system’s usual keys. A build run from source also shows Toggle Developer Tools and Reload in View.
Desktop only
Section titled “Desktop only”- The menu bar, including ⇧⌘L and Lock Atelier (the screen lock exists only on “Run on this computer”).
- Open in › New window, Cursor, VS Code and Finder in the session menu.
Everything else on this page works the same in the desktop app and in a browser.