Skip to main content
Paths are for macOS and Linux. ~/.config is $XDG_CONFIG_HOME when it is set, and ~/.local/share is $XDG_DATA_HOME.

Settings

Your settings, a project’s settings, the env file, instructions, skills and named agents: see Configuration. Also in ~/.config/archetype/: A flag wins over a project’s settings, and a project’s over yours. A project’s config can narrow what the agent may do, never widen it: it cannot set the provider or model, allow edits or commands, add hooks or set a sandbox.

Data

In ~/.local/share/archetype/: A session’s worktree is on the branch archetype/<session>. Records are kept until you delete them; "keepRecordsDays": 90 in your user config removes finished ones older than that.

Logs

archetype --doctor checks the config, model, keys and record folder without calling a model.

Environment variables

API keys are environment variables too; see Accounts and keys.