Overview

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

How it fits together

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

• The manager is a single daemon on your machine. It owns all credentials, the session database, the git worktrees, and every call to GitHub and Claude Code.
• The mobile app is an unprivileged client. It talks only to the manager, over HTTPS with mutual TLS, and never holds a GitHub token, a Claude credential, or filesystem access.
• Each session gets its own git branch and its own git worktree, cut from the repository’s default branch. Sessions work toward a draft pull request; merging is always an explicit action you take.
• GitHub issues can start sessions automatically when labelled by an allowlisted person — a feature that is off by default.

Where to go next

• Getting started — requirements, install, first run.
• 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.
• 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.