README
¶
ao - Agent Operations CLI
CLI for the CASS (Contextual Agent Session Search) knowledge flywheel. Automates knowledge capture, retrieval, and reinforcement learning across Claude Code sessions.
Install
go install github.com/boshu2/agentops/cli/cmd/ao@latest
Quick Start
# From your repo root: create `.agents/` + register hooks
ao init --hooks
# Verify installation
ao hooks test
That's it. Knowledge now flows automatically between sessions.
What It Does
SessionStart: Injects relevant prior knowledge weighted by freshness and utility.
SessionEnd: Extracts learnings and updates the feedback loop.
Core Commands
| Command | Purpose |
|---|---|
ao inject |
Inject knowledge into current session |
ao forge transcript |
Extract learnings from session transcripts |
ao feedback-loop |
Update utility scores based on outcomes |
ao metrics report |
View flywheel health and escape velocity |
Ratchet Workflow
Track progress through the RPI (Research → Plan → Implement) workflow:
ao ratchet gate plan # Check if ready for planning
ao ratchet record research # Lock research completion
ao ratchet status # View current progress
Hooks Management
ao init --hooks # Recommended: repo setup + hooks (SessionStart + Stop)
ao init --hooks --full # Optional: all 8 lifecycle events
# Lower-level (hooks only; does not create `.agents/`)
ao hooks init # Generate hooks configuration
ao hooks install # Install to Claude Code
ao hooks show # View current hooks
ao hooks test # Verify hooks work
Knowledge Commands
ao inject "kubernetes" # Inject knowledge about k8s
ao inject --apply-decay # Apply confidence decay first
ao search "error handling" # Search knowledge base
Task Integration
Sync Claude Code tasks with CASS maturity system:
ao task-sync # Sync current tasks
ao task-sync --promote # Promote completed tasks
ao task-status # View maturity distribution
The Science
The flywheel equation:
dK/dt = I(t) - δ·K + σ·ρ·K
- δ = 0.17/week - Knowledge decay rate (Darr et al.)
- σρ > δ - Escape velocity for compounding knowledge
See docs/HOOKS.md for details.
For a complete command reference, see docs/COMMANDS.md.
License
MIT
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
ao
command
Package main is the entry point for the ao CLI.
|
Package main is the entry point for the ao CLI. |
|
Package embedded provides hooks, scripts, and skill files embedded in the ao binary.
|
Package embedded provides hooks, scripts, and skill files embedded in the ao binary. |
|
internal
|
|
|
config
Package config provides configuration management for AgentOps.
|
Package config provides configuration management for AgentOps. |
|
context
Package context provides context budget tracking and progressive summarization.
|
Package context provides context budget tracking and progressive summarization. |
|
formatter
Package formatter provides output formatters for olympus sessions.
|
Package formatter provides output formatters for olympus sessions. |
|
goals
Package goals manages GOALS.yaml and GOALS.md fitness specifications, including loading, validation, drift detection, and historical measurement snapshots.
|
Package goals manages GOALS.yaml and GOALS.md fitness specifications, including loading, validation, drift detection, and historical measurement snapshots. |
|
parser
Package parser provides extraction patterns for knowledge discovery.
|
Package parser provides extraction patterns for knowledge discovery. |
|
pool
Package pool manages knowledge candidate pools for the quality pipeline.
|
Package pool manages knowledge candidate pools for the quality pipeline. |
|
provenance
Package provenance tracks the lineage of olympus artifacts.
|
Package provenance tracks the lineage of olympus artifacts. |
|
ratchet
Package ratchet implements the Brownian Ratchet workflow tracking.
|
Package ratchet implements the Brownian Ratchet workflow tracking. |
|
rpi
Package rpi implements the Research-Plan-Implement workflow orchestrator, including worktree management, toolchain execution, and branch lifecycle.
|
Package rpi implements the Research-Plan-Implement workflow orchestrator, including worktree management, toolchain execution, and branch lifecycle. |
|
safety
Package safety provides runtime guards and input validation that protect agent-driven workflows from accidental and adversarial misuse.
|
Package safety provides runtime guards and input validation that protect agent-driven workflows from accidental and adversarial misuse. |
|
search
Package search provides an inverted index for fast keyword-based search across AgentOps session and knowledge files.
|
Package search provides an inverted index for fast keyword-based search across AgentOps session and knowledge files. |
|
storage
Package storage provides interfaces and implementations for persisting olympus session data, indexes, and provenance records.
|
Package storage provides interfaces and implementations for persisting olympus session data, indexes, and provenance records. |
|
taxonomy
Package taxonomy defines the knowledge classification system and scoring rubric.
|
Package taxonomy defines the knowledge classification system and scoring rubric. |
|
types
Package types defines all data structures for the Olympus knowledge pipeline.
|
Package types defines all data structures for the Olympus knowledge pipeline. |
|
vibecheck
Package vibecheck provides types and tools for analyzing git commit timelines and producing vibe-check results (metrics, findings, and grades).
|
Package vibecheck provides types and tools for analyzing git commit timelines and producing vibe-check results (metrics, findings, and grades). |
|
worker
Package worker provides a generic concurrent worker pool for fan-out/fan-in file processing.
|
Package worker provides a generic concurrent worker pool for fan-out/fan-in file processing. |
|
pkg
|
|
|
vault
Package vault provides Obsidian vault detection utilities.
|
Package vault provides Obsidian vault detection utilities. |
Click to show internal directories.
Click to hide internal directories.