CLI reference
How to install and set it up: Atelier CLI.
Commands
Section titled “Commands”| Command | What it does |
|---|---|
atelier |
A session in this folder |
atelier "prompt" |
A session that starts with this prompt |
atelier -p "prompt" |
One answer, printed (stdin is added to the prompt) |
atelier setup |
The setup wizard: a server or this computer, sign-in, models |
atelier login |
Sign in to the server again |
atelier logout |
Sign this terminal out |
atelier connect <url> |
Connect to a server (or –local: only this computer) |
atelier status |
Where it is connected, as whom, and versions |
atelier doctor |
Check that everything works |
atelier models |
The models you can use |
atelier sessions |
Your Code sessions |
atelier token |
Print this terminal’s sign-in, for ATELIER_TOKEN in CI |
atelier update [--beta] |
Update to the newest version |
atelier daemon status|stop|keep|unkeep |
The background service (keep: start it at login) |
atelier reset-keys |
Start the key store for saved API keys over (they are added again) |
atelier completion <bash|zsh|fish|pwsh> |
Shell completion |
atelier licenses |
The licenses of the code inside |
Options
Section titled “Options”| Option | What it does |
|---|---|
-p, --print |
Answer one prompt and exit (for scripts): the reply goes to stdout |
| `–output-format <text | json |
-c, --continue |
Carry on with the latest session in this folder |
-r, --resume |
Pick a session to carry on with (or give its id: -r |
--session <id> |
Open this session |
-m, --model <model> |
The model for new sessions (a name or provider/model) |
--effort <level> |
low, medium, high, xhigh (Extra) or max |
--mode <mode> |
auto, ask, accept, plan or bypass |
--permission-mode <mode> |
The same as –mode (Claude Code’s name) |
--allow <rule> |
With -p: allow calls like this, e.g. –allow “Bash(npm test *)” –allow Edit |
--plain |
No colour and no animation |
--screen-reader |
Plain text that reads well with a screen reader |
--server <url> |
Use this server for this run (with ATELIER_TOKEN, for scripts) |
-v, --version |
Print the version |
-h, --help |
This help |
Slash commands
Section titled “Slash commands”Skills and commands of the folder and your account are listed in the same menu and run as they do in the app.
| Command | What it does |
|---|---|
/help (/?) |
What you can type and press |
/clear (/new, /reset) |
Start a new session (this one stays in /resume) |
/resume |
Open another session, also from the browser or the app |
/model [name] |
Choose the model |
/effort [low|medium|high|extra|max] |
How hard the model thinks |
/mode [mode] |
Auto, Ask, Accept edits, Plan or Bypass |
/plan |
Plan first, change nothing until you approve |
/compact [what to keep] |
Summarize the conversation to make room |
/context |
How full the context window is |
/cost (/usage) |
What this session used, and your limits |
/status |
Where this terminal is connected, as whom, and versions |
/open |
Open this session in the browser |
/rewind |
Go back to an earlier message (and the files as they were) |
/fork |
Carry on in a copy of this session |
/btw <question> |
Ask on the side, without adding to this session |
/loop [interval] <prompt> | stop |
Send a prompt again and again |
/tasks |
Commands and agents running in the background |
/todos |
The task list |
/export [file] |
Save the conversation as Markdown |
/copy |
Copy the last reply |
/permissions [add|remove <rule>] |
Your “always allow” rules |
/mcp (/connectors) |
Connectors and how they are doing |
/skills |
Skills this session can use |
/init |
Write an AGENTS.md for this repository |
/review |
Review the changes not committed yet |
/config (/settings) |
Look, notifications, editor, transcript |
/theme |
Dark, light, plain |
/fullscreen |
Switch between the fullscreen and the classic view (the session goes on) |
/statusline <command> | import | off |
A command whose output is the status line |
/login |
Sign in again (or as someone else) |
/logout |
Sign this terminal out |
/connect |
Connect to another server, or work on this computer only |
/update |
Get the newest version now (it starts next time) |
/provider (/providers) |
Add a model provider, or its key again |
/setup |
Go through the setup again |
/doctor |
Check that everything works |
/bug |
Copy what helps with a problem report |
/quit (/exit, /q) |
Leave (a running reply goes on in the background) |
/bug [--chat] <what happened> (/report) |
Report an issue to the Atelier developer (with diagnostics; –chat adds this conversation) |
/feature [--chat] <what you would like> |
Request a feature from the Atelier developer (–diagnostics, –chat to attach them) |
| Key | What it does |
|---|---|
| Enter | Send (while a reply runs, it waits its turn) |
| Ctrl+S | Send into the reply that is running |
| Shift+Enter, Alt+Enter, Ctrl+J | A new line |
| Esc | Stop the reply; twice on an empty box, go back to an earlier message |
| Shift+Tab | Auto → Ask → Accept edits → Plan |
| Tab | Take the suggested next message |
| ↑ / ↓ | What you sent before; ↑ also takes back a waiting message; ↓ shows background tasks |
| Ctrl+O | Show thinking, then every step in full |
| Ctrl+T | Show or hide the task list |
| Ctrl+R | Open another session |
| Ctrl+G | Write the message in your editor |
| Ctrl+V | Paste an image |
| Ctrl+L | Print the transcript again |
| @ | A file in this folder |
| ! | Run a command here; its output goes with your next message |
| Ctrl+C twice, Ctrl+D | Leave (a running reply goes on) |
Environment variables
Section titled “Environment variables”| Variable | What it does |
|---|---|
ATELIER_CLI_DIR |
Where the terminal app keeps its settings and data (default ~/.atelier/cli). |
ATELIER_SERVER |
The server to use for this run, as --server. |
ATELIER_TOKEN |
A sign-in to use instead of the stored one (CI); atelier token prints yours. Not kept. |
ATELIER_CLI_CREDENTIALS |
file: keep secrets in credentials.json instead of the system’s store. |
ATELIER_NO_UPDATE_CHECK |
Set: no daily look for a newer version. |
ATELIER_NO_BROWSER |
Set: never open a browser (it says the link instead). |
ATELIER_RUNNER_DIR |
Use the runner builds in this folder. |
NO_COLOR, FORCE_COLOR |
No colour; or this many colours (1: 16, 2: 256, 3: millions). |
VISUAL, EDITOR |
The editor Ctrl+G opens. |