Skip to main content

​
Guides

Find a guide for the task you want to do with Atomic. New to Atomic? Follow the Quickstart to install, authenticate, run a first session, and add project instructions. Looking to extend or embed Atomic? Go to Build with Atomic. Looking up an exact flag, setting, event, or type? Go to the Reference index.
  1. Interactive use — the interactive loop, slash commands, and context files.
  2. Configure Atomic — write a settings file and override it per project.
  3. Sessions — save, resume, name, and branch sessions.
  4. Context and compaction — keep long sessions inside the context window.
  5. Providers — subscription logins, API keys, and provider-specific setup.
  6. Local models — run models locally with llama.cpp.
  7. Security — project trust and sandbox boundaries.
  8. Containerization — run Atomic inside a container.
For work that continues while you chat, follow Background tasks to launch, inspect, and stop agents or shells. If you use Herdr panes, Herdr explains Atomic’s status indicators and troubleshooting.
  • Computer use covers desktop apps, browsers, and terminals across macOS, Linux, and Windows.
  • Environment variables lists Atomic/Pi aliases, provider credentials, and bash session metadata.
  • Settings lists global and project settings.
  • Keybindings lists default shortcuts and custom actions.