Atelier docs

Recipes

Copy-pasteable workflows for common Atelier tasks.

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
atl login
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
atl profile current
atl doctor

Start over on this machine

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

atl logout
atl login