Atelier docs

Concepts

The product model behind Atelier: configs, profiles, vaults, previews, applies, and backups.

Configs

A config is a file that controls one of your tools. Atelier can save known configs by stable ID, such as zed.settings, or by path.

Stable IDs

Stable IDs are memorable names for common config files. They make commands easier to read and help Atelier match saved configs across machines.

atl save zed.settings
atl apply zed.settings --preview

Profiles

A profile is a named collection of saved configs. Use profiles for different machine contexts, such as personal setup, work setup, or project setup.

atl profile list
atl profile switch personal --preview

Vault

The vault protects encrypted config material. Your passphrase is required when the machine needs access to decrypted profile keys for save or apply operations.

Preview

Preview compares saved configs to local files without writing anything. It is the safest way to inspect what Atelier would change.

Apply

Apply writes a saved config to this machine. Missing files are created. Matching files are left alone. Differing files are blocked unless you choose --backup.

Backup

Backup means Atelier copies the current local file before replacing it with the saved version. The backup protects the file that was already on the machine.