Skip to content

> install.sh

Install AgentOps

Pick the runtime you use. Restart your agent after install, then type /quickstart in your agent chat.

AgentOps is the operational layer for coding agents — bookkeeping, validation, primitives, and flows that turn every session into compounding progress. The full product, docs, and source live at github.com/boshu2/agentops.

Agent runtimes

Claude Code

Native plugin marketplace. Restart Claude Code after install, then type /quickstart.

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

Codex CLI — macOS, Linux, WSL

Shell install script. Adds AgentOps skills to your Codex config.

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

Codex CLI — Windows PowerShell

Run in an elevated PowerShell session.

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

OpenCode

Shell install script for OpenCode users.

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

Other skills-compatible agents (Cursor, etc.)

Uses the skills CLI to add AgentOps skills globally.

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

The ao CLI (optional, recommended)

The ao CLI unlocks repo-native bookkeeping, retrieval, health checks, and terminal workflows. Your agent can work without it; your repo gets smarter with it.

macOS (Homebrew)

Recommended. Adds the ao tap and installs the binary.

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

Windows PowerShell

One-line installer. Verify with ao version.

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 doctrine behind it.