Install

Linux server (recommended)

curl -fsSL https://dl.aircode.example/install.sh | bash

The installer:

detects your platform (linux-x64, linux-arm64),
downloads the release tarball and verifies its sha256 checksum and Ed25519 signature,
installs to ~/.aircode/versions/<version> with a ~/.aircode/current symlink,
links aircode into ~/.local/bin,
checks system dependencies (git, tmux) and tells you exactly what to install if something is missing.

No root required. Everything lives in your home directory. Re-running the installer repairs or updates the installation.

Options: --channel beta, --version x.y.z, --service (installs the systemd user service immediately), --no-modify-path.

System requirements

Requirement	Notes
Linux x64 / arm64	Ubuntu 22.04+, Debian 12+, Fedora (recent) — glibc
`git`, `tmux`	`sudo apt-get install -y git tmux`
Agent CLIs	Claude Code, Codex, Gemini CLI… installed and authenticated with your accounts
Docker (optional)	Docker Engine or Docker Desktop for per-session sandbox execution
systemd (optional)	for `aircode service install` + `loginctl enable-linger`

The Node.js runtime is embedded — no system Node required.

macOS

Desktop app (recommended): download the .dmg from the download page. It embeds the full server (local sessions) and connects to remote servers too.

Headless / CLI: the same one-liner as Linux works on macOS 13+ (darwin-arm64, darwin-x64). Install tmux via Homebrew first.

Windows

Install the desktop app from the download page. Local sessions run natively on Windows through ConPTY. The installer embeds the server and its Node.js runtime, so WSL, a Linux distribution, and a system Node installation are not required. It also adds aircode to the current user’s PATH, allowing the embedded server to run from PowerShell or Command Prompt. Open a new terminal after setup and see the Windows command-line reference. The app can also connect to remote Aircode servers.

Heavy optional components

Nothing big is downloaded implicitly:

aircode browser install   # pinned Chromium for the agent browser
aircode doctor browser    # verify it

Knowledge embeddings models download on first indexing (local inference, CPU).

The Docker session image is also opt-in. During the source preview, build and validate it from the checkout:

npm run docker:runtime:build
npm run docker:session:smoke

See Docker sandbox for Web/Desktop/mobile selection, mounts, resource limits and the public-image status.