Atelier docs

CLI reference

Public command reference for the atl CLI.

Install

Use whichever package manager you already use.

npm install -g @manan_joshi/atelier
pnpm add -g @manan_joshi/atelier
yarn global add @manan_joshi/atelier
bun add -g @manan_joshi/atelier
atl --version

Atelier requires Node.js 22.12 or newer.

Global options

atl --version
atl --help
atl help <command>

guide

Print an agent-safe onboarding guide for read-only discovery, human handoffs, previews, backups, and JSON-capable workflows.

atl guide
atl guide --json

update

Check for or install the latest published atl version.

atl update --check
atl update
atl update --manager pnpm

login

atl login

whoami

Show the current signed-in account and API URL.

atl whoami
atl whoami --json

logout

Remove the local Atelier session from this machine.

atl logout

scan

Scan this machine and write a local inventory.

atl scan
atl scan --json
atl scan --path ~/.config/some-tool/config.json
atl scan --legacy

list

List inventory items from the last scan.

atl list
atl list --json
atl list --app Zed
atl list --secrets
atl list --missing

inspect

Inspect one inventory item by stable ID or path.

atl inspect zed.settings
atl inspect ~/.config/zed/settings.json
atl inspect zed.settings --json

summary

Print the last scan summary.

atl summary
atl summary --json

profile

Manage account-backed profiles.

atl profile list
atl profile list --json
atl profile create personal
atl profile create personal --json
atl profile current
atl profile current --json
atl profile switch personal --preview
atl profile switch personal --preview --json
atl profile switch personal --backup
atl profile switch personal --backup --json

vault

Advanced vault controls. Most users only see vault prompts during save or apply.

atl vault status
atl vault status --json
atl vault init
atl vault unlock
atl vault lock

save

Save one config snapshot to the active encrypted profile.

atl save zed.settings
atl save ~/.config/app/settings.json

apply

Apply one saved config to this machine.

atl apply zed.settings --preview
atl apply zed.settings --preview --json
atl apply zed.settings
atl apply zed.settings --backup
atl apply zed.settings --backup --json

saved

Inspect encrypted configs saved remotely.

atl saved list
atl saved list --json
atl saved show zed.settings
atl saved show zed.settings --json

skills

Scan, save, and install account-backed Agent Skills with explicit review.

atl skills scan
atl skills scan --json
atl skills scan --project
atl skills save
atl skills save --project
atl skills save --yes
atl skills install --preview
atl skills install --preview --json
atl skills install
atl skills install --backup
atl skills install --backup --yes --json
atl skills install --yes

setups

Publish, search, install, and yank public setups with review-first safety behavior.

atl setups publish editor-pack
atl setups publish editor-pack --project
atl setups search zed
atl setups search zed --list
atl setups search zed --json
atl setups install @owner/name --preview
atl setups install @owner/name --preview --json
atl setups install @owner/name
atl setups install @owner/name --backup
atl setups install @owner/name --backup --yes --json
atl setups install @owner/name --confirm-project
atl setups yank @owner/name 2

doctor

Check runtime, session, API URL, inventory state, and local warnings.

atl doctor
atl doctor --json