Skip to content

CLI reference

How to install and set it up: Atelier CLI.

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
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

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)
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.