atrium — Docs
docs/introduction.md

Introduction

atrium is a persistent development environment for humans and CLI coding agents.

atrium is a native desktop app for running CLI coding agents alongside terminals, editors, and browsers in a tiling layout that survives crashes and reboots. It is built with Tauri 2.0 (Rust + native WebKit), ships at ~8 MB on disk, and is currently shipping as Early Access for macOS.

What it is

  • A tiling mosaic of panes — terminals, agent chats, editors, a markdown editor, a Chromium browser, git source control, search, and task cards — arranged in splits and rooms inside projects, which are themselves grouped into switchable workspaces.
  • A resumable environment: pane layout, terminal scrollback, working directories, environment, and active agent sessions are journaled to ~/.atrium/ and restored after quits, crashes, and reboots. A background daemon keeps agents running even when the window is closed.
  • An adapter-driven AI host: Claude Code, Codex, Antigravity, Cursor Agent, Grok, Kimi, opencode, Hermes, omp, and pi are first-class, with session detection and resume handled by each adapter. Third-party adapters can be built with the declarative SDK v2 manifest.
  • A programmable surface: every concept (pane, room, project, workspace, task, browser, memory) is reachable from the atrium CLI, so agents inside atrium can coordinate with each other, drive browser panes, update task cards, and delegate work.

What it is not

  • Not an Electron app. Not a terminal emulator with "AI features bolted on". Not a language server / IDE — Monaco and LSP are used as components, but atrium does not try to be a full IDE.
  • Not cross-platform yet. macOS only.
  • Not a reimplementation of any agent. Whether you run one in a terminal pane or an agent chat pane, it is the vendor's real CLI — a PTY in the first case, the tool's own protocol in the second.

How this documentation is organized

  • Getting started — install, first run, launching an agent.
  • Core concepts — the mental model: workspaces, projects, rooms, panes, agents, tasks, memory, persistence.
  • Panes — one page per pane type, with full capability list.
  • Agents — launching, the skills & agents registry, +skill / ++agent sigils, activity, messaging, task dispatch.
  • Customization — themes, keybindings, appearance, per-adapter environment.
  • Adapters — installing adapters and building your own.
  • Reference — keyboard shortcuts, CLI, configuration schema, ~/.atrium/ layout, atrium:// protocol.
  • Privacy — what telemetry exists and how to opt out.
If you want to skim, Quickstart is the fastest way in.