$quickstart

One job: Tell a new user what AgentOps does and what to do first. Fast.

YOU MUST EXECUTE THIS WORKFLOW. Do not just describe it.

Execution Steps

Step 1: Detect setup

git rev-parse --is-inside-work-tree >/dev/null 2>&1 && echo "GIT=true" || echo "GIT=false"
command -v ao >/dev/null && echo "AO=true" || echo "AO=false"
command -v bd >/dev/null && echo "BD=true" || echo "BD=false"
[ -d .agents ] && echo "AGENTS=true" || echo "AGENTS=false"
[ -n "${CODEX_THREAD_ID:-}" ] || [ "${CODEX_INTERNAL_ORIGINATOR_OVERRIDE:-}" = "Codex Desktop" ] && echo "CODEX=true" || echo "CODEX=false"

Step 2: Show what AgentOps does

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, hooks, 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 only that message — nothing else.

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

See Also

• scaffold — Project scaffolding and component generation

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

Reference Documents

• references/getting-started.md
• references/troubleshooting.md
• references/full-catalog.md

Local Resources

references/

• references/full-catalog.md
• references/getting-started.md
• references/troubleshooting.md

scripts/

• scripts/validate.sh