Overview

Agentarivm is a self-hosted manager for coding agents. It runs on a dedicated machine you own — a Mac or a Linux box — and lets you create, monitor and finish coding tasks from a mobile app.

Two engines are supported today: Claude Code and Codex. A deployment can run either or both, each task picks one, and the autonomous loop can have one engine review another’s work.

How it fits together

Flutter app ──HTTPS + mutual TLS──▶ Manager (your machine)
                                       │
                    ┌──────────────────┼──────────────────┐
                    │                  │                  │
              SQLite state      Git worktrees      Agents (child processes:
                    │                                 Claude Code, Codex)
                    │
                  GitHub

• The manager is a single daemon on your machine. It owns all credentials, the task database, the git worktrees, and every call to GitHub and to the agent engines.
• The mobile app is an unprivileged client. It talks only to the manager, over HTTPS with mutual TLS, and never holds a GitHub token, an agent credential, or filesystem access.
• Each task gets its own git branch and its own git worktree, cut from the repository’s default branch, and runs on one engine chosen when it is created. Tasks work toward a draft pull request; merging is always an explicit action you take.
• GitHub issues can start tasks automatically when labelled by an allowlisted person — including which engine runs the work.

Where to go next

• Getting started — requirements, install, first run.
• Command cheatsheet — every agentarivm command on one page.
• Installation — platform details and running as a service.
• Pairing your phone — the QR + mutual TLS pairing flow.
• Configuration reference — the agentarivm.yml file.
• Security model — why the phone can never hold a credential.
• GitHub issue automation — labels that start work.
• Troubleshooting — doctor, PATH-under-daemon failures, reconcile.
• Error reference — every code the manager can report, and every reason a task can fail.
• Windows via WSL2 — running the manager on a Windows machine.
• Tutorial — an end-to-end walkthrough from a fresh machine to a merged pull request.

Status

Agentarivm is a commercial product by Marcel Čampa s.p. It is young: expect sharp edges, and read the security model before exposing the manager to a network.