open-agentos-cli 1.1.0

CLI for GitHub AgentOS — provision label-driven multi-agent orchestration

Open AgentOS

AI Agent Command and Control Center

Open AgentOS turns a GitHub repository into an AI operating system. Issues move through a status-label state machine. Each transition fires a GitHub Actions workflow that routes work to the right AI agent. Agents act, post receipts, and hand off — the full lifecycle of an agent's work — from labelled issue to merged PR — all through standard GitHub primitives.

Bring your own agent: the runner — Claude, Codex, Hermes, your own script — is a config value, and Open AgentOS is the protocol around it. Every run leaves a cost-and-outcome record. Every role has its own least-privilege identity.

---

The loop

issue labelled status:todo
        │
        ▼
  orchestrator fires ── routes by label ──▶ builder agent
        │                                        │
        │                                   opens PR, sets status:in-review
        ▼                                        │
   reviewer agent ◀───────────────────────────── ┘
        │
   approves / requests changes
        ▼
   PR merges ──▶ watcher settles the board

Every run is accounted for

Each agent invocation leaves a structured record.

{
  "event": "run",
  "role": "builder",
  "issue": 42,
  "model": "claude-sonnet-4-6",
  "turns": 11,
  "max_turns_hit": false,
  "total_cost_usd": 0.58,
  "clean_exit": "clean",
  "outcome": "merged"
}

Built on least privilege

Each role gets its own GitHub App identity. The reviewer App can't push code — so a reviewer cannot approve its own work. The board App can't touch source. Every action an agent takes is attributable to a named identity, by design rather than by policy.

---

Quickstart

A first run needs one agent. The full review-and-settle loop comes after.

# Install, and pull the spec into a repo
uv tool install open-agentos-cli
cd my-agent-repo
agentOS init --from github:open-agentos/spec@v1.1.0

# Create the one App a first run needs (opens the browser once)
agentOS setup --repo my-org/my-agent-repo --apps builder

# Provision labels, board, and workflows; commit them; confirm
agentOS apply  --repo my-org/my-agent-repo --commit
agentOS verify --repo my-org/my-agent-repo

Then label an issue type:feature + status:todo and watch the PR open. Full walkthrough: Getting Started.

---

Docs

• Getting Started — first run in ~30 minutes
• Agent Roles — identities, permissions, the runner interface
• Label Model — the state machine behind the labels
• Metrics Schema — the run-record corpus
• Specification — the normative reference
• Uninstall — how to remove agentOS from a repo

License

MIT — see LICENSE.