Atelier docs

Recipes

Copy-pasteable workflows for common Atelier tasks.

Let an AI agent inspect Atelier safely

Start with read-only commands and JSON output. Keep login, vault passphrase entry, and final apply approval with the human.

atl guide --json
atl doctor --json
atl scan --json
atl list --json
atl profile list --json
atl saved list --json

Set up a new machine

Install Atelier, sign in, inspect what is saved, then preview the profile before applying it.

npm install -g @manan_joshi/atelier
# or use pnpm, yarn, or bun
atl login
atl profile list
atl saved list
atl profile switch personal --preview
atl profile switch personal --backup

Save editor settings

Scan your machine, inspect the item, then save it to the active profile.

atl scan
atl inspect zed.settings
atl save zed.settings
atl saved show zed.settings

Save terminal settings

Use stable IDs when Atelier knows the config. Use paths for one-off files.

atl save cmux.config
atl save cmux.ghostty
atl saved list

Preview before replacing a local file

If the target file already exists on the machine, preview first.

atl apply cmux.config --preview

Replace with a local backup

Use --backup when you want Atelier to keep a copy of the current local file before writing the saved version.

atl apply cmux.config --backup

Switch an entire profile safely

Preview the profile plan first. Apply with backups when local files already exist and may differ.

atl profile switch personal --preview
atl profile switch personal --backup

Check what account and API the CLI is using

Use doctor when a command behaves differently than expected.

atl whoami --json
atl profile current --json
atl doctor --json

Start over on this machine

Logout removes the local session. It does not delete saved configs from your account.

atl logout
atl login