Getting started

Codius runs your coding agents on your machine and gives you mobile, desktop, and web clients to drive them from anywhere. Codius CLI is available for advanced host administration.

Desktop app (recommended)

Download from codius.ai/download or the GitHub releases page. Open it and you're done.

The desktop app bundles its own daemon and starts it automatically, no separate install required. On first launch you'll see a brief startup screen, then connect from your phone using Settings → your host → Connections → Pair a device.

Server / Codius CLI

For a headless machine, use the documented Docker image or install Codius CLI from npm:

npm install -g @codius.ai/cli

When you start a headless host with codius daemon start, Codius prints a QR code in the terminal. Scan it from the mobile app, or enter the daemon address manually from another client.

The daemon can also serve the browser web app itself, so you can use the full UI without the hosted app. See Self-hosting the web UI.

Configuration and local state live under CODIUS_HOME (defaults to ~/.codius).

Docker

For servers, dev boxes, NAS devices, or homelab hosts, run the official image:

docker run -d --name codius \
  -p 6767:6767 \
  -e CODIUS_PASSWORD=change-me \
  -v "$PWD/codius-home:/home/codius" \
  -v "$PWD:/workspace" \
  ghcr.io/CodiusAI/codius-app:latest

Then open http://localhost:6767.

The image runs the daemon and serves the bundled web UI. It does not bundle agent CLIs, so extend it with the agents you use. See Docker for Compose, reverse proxy, agent install, and security examples.

Where next

• Docker, run the daemon and bundled web UI in a container.
• Workspaces, the project, workspace, and session model Codius is built around.
• Providers, what a provider is and how Codius wraps existing CLIs.
• Orchestration, let one agent delegate work to other providers and models.
• Codius CLI reference, every codius command.
• Self-hosting the web UI, serve the browser app from your own daemon.
• GitHub repo
• Report an issue

Prerequisites

Codius manages other agents, it doesn't ship one. Before it's useful, install at least one provider CLI yourself and make sure it works with your credentials. See Supported providers for the full list.

You'll also want the GitHub CLI (gh) installed and authenticated, Codius uses it for PR-aware worktrees and a few orchestration features.