atrium — FAQ
faq — ask me anything

atrium agent

Frequently asked questions

Common questions about atrium. Don't see yours? Drop into the Discord or file an issue.

Pricing & access

2

What does atrium cost?

atrium agent

atrium is free during public beta. A paid model is planned for later, but the plan is to keep pricing affordable, predictable, and tiered by org size, not feature-set. No ambiguous “credits” system, expensive “agent”, or extra fees for features that don't carry real operating cost.

Is the public beta gated?

atrium agent

No — anyone can download from the releases page. Public beta means features are still shifting fast and the feedback loop is open. Bugs you find, features you request, and rough edges you flag genuinely shape the roadmap.

Platform support

5

What operating systems does atrium support?

atrium agent

The desktop client runs on macOS 12 or later (signed and notarized) and on Windows 10 or 11, 64-bit. The Windows installer is not code-signed yet, so Windows SmartScreen shows a warning on first run; choose More info, then Run anyway. Connect to self-hosted Linux locations over SSH, or pair another Mac or Windows PC over Tailscale. The iPhone and iPad app is in private TestFlight beta; see the mobile docs.

Can I run atrium work on another machine?

atrium agent

Yes. Under Settings → Locations, add a Linux server over SSH or pair another Mac or Windows PC using a one-time code. Projects, rooms, terminals, agent chats, tasks, notes, source control, and recurring runs stay on the machine that owns them while you work from your desktop. On the host computer, Settings → Remote access controls who can connect. See the locations docs.

Can I keep working from my phone or tablet?

atrium agent

The iPhone and iPad app is in private TestFlight beta. Pair it with a machine, open an existing conversation, and send a follow-up or answer a request. You can review changes and use interactive canvases, HTML pages, and Walk Mode. Work stays on the machine that owns it; a direct connection to a server can keep working without the desktop client. See mobile setup and availability.

Is there a Windows or Linux desktop client?

atrium agent

Windows is available now: download the installer from the releases page or follow Install on Windows. A Linux desktop client remains on the roadmap, with no committed date. Linux is already supported as an SSH compute location, but the full atrium UI does not run on Linux yet. Linux needs its own native testing for terminals, file watchers, browser handling, windows, and permissions before we ship it.

What are the system requirements?

atrium agent

macOS 12 (Monterey) or later, or Windows 10 or 11 (64-bit), for the desktop client. On macOS, atrium ships separate native builds for Apple Silicon and Intel Macs; expect a roughly 350 MB download and about 700 MB installed. On Windows, expect about 900 MB installed, plus Git for Windows so agent adapters can run. Data grows with projects, transcripts, and captures. Optional SSH locations need a reachable Intel or ARM Linux box, including WSL2.

What atrium is (and isn’t)

3

How is atrium different from Cursor / Warp / Zed?

atrium agent

Cursor is an AI IDE with its own model integrations. Warp is an AI-powered terminal. Zed is a fast editor with collab features. atrium is none of those — it's the workspace around whatever AI CLIs you already use.

atrium hosts your existing coding agents through adapters, including Claude Code, Codex, Antigravity, Muse Code, and Goose. We save the workspace on the machine that owns it, restore panes and terminal history, and resume supported agent sessions. You can review, steer, and coordinate work from one place, including scheduled runs that continue with the window closed.

Why a standalone app instead of a VS Code extension?

atrium agent

atrium isn't an editor — it's a workspace shell. Each pane can be a terminal, browser, editor, or task view, and the layout, scrollback, and agent sessions all persist together. That model doesn't fit inside an editor extension; it needs to own the workspace shell.

Is atrium open source?

atrium agent

The adapter SDK is MIT-licensed and lives in a public GitHub repo — that's where the community surface is. We also have a robust plugin/extension ecosystem on our roadmap. The atrium app itself is closed source for now to give the project runway. We may revisit this later.

Features

6

Can I see everything that happened in a workspace?

atrium agent

That's the Timeline: a chronological feed of prompts, agent replies, commits, tasks, and notes, grouped by day. Scope it to a project, room, or pane, search it full-text, or turn a stretch into a Brief, Update, or Recap note. The feed backfills from available git history, tasks, and transcripts.

