Skip to content

Atomic Agent

Atomic Agent is a local-first AI agent. Runs open-weight models on your own machine via llama.cpp.

Install

$git clone https://github.com/AtomicBot-ai/atomic-agent

Install command taken from the project's README or registry entry. Always review code before running it.

Atomic Agent

A local-first AI agent that runs on your machine, with local or cloud models.

Drives your browser, edits files, runs approved commands, and remembers context across sessions. Open source, running on our TurboQuant llama.cpp so long sessions with small local models fit in less memory.

Quick Install · Uninstall · Benchmarks · Why Local-First · Ways to Use It · Docs


A local-first AI agent that runs the control loop and all state on your machine. It works across your machine: browse the web, read and edit files, run approved shell commands, inspect documents, remember context across sessions, schedule follow-ups, and call external tools over MCP. Run it on a local model, a cloud model, or both at once in Fusion mode, where one model plans and a pool of workers executes. Embed it in your own apps over HTTP or a Tauri sidecar. llama.cpp first, so small quantized models stay useful for long, multi-step work on consumer hardware.

Quick Install

macOS / Linux:

curl -fsSL https://atomicagent.io/install | sh

Windows (PowerShell):

irm https://atomicagent.io/install.ps1 | iex

The installer downloads the release archive, verifies the checksum, and installs the CLI plus support assets (grammars/, native prebuilds, and bundled ripgrep). Atomic Agent updates itself in place; after an update the TUI prompts you to restart. Outside the TUI, run atomic-agent update (or atag update) to check for a newer release and re-run the installer in place; atomic-agent update --check probes without installing, and --version <tag> pins a specific release. Only the installed binary can self-update; a dev checkout updates via git.

[!NOTE] Developer preview. APIs, commands, config, and behavior are still moving, so pin a release if you need a stable integration point. Current builds: macOS (Apple Silicon), Linux x64 / arm64, and Windows x64. Intel Macs are not supported yet; Windows on ARM runs the x64 build under emulation.

Run

atomic-agent

Both installers also drop a short alias next to the binary, so this is the same thing:

atag

[!TIP] Need a second agent? Press Ctrl+N (or run /window) inside the TUI: it opens a new terminal window with a fresh atomic-agent in the same directory.

[!TIP] Want to go through first-time setup again? Run /onboarding (or /setup) in the TUI, or start it with atomic-agent tui --onboarding. Your providers, keys, sessions and memory are kept.

[!TIP] Coming from another agent? The first run offers to bring your data over: tick the sources it found and the import runs, without overwriting anything already here and without touching the source. What moves depends on the source:

  • Claude Code: skills, memory, MCP servers, sessions, and (opt-in) provider keys
  • Codex: skills, memory, sessions, and (opt-in) provider keys
  • Oh-My-Pi: skills, MCP servers, and sessions
  • Pi: skills and sessions
  • Hermes: sessions, cron jobs, and (opt-in) provider keys
  • OpenClaw: sessions and cron jobs

Later, run /import in the TUI or atomic-agent import <hermes|openclaw|claude-code|codex|pi|oh-my-pi> from the shell.

Uninstall

Similar plugs

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io