The repository or configuration that created this release differ from a previous release. View details.
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/agentos@v1.2.3
# 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
- Intake: the YOLO lane — unplanned PRs, wild classification,
/approve-intent - Metrics Schema — the run-record corpus
- Specification — the normative reference
- Uninstall — how to remove agentOS from a repo
- DIY AgentOS — build your own agent loop
Intake setup requirements (v1.2+)
Three extra steps beyond a standard agentOS install if you want the wild-PR pipeline to work end to end:
ANTHROPIC_API_KEYrepo secret — the archaeologist needs it to run.- Watcher App must have Pull requests: Read and write — it writes the
Closes #Nlink that stub dedupe and merge-settlement depend on.agentOS upgradewill tell you if it's missing. agents/archaeologist/AGENT.mdin the repo — installed automatically byagentOS initfrom v1.2.2 onward.
The archaeologist has no GitHub App by design — this is not a step you missed. It is the only role without an App identity; see docs/intake.md and SPEC.md §13 for why.
agentOS verifywill warn if an App for it is found.
License
MIT — see LICENSE.
Metadata
Release files for open-agentos-cli 1.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Change of provenance
The repository or configuration that created these release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| open_agentos_cli-1.2.3.tar.gz | 126.7 kB | With provenance | Details for open_agentos_cli-1.2.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| open_agentos_cli-1.2.3-py3-none-any.whl | Python 3 | none | any | Details for open_agentos_cli-1.2.3-py3-none-any.whl |
Total release size: 233.7 kB
Release files / open_agentos_cli-1.2.3.tar.gz
Change of provenance
This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
| Download URL | open_agentos_cli-1.2.3.tar.gz |
|---|---|
| Size | 126.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cfd88e8eae54b1769e07aef40671dcfbe33d2762a994365bbb96a85464b56260
|
|
BLAKE2b-256 checksum How to use checksums |
59126efdd82185f1723fe3f9f7dc54cd1ec8a34b5549d6b76d214d932714ab1d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 10, 2026.
Transparency logRelease files / open_agentos_cli-1.2.3-py3-none-any.whl
Change of provenance
This file belongs to a release with changed provenance: the repository or configuration that created the release files differ from that of a previous release.
We recommend inspecting the repository and configuration before proceeding. View details.
| Download URL | open_agentos_cli-1.2.3-py3-none-any.whl |
|---|---|
| Size | 107.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5ad97899b72e2d0271221e45e196fb2411f7df5d1b75275567666d707bfb80c7
|
|
BLAKE2b-256 checksum How to use checksums |
5b0ca5281c07b316c510341fcc8a6a9b8b2c6d75e71bb0188a7a0aaf255434a0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 10, 2026.
Transparency logSecurity for open-agentos-cli 1.2.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Change of provenance
The repository and configuration that created this release differ from a previous release.
While this could reflect a routine change by the project maintainers, it may also indicate that the release files have been compromised.
Repository
- Removed 1.1.0 github.com/open-agentos/spec
- Added 1.2.3 github.com/open-agentos/agentos
Attestation for open_agentos_cli-1.2.3.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 10, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.