agentcontroll

Local-first control plane for coding agents (Antigravity, Claude Code, Codex, Devin CLI)

agentcontroll manages, sandboxes, switches between, and monitors autonomous coding agents inside full-fidelity terminal sessions with hardware-isolated account profiles and zero-configuration launch flows.

Quick Start

You can run AgentControll without manual compilation using npx:

npx agentcontroll

Or install it globally:

npm install -g agentcontroll
agentcontroll

On first execution, the runner detects your host operating system and CPU architecture, downloads the matching prebuilt release binary, and invokes the terminal interface with transparent signal and stdio forwarding.

Commands

The package includes the standard suite of commands:

# Launch the interactive terminal UI
agentcontroll

# Shorthand alias
ac

# Diagnose installation health, credentials, and account switching isolation
agentcontroll doctor
# or
ac doctor

# Deep diagnostics (scans for orphan profiles and unreferenced credentials)
agentcontroll doctor --deep

# Machine-readable JSON output
agentcontroll doctor --json

# Inspect daemon state or start the background control daemon
agentcontrold --help

Note on Antigravity (agy): AgentControll manages external Antigravity sessions and credentials, but does not install, wrap, or replace the external Google Antigravity CLI (agy). The real agy executable must be installed separately on your system.

Supported Systems

• Linux x86_64 (glibc 2.31+)
• macOS x86_64 (Intel)
• macOS aarch64 (Apple Silicon)
• Windows: Run natively inside WSL2 (npx agentcontroll)

License

MIT © AgentControll contributors. See LICENSE for details.