add-source

# add-source (v1) Adding an agent CLI is **not a single-file change** — it spans `pixtuoid-core` (decoder + registry + tests), the `pixtuoid` binary (runtime wiring + install target + badge hue), and the site manifest. Several steps have **test teeth** that only `just preflight`'s FULL run catches, not the targeted source/install suites — so an agent that stops at "it compiles" ships a red PR. ## When to use - "Add support for <CLI>" / "integrate <agent tool>" / "add a source for X". - A new transcript-bearing OR hook-only coding CLI should show up as sprites. ## The authoritative checklist The complete, current step list lives in **[`crates/pixtuoid-core/CLAUDE.md`](../../../crates/pixtuoid-core/CLAUDE.md)** ("multi-source decoding" / "Adding a new agent CLI") — read it first; it is the source of truth and stays current. The Copilot-format summary is [`.github/prompts/add-source.prompt.md`](../../../.github/prompts/add-source.prompt.md). Before you start, decide **transcript-bearing vs hook-only** (invariant #3): a hook-only CLI (Reasonix/CodeWhale/opencode/Cursor) sets `transcript: None`, skips the runtime wiring + `Source` impl, and ships a `hook.custom` decoder + an `install/` target instead. ## The test-teeth steps agents miss These are the ones with a failing test attached — do NOT stop before them: - **`site/src/sources.json` row** — a manifest bridge test fails until it exists; then `just gen-readme` to sync the README. - **Per-source badge hue** — a `Theme:...