What ai-devkit Gives You

• One-shot workbench bootstrap — init.wb creates a private workbench repo from the ai-workbench template, wires CODEOWNERS, registers code repos, renders manifests.
• Collaborator onboarding — join.wb <url> clones the workbench, appends the joiner to CODEOWNERS, registers any extra repos they bring.
• Template refresh — update.wb pulls template-owned skill / config updates without touching your authored outputs.
• Org list management — orgs.wb (list/add/remove/show) keeps a machine-local GitHub org list. The org hosting your devkit checkout is auto-included.
• Preflight hygiene — both init.wb and join.wb verify required CLIs, confirm the active gh account, and offer switch / login flows before touching remote resources.
• Per-repo domain context — init.wb / join.wb auto-build a context/<name>/CONTEXT.md for every registered source repo, plus an aggregate context/README.md. Recover failed scans with wb.rescan. See Repo Context Scan.
• ai-ralph bootstrap — on first run per machine, devkit clones and installs ai-ralph, then scopes ralph-enable to the new workbench only (never into sibling service repos).

Three Repos, One Story

Repo	Role
ai-devkit	Global CLI. Provides init.wb, join.wb, update.wb, orgs.wb.
ai-workbench	Template. gh repo create --template stamps an instance per bundle.
ai-ralph	Autonomous AI loop (Claude Code, Devin, Codex). Enabled per workbench.

Quick Paths

• Install the CLI? Start at Getting started.
• Command reference? See Commands.
• Manage GitHub orgs? See Orgs.
• Stay current? See Versioning + upgrades for devkit.upgrade, ralph.upgrade, wb.upgrade, and devkit doctor.
• Curious about the auto-built context/ dir? See Repo Context Scan for the scan model, frontmatter schema, and wb.rescan recovery.

Typical Flow

install.zsh          → registers init.wb / join.wb / update.wb / orgs.wb globally
init.wb              → preflight → create wb-<label> repo → clone code repos → render manifests → ralph-enable
join.wb <url>        → preflight → clone workbench → add joiner to CODEOWNERS → register extra repos
update.wb            → pull template-owned updates into existing workbench
orgs.wb add <slug>   → expand machine-local GitHub org menu

License

See repo license files.