Skip to content
Agent Hub

Install Locally

Agent Hub is currently distributed as a local source repository plus installed runtime copies. Keep operational state out of source control.

Requirements

Section titled “Requirements”
  • macOS or a Unix-like environment
  • Python 3.11+
  • Git
  • GNU Screen
  • Codex and/or Claude Code CLI when those workers are used
  • Optional: GitHub CLI and project-specific deployment CLIs

Install From Source

Section titled “Install From Source”

Clone the repository, then run:

Terminal window
./scripts/test.sh
./scripts/install.sh
./scripts/check-install.sh

The installer copies the runtime engine, prompt, skill, and launchers to the local runtime locations. It does not replace operational state such as session registries, event journals, logs, screen transcripts, or watcher history.

Start The Supervisor

Section titled “Start The Supervisor”
Terminal window
agent-hub

For a deterministic no-model fallback parser:

Terminal window
agent-hub-lite

For browser/mobile remote pairing through Codex Remote Control:

Terminal window
agent-hub-online

Verify Runtime Health

Section titled “Verify Runtime Health”
Terminal window
hub health --json
hub audit --json

Use health for readiness and exact repair steps. Use audit for proof of queue, delivery, ACK, review, deploy, reconciliation, and event state.