The operational layer for coding agents. Bookkeeping, validation, and flows that compound knowledge between sessions.
npx claudepluginhub boshu2/agentopsThe operational layer for coding agents. Bookkeeping, validation, and flows that compound knowledge between sessions.
Validation, memory, lifecycle gates, and briefing-first control for coding agents. AgentOps acts as a software-factory control plane: bounded context goes in, validated code and durable learning come out.
Start Here · Install · See It Work · Skills · CLI · FAQ · Newcomer Guide
Session 1, your agent spends 2 hours debugging a timeout bug. Session 15, a new agent finds the answer in 10 seconds — because /retro captured the lesson and the flywheel promoted it. Three capabilities make this work:
Every skill, hook, and CLI command exists to deliver one of these three. They form a single lifecycle contract, not separate features.
Operationally, that means AgentOps behaves like a software factory:
See Software Factory Surface for the explicit operator lane.
| Capability | What you get |
|---|---|
| Judgment validation | /pre-mortem challenges your plan before build; /vibe + /council validate code before commit |
| Durable learning | Repo-native memory via .agents/ — lessons compound across sessions, agents, and runtimes |
| Loop closure | Every cycle produces artifacts, issues, and next-work suggestions the next session acts on |
# Claude Code (recommended): marketplace + plugin install
claude plugin marketplace add boshu2/agentops
claude plugin install agentops@agentops-marketplace
# Codex CLI (0.110.0+ native plugin)
curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install-codex.sh | bash
# OpenCode
curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install-opencode.sh | bash
# Other Skills-compatible agents (agent-specific, install only what you need)
# Example (Cursor):
npx skills@latest add boshu2/agentops --cursor -g
On Linux, also install system bubblewrap so Codex uses it directly:
sudo apt-get install -y bubblewrap
Skills work standalone. The ao CLI unlocks the full repo-native layer: knowledge extraction, retrieval and injection, maturity scoring, goals, and control-plane workflows.
brew tap boshu2/agentops https://github.com/boshu2/homebrew-agentops
brew install agentops
which ao
ao version
Or install via release binaries or build from source.
Then type /quickstart in your agent chat.
In Claude Code, CLAUDE.md is the startup surface. Installed hooks stay
silent: SessionStart prepares runtime state and can stage factory goal or
briefing files, while UserPromptSubmit can capture first-prompt intake
without injecting additional context into the session.
Three commands, zero methodology. Pick one and go:
/council validate this PR # Multi-model code review — immediate value
/research "how does auth work" # Codebase exploration with memory
/implement "fix the login bug" # Full lifecycle for one task
When you're ready for more:
/plan → /crank # Decompose into issues, parallel-execute
/rpi "add retry backoff" # Full pipeline: research → plan → build → validate → learn
/evolve # Fitness-scored improvement loop — walk away, come back to better code
Every skill works alone. Compose them however you want. Full catalog: Skills.
If you want the explicit operator lane instead of individual primitives:
ao factory start --goal "fix auth startup"
/rpi "fix auth startup" # or: ao rpi phased "fix auth startup"
ao codex stop
Open Design — local-first design app exposed to coding agents over MCP. Install once with your agent's plugin command and projects/files/skills are reachable through stdio.
Claude Code plugins for the Slidev presentation framework
Bundled plugins for actuating and debugging the Chrome browser.