Getting started

Choose the setup based on where your repositories and agents should run.

Desktop app

Use the desktop app when the projects are on the computer in front of you. It starts the local Atmos Server automatically and gives you access to desktop-only features such as Appshots and Tunnel Connector.

brew install --cask AruNi-01/tap/atmos

On macOS you can also use the installer script:

curl -fsSL https://install.atmos.land/install-desktop.sh | bash

For Windows and Linux builds, use GitHub Releases.

After installing, open Atmos like any other app. Closing the main window on macOS hides the app; quitting the app stops the local Atmos Server.

Browser app

Use the browser app when you want the UI in a tab, or when you plan to connect to an Atmos Computer.

Open Atmos in Browser

Start from the web app at app.atmos.land.

For local browser use, install the local web runtime:

curl -fsSL https://install.atmos.land/install-local-web-runtime.sh | bash

The runtime installs under ~/.atmos/runtime/current, writes ~/.atmos/runtime_manifest.json, and serves the UI from your own machine.

Mobile app

The Mobile App is currently in development and temporarily unavailable.

Use the native iOS or Android app when you want to check work from your phone. The phone does not run Atmos Server or clone projects. It connects through Relay to an online Atmos Computer.

If you have the mobile app installed, start with Connect Atmos, create or enter an Access Token, generate the one-time register command, and run that command on the computer where your repos should live.

First workspace

Launch Desktop, open Atmos in your browser, or connect to an Atmos Computer.
Add a project folder when Atmos asks for one.
Create a workspace for the task you want to run in parallel.
Atmos prepares an isolated working folder and branch for that task.
Open the workspace terminal.
Start your code-agent CLI in that terminal, or use the global agent chat panel for a focused change.
Review the diff before you commit.

First Code Agent Terminal

Atmos is terminal-first: start the code agent you already use inside the workspace terminal. Built-in agent presets include Claude Code, Codex, Gemini, Devin, Amp, Droid, OpenCode, Kimi, Cursor Agent, Kilo Code, Kiro, CommandCode, Pi, OpenClaw, and Hermes Agent.

Each workspace keeps its own terminal session, branch, files, and diff, so you can run several agents side by side without mixing their work. Use Settings -> Code Agent to enable agents, adjust commands, add custom agents, or save run configurations with model, reasoning, and extra arguments.

For parallel work, create one workspace per task and start one agent in each workspace terminal. Use the sidebar, Kanban, Canvas, and Review views to monitor progress and bring finished changes back into your normal Git flow.

Next steps

Project & Workspace Manager for projects, workspaces, scripts, and Kanban.
General Build Process for the daily build loop.
Remote Build when work should run on another machine.
CLI overview when you need setup, status, or agent integration commands.