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 workspace of panes — terminals, editors, a markdown editor, a Chromium browser, git source control, search, and task cards — arranged in splits and rooms (tabs) inside workspaces (projects).
- 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. - An adapter-driven AI host: Claude Code, Codex, and Gemini are first-class, launched from an in-app picker, 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 workspace concept (pane, room, workspace, task, browser) is reachable from the
atriumCLI, 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 chat UI. Agents run in real terminal panes with their real CLIs.
How this documentation is organized
- Getting started — install, first run, launching an agent.
- Core concepts — the mental model: workspaces, rooms, panes, agents, tasks, persistence.
- Panes — one page per pane type, with full capability list.
- Agents — launching, the skills & agents registry,
+skill/++agentsigils, 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.
