Getting Started

New to AgentOps? You're in the right place. This section answers three questions in order: what is it, how do I install it, and what's the first useful thing I can run.

If you're evaluating AgentOps for a team, start with the Newcomer Guide — it frames the product in fifteen minutes. If you're ready to ship code with it, skip to Install and then Golden Paths. If you want a structured curriculum, jump to the Levels path at the bottom. If you are upgrading from an older release, read Upgrading first.

:material-rocket-launch: Newcomer Guide

Practical repo orientation, mental model, and a fast path to becoming productive in the AgentOps codebase.
:material-puzzle-plus: Create Your First Skill

Fast path for authoring a first skill without tripping CI.
:material-school: Behavioral Discipline

Before/after examples of good coding-agent behavior.
:material-frequently-asked-questions: FAQ

Comparisons, limitations, subagent nesting, and uninstall.
:material-hand-coin: Contributing

How to contribute code, skills, and documentation.
:material-shield-check: Security

Vulnerability reporting and security policy.

Install

Pick the installer for your runtime.

=== "Claude Code"

```bash
claude plugin marketplace add boshu2/agentops
claude plugin install agentops@agentops-marketplace
```

=== "Codex CLI"

```bash
curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install-codex.sh | bash
```

=== "OpenCode"

```bash
curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install-opencode.sh | bash
```

Then install the ao CLI for repo seeding, health checks, and terminal workflows.

=== "macOS"

```bash
brew tap boshu2/agentops https://github.com/boshu2/homebrew-agentops
brew install agentops
```

=== "Windows PowerShell"

```powershell
irm https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install-ao.ps1 | iex
```

For other skills-compatible agents, install selected skills with:

bash <(curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install.sh)

Verify the install

ao doctor              # Checks runtime, skills, hooks, paths
ao --version           # Prints installed ao version

ao doctor is the canonical health check. It prints a per-component status line and non-zero exits on a real problem. If anything looks wrong, see Troubleshooting or run ao doctor --verbose.

Golden Paths

Pick one path. Each path ends with proof in .agents/ or an explicit PASS/WARN/FAIL verdict.

I want to...	Run	Success signal
Set up a repo for the first time	`ao quick-start`, then `/quickstart`	Readiness summary shows the next action
Make the first validated change	`/rpi "a small goal"`	Discovery, implementation, validation, and learning artifacts exist
Review code before shipping	`/council validate this PR` or `/vibe recent`	Verdict is recorded before merge
Continue tracked work	`bd ready`, then `/implement <issue-id>` or `/crank <epic-id>`	Issue status and validation evidence are updated
Run from the terminal	`ao factory start --goal "goal"`, then `ao rpi phased "goal"`	`ao rpi status` shows the phase result

Command Reference

ao quick-start     # Canonical repo seed and readiness repair
ao quickstart      # Stable alias for the same golden path
ao status          # Where was I?
ao rpi phased "goal"  # Full terminal Research-Plan-Implement-Validate loop

Learning path

If you want a structured curriculum, walk through the progressive Levels L1–L5:

L1 — Basics: single-session work
L2 — Persistence: cross-session bookkeeping
L3 — State Management: issue tracking with beads
L4 — Parallelization: wave-based execution
L5 — Orchestration: full autonomous operation

4.3 KiB Raw Blame History Unescape Escape