quickstart

$27

Output exactly this (no additions, no diagrams):

AgentOps is the operational layer for coding agents.

It gives your coding agent four things it doesn't have by default:

  Bookkeeping — sessions capture learnings, findings, and reusable context in .agents/

  Validation  — /council, /pre-mortem, and /vibe challenge plans and code before shipping

  Primitives  — skills, execution packets, and the ao CLI give you building blocks for almost any interaction

  Flows       — /research, /implement, /validation, and /rpi can run alone or compose end to end

Key skills: /rpi  /research  /validation  /implement  /council  /pre-mortem  /swarm  /status

Full reference: /quickstart --catalog

Step 3: One next action

Match the first row that applies. Output that message, then append the Step 4 always-on lane.

Condition

Message

GIT=false + AO=true + GLOBAL_AGENTS=true

"🗂 You're outside a git repo but have a global corpus at ~/.agents. Global knowledge workflow:\n 1. /harvest — scan all .agents/ across your repos and promote artifacts into ~/.agents/learnings/\n 2. /compile — mine, synthesize, and write an interlinked wiki into .agents/compiled/ (runs from cwd; set AGENTOPS_COMPILE_RUNTIME=claude-cli if you have the claude CLI, no API key needed)\n 3. /knowledge-activation — turn the compiled corpus into playbooks, a belief book, and runtime briefings for future sessions\n 4. /status — flywheel health snapshot\nIf instead you want to start a fresh repo-local project here, git init first."

GIT=false

"⚠ Not in a git repo. Run git init first.\n (If you meant to work against your global ~/.agents corpus, run /quickstart from a dir with .agents/ or see /harvest, /compile, /knowledge-activation.)"

AO=false + CODEX=true

"📦 Install ao CLI first:\n brew tap boshu2/agentops https://github.com/boshu2/homebrew-agentops\n brew install agentops\n ao quick-start\nThen: /rpi \"a small goal\" to run your first cycle.\nUse /bootstrap after the core seed when you want PRODUCT.md, README.md, and PROGRAM.md."

AO=false

"📦 Install ao CLI first:\n brew tap boshu2/agentops https://github.com/boshu2/homebrew-agentops\n brew install agentops\n ao quick-start\nThen: /rpi \"a small goal\" to run your first cycle.\nUse /bootstrap after the core seed when you want PRODUCT.md, README.md, and PROGRAM.md."

AGENTS=false + CODEX=true

"🌱 ao is installed but not initialized here.\n Run ao quick-start to apply the repeatable core seed. ao quickstart is the stable alias.\n Then run /bootstrap only if you want the product/operations layer: PRODUCT.md, README.md, PROGRAM.md/AUTODEV.md, and optional hooks.\nThen: /rpi \"a small goal\" to run your first cycle."

AGENTS=false

"🌱 ao is installed but not initialized here.\n Run ao quick-start to apply the repeatable core seed. ao quickstart is the stable alias.\n Then run /bootstrap only if you want the product/operations layer: PRODUCT.md, README.md, PROGRAM.md/AUTODEV.md, and optional hooks.\nThen: /rpi \"a small goal\" to run your first cycle."

BD=false + CODEX=true

"✅ Codex plugin path ready.\n /rpi \"your goal\" — full /discovery → /crank → /validation pipeline\n /research <topic> — explore the codebase\n Default installs are hookless; native hooks are optional with install-codex.sh --with-hooks.\n Legacy explicit fallback commands remain ao codex ensure-start / ao codex ensure-stop when needed.\n Manual escape hatch: ao codex status\n Want issue tracking? brew install boshu2/agentops/beads &#x26;&#x26; bd init --prefix <prefix>"

BD=false

"✅ Flywheel active. Start now:\n /rpi \"your goal\" — full /discovery → /crank → /validation pipeline\n /validation — close out recent work and capture learnings\n /research <topic> — explore the codebase\n Want issue tracking? brew install boshu2/agentops/beads &#x26;&#x26; bd init --prefix <prefix>"

BD=true + CODEX=true

"✅ Codex full stack ready.\n bd ready — see open work\n /rpi \"your goal\" — start a new goal from scratch\n Default installs are hookless; native hooks are optional with install-codex.sh --with-hooks.\n Legacy explicit fallback commands remain ao codex ensure-start / ao codex ensure-stop when needed.\n Manual escape hatch: ao codex status"

BD=true

"✅ Full stack ready.\n bd ready — see open work\n /rpi \"your goal\" — start a new goal from scratch\n /status — see current session state"

Step 4: Schedule a nightly dream (always-on lane)

After the next-action message, append this one-liner so the user sees scheduling co-equal with compiler+gates:

🌙 Always-on lane:

  ao daemon run --schedule-file .agents/schedule.yaml &              # start the daemon

  ao schedule add --file ./examples/schedules/dream-nightly.yaml     # register a nightly recipe

ao daemon run is the always-on lane that fires registered schedules on cron — start it once (or wire to systemd) and your nightly dream, harvest, and compile work happen without you babysitting. See docs/scheduling.md for the full recipe catalog.

Starting a new project? Run /scaffold <language> <name> to generate project structure with best practices.

Examples

First-Time Setup

User says: /quickstart

What happens: Agent detects tools, shows one-line status, gives the single next action to run.

Already Set Up

User says: /quickstart

What happens: Agent detects full stack is ready and suggests /rpi "your goal" or bd ready.

Troubleshooting

Problem

Solution

Skills not installed

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

Hook activation

Default installs are hookless. Opt into native hooks with install-codex.sh --with-hooks or ao hooks install --force; legacy explicit fallback commands are ao codex ensure-start and ao codex ensure-stop.

Flywheel count is 0

First session — run /rpi "a small goal" to start it

Want the full skill catalog

Ask: "show me all the skills" or see references/full-catalog.md

Reference Documents

• references/getting-started.md

• references/troubleshooting.md

• references/full-catalog.md

See Also

• scaffold — Project scaffolding and component generation