Atelier docs

Get started

Install Atelier, sign in, scan your machine, and save your first encrypted config snapshot.

Install

Install Atelier with the package manager you already use. It gives you the atl command.

npm install -g @manan_joshi/atelier
# or
pnpm add -g @manan_joshi/atelier
# or
yarn global add @manan_joshi/atelier
# or
bun add -g @manan_joshi/atelier

atl --version

Atelier requires Node.js 22.12 or newer. Later, run atl update to install the latest published version.

If an AI agent is helping

Ask the agent to start with the built-in guide and JSON diagnostics before it changes anything.

atl guide --json
atl update --check
atl doctor --json

Keep GitHub login, vault passphrase entry, and final apply approval in your interactive terminal.

Sign in

Atelier uses GitHub device authentication for CLI login. The CLI receives an Atelier session after authorization.

atl login
atl whoami

Scan this machine

Scan builds a local inventory of known config paths and any extra paths you provide.

atl scan
atl list
atl list --json

Save your first config

Use a stable ID from the inventory or pass a path directly.

atl save zed.settings
atl save ~/.config/some-tool/config.json
atl saved list

Apply on another machine

Install Atelier, sign in with the same account, preview the change, then apply with a backup if the local file already exists and differs.

atl profile list
atl apply zed.settings --preview
atl apply zed.settings --backup