> install.sh

Install AgentOps

Pick your runtime. Restart your agent. Type /quickstart.

AgentOps is the in-session loop plus the corpus it compounds: skills in your harness, the ao CLI in your repo, and evidence in .agents/. It ships hookless by default; CI and explicit gates carry the proof. Source: github.com/boshu2/agentops.

Star the repo Skills catalog

Agent runtimes

Claude Code

Native plugin marketplace. Restart, then run /quickstart.

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

Codex CLI (macOS, Linux, WSL)

Shell installer. Wires skills into your Codex config.

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

Codex CLI (Windows PowerShell)

Elevated PowerShell.

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

OpenCode

Shell installer for OpenCode.

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

Other skills-compatible agents (Cursor, etc.)

Adds AgentOps skills globally via the skills CLI.

npx skills@latest add boshu2/agentops --cursor -g

The `ao` CLI (optional, recommended)

The ao CLI adds repo-native bookkeeping, retrieval, health checks, and terminal workflows. Your agent can run the skills without it; your repo gets more reviewable with it.

macOS (Homebrew)

Recommended.

brew tap boshu2/agentops https://github.com/boshu2/homebrew-agentops
brew install agentops
ao version

Windows PowerShell

One line.

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

Next step

In your agent chat, run:

/quickstart

It detects setup, explains the system, and gives you the next action. See the skills catalog for everything AgentOps can do, or jump straight into the 12 factors to understand the operating rules behind it.