Install
Download and install atrium on macOS.
atrium ships as a signed macOS Universal binary (Apple Silicon and Intel).
Download
- Open the Download page and click Download Early Access. The top-right Download button in the navigation bar redirects to the same DMG.
- Open the downloaded
.dmg. - Drag atrium.app into Applications.
- Launch atrium from Applications or Spotlight.
System requirements
- macOS 12 (Monterey) or newer.
- Apple Silicon or Intel.
- ~50 MB free disk for the app and its data directory (
~/.atrium/).
What gets installed
- The app:
/Applications/atrium.app. - The CLI:
~/.atrium/bin/atriumis auto-installed on every launch. Its path is exported asATRIUM_CLI_PATHinto every terminal pane. Add it to your shellPATHif you want to callatriumfrom outside atrium panes:
export PATH="$HOME/.atrium/bin:$PATH"
- The data directory:
~/.atrium/stores configuration, workspace snapshots, installed adapters, custom themes, and shell integration files. See Data directory for the full layout.
Channels
- Early Access is the only channel available today. It updates frequently and ships directly from
main. - Stable and Beta channels are planned after the 1.0 release. They will use isolated bundle identifiers and data directories (
~/.atrium/for stable,~/.atrium-beta/for beta).
~/.atrium-dev/ and a separate bundle ID so they can run alongside a released build without overwriting state.
Uninstall
- Quit atrium.
- Drag
/Applications/atrium.appto the Trash. - Optionally remove the data directory:
rm -rf ~/.atrium. This deletes all workspaces, snapshots, custom themes, and installed adapters.
Updates
atrium checks for updates on launch by default. You can change the check interval, the channel, and whether updates auto-install under Settings → General → Updates.
