koan

Decompose a broad topic into linked GitHub issues with a master tracking issue

Fix a tracker issue end-to-end, or batch-queue all open GitHub issues from a repo

Queue a PR rebase mission (ex: /rebase https://github.com/owner/repo/pull/42). A bare rebase only rebases onto the base branch; add --fix to also apply review feedback.

Queue a review then rebase combo for a PR (ex: /rr https://github.com/owner/repo/pull/42)

Ask Kōan a question about a GitHub PR or issue — fetches context and posts an AI reply

Show resolved model config for the active CLI provider

Show Kōan status, missions, and run loop health

Handle natural-language GitHub requests — classify intent and dispatch to the right skill

Implement a tracker issue (GitHub or Jira)

Queue a code review mission (ex: /review https://github.com/owner/repo/pull/42)

Refresh or create CLAUDE.md for a project, or sync Kōan's learnings into it

Explain a PR's intent and changes in plain language (ex: /explain https://github.com/owner/repo/pull/42)

Add a project from a GitHub URL

Start a strategic sparring session

Daily digest — pending missions, recent completions, quota health, journal highlights

List missions by state

Analyze the last mission failure and queue a fix attempt

Show live progress from the current run

Audit a project codebase and create tracker issues for each finding

Run a spec-kit pipeline (specify -> plan -> tasks -> implement) for a goal or tracker issue, then best-effort review/CI and a draft PR

Consult, capture, and acquire knowledge in koan's OKF-conformant docs/ and specs/ bundles. Use for /brain ask <question> (alias: /brain search <question> — consult docs/ and specs/ before planning/research/refactor, index-first, with page citations), /brain sync (close the loop after implementing a feature — refresh frontmatter/description and regenerate indexes), /brain ingest <path|url|"idea sentence"> (capture external material as a durable, cited reference page), /brain lint (OKF conformance health check), /brain init (verify or repair the scaffold), /brain help (print the cheat sheet), and bare /brain with no arguments (prints the cheat sheet, then asks which action to take). Trigger on "what does the wiki say about X", "check the docs before we plan this", "update the wiki", "sync the docs", "ingest this article/file/idea", "save this as a reference doc", "lint the wiki", "check OKF conformance", or when finishing a feature and CLAUDE.md's documentation step is due.

Extract and generate structured documentation from a project codebase

Weekly/monthly PR activity report (per-project + global)

Triage and fix a production error from a pasted stack trace or log snippet

Audit docs/code alignment — find spec drift and queue fix missions

Deep-think an idea and create a tracker issue with a structured plan

Recover orphan branches by rebasing onto main and creating draft PRs

Resume spec-kit from a human-validated spec on a branch (skip specify, run plan -> tasks -> implement -> review -> CI -> PR)

Show or set bridge verbosity (debug / normal)

Rename a project across all configuration and instance files

Check LLM quota, override used %, or reset estimates

Review and update a GitHub pull request

Recreate a diverged PR from scratch (ex: /recreate https://github.com/owner/repo/pull/42)

Show GitHub CLI authentication status and connected user

Run security_audit, dead_code, and profile in parallel

Show current server date and time

Show session outcome statistics per project

Queue an AI exploration mission for a project

Toggle automatic review+rebase after PR creation per project

List koan branches and open PRs with recommended merge order and stats