Skip to content

CLI Overview

The ao CLI is the programmatic surface for AgentOps. It bundles every skill invocation, hook lifecycle, validation gate, and knowledge-flywheel operation into a single Go binary.

  • Command Reference Every ao command with flags, examples, and exit codes. Auto-generated from ao --help.

  • Hooks Reference Session-start, session-end, pre-tool, and post-tool hook contracts for Claude Code and Codex runtimes.

  • CLI ↔ Skills Map Which commands are called by which skills and hooks.

Installation

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

This installs:

  • The ao binary to ~/.local/bin/ao
  • Skills to ~/.claude/skills/
  • Hooks to ~/.claude/hooks/

Quickstart

Bash
ao --version              # Verify install
ao rpi "fix the flaky auth test"   # Full Research -> Plan -> Implement -> Validate cycle
ao status                 # Where was I?
ao goals measure          # Fitness gate