Can agents use my other tools?

atrium agent

Yes. Add an MCP connector in Settings → Connectors, then sign in if it needs an account. Each session shows which tools it can use. Launch profiles save your choices for future sessions. Connectors run on the machine that owns the work. See the connector guide.

Can I interact with an answer inside chat?

atrium agent

Yes. Agents can produce canvases with charts, controls, and forms. Change a value or submit a choice and send it back into the conversation. Interactive HTML pages are also available on macOS and in the mobile beta. See live canvases and pages.

What is HQ?

atrium agent

HQ gives recurring work a director: a persistent conversation with a playbook, scheduled routines, and delegated work you can follow. Directors and staff have separate roles. Start with one responsibility, then add routines as you find work worth repeating. See HQ: directors and recurring work.

What's the Observatory?

atrium agent

A navigable 3D map of your project history. Each project is a galaxy, each session a star, each major commit a supernova. Click a galaxy for its stats — sessions, top files, adapter mix, recent commits — or scrub a timeline back through the year. There's an optional ambient soundscape, off by default. It's the wide-angle view of where your work has been.

Can atrium find an old session for me?

atrium agent

Yes. atrium indexes available session history into a searchable Vault. Search it from the Library or the new-room picker — results come back ranked by content, with snippets and fuzzy matching. From the shell, atrium edits <file> finds indexed sessions that touched a file. Tune indexing depth and time horizon in Settings → Vault.

Agents & adapters

2

Which AI agents work with atrium?

atrium agent

The current registry includes Claude Code, Codex, Antigravity, Cursor Agent, Kimi Code, OpenCode, Pi, Grok, Hermes, Oh My Pi, Muse Code, and Goose. Adapters declare session detection, resume, chat, and other capabilities; support varies by tool. See the adapter list.

Can I add support for a different agent or my own CLI?

atrium agent

Yes — that's exactly what the adapter SDK is for. An adapter is a small JSON manifest plus a few hook scripts describing how to detect and resume the agent's sessions. See the adapter docs for the full spec, or open a request in Discord and we'll help. Just about any CLI harness can be supported, but the level of integration depends on features. If it has robust hooks, it can tap into everything atrium provides.

Data & privacy

3

How is my data handled?

atrium agent

Local-first by design. Local atrium state, scrollback, and agent metadata live under ~/.atrium/; repositories stay in the folders you choose. Remote state and files stay on the server or paired computer that owns them. atrium does not proxy repositories or terminal traffic through an atrium server.

Does atrium send any data to your servers?

atrium agent

Core telemetry is on by default: app lifecycle, active-use heartbeat, setup milestones, version/OS/architecture/locale, and update outcomes. Detailed usage analytics and crash reports require a separate opt-in. Choose Send nothing in Settings → Privacy & data to disable both tiers. Project files, paths, commands, URLs, prompts, transcripts, and task contents are excluded. See the telemetry docs.

And if you turn on notifications in the iOS app, your phone's Apple push token, sealed notification envelopes, and a delivery pass every few days pass through atrium's push relay on their way to Apple. The relay can't read the notifications and keeps no copy. See push notifications and the privacy policy.

Do my agents' conversations go through your servers?

atrium agent

No. Coding agents talk directly to their own providers from the machine running them. atrium hosts terminal sessions or renders the agent's protocol in a chat pane, and stores session state and history on that machine; those conversations do not pass through an atrium server.

The iOS app connects directly to the machines you pair it with, too. Push notifications do pass through our relay on their way to Apple, but they're end-to-end encrypted: the relay can't read them. It sees which phone to wake, when, and how often; the push notifications docs list everything it can see.

Getting help

2

I found a bug — where do I report it?

atrium agent

Public issue tracker: github.com/jonnyasmar/atrium-issues. Include your atrium version (title bar or atrium > About), your macOS or Windows version, what you expected, and what happened.

For “is this expected?” sanity checks before filing, drop into #bugs on the Discord.

I have a feature request or want to chat with the team.

atrium agent

Best place is the Discord — #feedback for ideas, #general for everything else. We read every message.