Sign in to an engine
Open Manage → Agents and models. Each engine has a row that says whether it is installed, signed in, and on which plan.- Install installs an engine that is missing.
- Sign in runs the engine’s own sign-in. For Claude Code, Codex and Kimi Code it opens a browser; for Antigravity, run
agyin a terminal. OpenCode starts on its free models without signing in. - Use makes it the engine new conversations start with. A row that is not installed or signed in has none.
claude setup-token as CLAUDE_CODE_OAUTH_TOKEN in the env file.
API keys
Archetype’s own models run on your API keys, or on a ChatGPT account: Sign in on the OpenAI row shows a code to enter in your browser. On a provider’s row, Add key saves a key; Add another key adds one more, tried in turn when one is refused or at its limit. Keys go in~/.config/archetype/env, one per line:
- Only you may read the file (
chmod 600); the background service refuses to start otherwise. - A variable already set in your shell wins over the file.
- The background service reads the file again within 2 seconds of a change.
~/.local/share/archetype/secrets/.
Choose the model
- App
- Terminal
The chip under the message box chooses the engine and its model, and the reasoning effort. See Engines.
provider and model go in your user config; a project’s config cannot set them.
Profiles keep settings to apply together: engine, model, effort, permission mode and Tokenmaxxing. Save the current ones in Manage → Profiles, and switch from the status bar or with /profile NAME.
Bring your setup from other tools
The first run offers Bring your setup; later it is Manage → Import environment. Archetype finds what is on this computer and you choose what to bring:- Instructions are added to the end of your
AGENTS.mdunder each tool’s name, as written; nothing is summarized. - A key an MCP server needs goes to the env file, not the config.
- Not brought: models and providers, API keys, sign-ins, permissions, hooks and history. Sign in again in Archetype.
- Nothing runs while it looks. Imported MCP servers start when you press Apply now.
/import in a conversation: it continues in a new session from a copy.