quickstart

OverviewHistoryStatsSecurity

npx skills add boshu2/agentops --skill quickstart

Documentation

SKILL.md

npx skills add ...

Documentation

SKILL.md

Show AgentOps next action.

This skill's source file could not be loaded. The install command may not work.

npx skills add boshu2/agentops --skill quickstart

Documentation

SKILL.md

/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"
[ -d "$HOME/.agents" ] && echo "GLOBAL_AGENTS=true" || echo "GLOBAL_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, 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.

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 && 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 && bd init --prefix <prefix>`"
BD=true + CODEX=true	"✅ Codex full stack ready.\n `ao reconcile --json` — check git, CI, release, beads, and .agents agree\n `bd ready` — see open work after high-severity reconciliation findings are clear\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 `ao reconcile --json` — check git, CI, release, beads, and .agents agree\n `bd ready` — see open work after high-severity reconciliation findings are clear\n `/rpi \"your goal\"` — start a new goal from scratch\n `/status` — see current session state"

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 ao reconcile --json, bd ready, or /rpi "your goal".

Troubleshooting

Problem	Solution
Skills not installed	`bash <(curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install.sh)`
Hook activation	AgentOps 3.0 is hookless — there is no `ao` command or flag that installs hooks, and CI is the authoritative gate. Hooks are opt-in and author-it-yourself via the `hooks-authoring` skill.
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/quickstart.feature [blocked] — Executable spec: detect setup (git/ao/bd/.agents), recommend a state-appropriate next action (soc-qk4b)
references/getting-started.md [blocked]
references/troubleshooting.md [blocked]
references/full-catalog.md [blocked]

Documentation

SKILL.md

Show AgentOps next action.

This skill's source file could not be loaded. The install command may not work.

npx skills add boshu2/agentops --skill quickstart

Documentation

SKILL.md

/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"
[ -d "$HOME/.agents" ] && echo "GLOBAL_AGENTS=true" || echo "GLOBAL_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, 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.

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 && 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 && bd init --prefix <prefix>`"
BD=true + CODEX=true	"✅ Codex full stack ready.\n `ao reconcile --json` — check git, CI, release, beads, and .agents agree\n `bd ready` — see open work after high-severity reconciliation findings are clear\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 `ao reconcile --json` — check git, CI, release, beads, and .agents agree\n `bd ready` — see open work after high-severity reconciliation findings are clear\n `/rpi \"your goal\"` — start a new goal from scratch\n `/status` — see current session state"

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 ao reconcile --json, bd ready, or /rpi "your goal".

Troubleshooting

Problem	Solution
Skills not installed	`bash <(curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install.sh)`
Hook activation	AgentOps 3.0 is hookless — there is no `ao` command or flag that installs hooks, and CI is the authoritative gate. Hooks are opt-in and author-it-yourself via the `hooks-authoring` skill.
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/quickstart.feature [blocked] — Executable spec: detect setup (git/ao/bd/.agents), recommend a state-appropriate next action (soc-qk4b)
references/getting-started.md [blocked]
references/troubleshooting.md [blocked]
references/full-catalog.md [blocked]

quickstart

Documentation

Documentation

quickstart

Documentation

/quickstart

Execution Steps

Step 1: Detect setup

Step 2: Show what AgentOps does

Step 3: One next action

Examples

First-Time Setup

Already Set Up

Troubleshooting

Reference Documents

See Also

Documentation

Documentation

/quickstart

Execution Steps

Step 1: Detect setup

Step 2: Show what AgentOps does

Step 3: One next action

Examples

First-Time Setup

Already Set Up

Troubleshooting

Reference Documents

See Also