# CLI reference

> Every command, option, slash command and key of Atelier CLI. Generated from the code.

<!-- Generated by apps/cli/src/reference.test.ts (pnpm docs:generate). Edit the tables in apps/cli/src, not this page. -->

How to install and set it up: [Atelier CLI](https://docs.atelierhq.dev/cli/).

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

| Option | What it does |
|---|---|
| `-p`, `--print` | Answer one prompt and exit (for scripts): the reply goes to stdout |
| `--output-format <text|json|stream-json>` | With -p: plain text, one JSON result, or a JSON line per event |
| `-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 <id>) |
| `--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

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

## Keys

| 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

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