pi-ext-fan

pi-coding-agent extension: @agent interception + family-bucket companion installer.

Features

1. @agent syntax interception + autocomplete

Type @<agent-name> <task> in the input box to dispatch to a sub-agent:

• @workhorse "write the tests" → transforms into /run workhorse "write the tests"
• Autocomplete for agent names on @ (from built-in + ~/.pi/agent/agents + ~/.agents)
• Toggle with /ext on / /ext off (bare /ext toggles)

2. Family-bucket installer (/ext all / /ext setup)

The family bucket covers 22 companions in 3 groups. Each entry is one of three action types:

• pi — installed via pi install <source> (tracked to latest)
• copy — agent .md files synced into ~/.pi/agent/agents (copied only when the target file does not already exist, so local customizations like a hand-tuned oldfox.md are never overwritten)
• check — probes a CLI (command -v …); when missing it only prints an install hint, it never runs an installer

aiwayds group (9, all pi)

| Key | Label | Source | | ----- | ------- | -------- | | sidebar | Sidebar Panel | npm:@aiwayds/pi-sidebar-panel | | footbar | Powerline Footer | npm:@aiwayds/pi-powerline-footer | | cron | Kimi Cron | npm:@aiwayds/pi-kimi-cron | | think-panel | Think Panel | npm:@aiwayds/pi-think-panel | | bailian | Bailian Token Plan | npm:@aiwayds/pi-bailian-token-plan | | jarvis | Jarvis Sphere | npm:@aiwayds/pi-jarvis-sphere | | model-favs | Model Favorites | npm:@aiwayds/pi-model-favorites | | topic-memory | Topic Memory | npm:@aiwayds/pi-topic-memory | | fun-agent | Fun Agent | npm:@aiwayds/pi-fun-agent |

rpiv group (9, all pi)

| Key | Label | Source | | ----- | ------- | -------- | | rpiv-pi | RPIV Pi | npm:@juicesharp/rpiv-pi | | rpiv-workflow | RPIV Workflow | npm:@juicesharp/rpiv-workflow | | rpiv-ask-user-question | RPIV Ask User Question | npm:@juicesharp/rpiv-ask-user-question | | rpiv-todo | RPIV Todo | npm:@juicesharp/rpiv-todo | | rpiv-advisor | RPIV Advisor | npm:@juicesharp/rpiv-advisor | | rpiv-i18n | RPIV i18n | npm:@juicesharp/rpiv-i18n | | rpiv-web-tools | RPIV Web Tools | npm:@juicesharp/rpiv-web-tools | | rpiv-args | RPIV Args | npm:@juicesharp/rpiv-args | | rpiv-btw | RPIV By The Way | npm:@juicesharp/rpiv-btw |

ecosystem group (4)

| Key | Label | Type | Detail | | ----- | ------- | ------ | -------- | | lean-ctx | lean-ctx (pi extension) | pi | npm:pi-lean-ctx | | lean-ctx-cli | lean-ctx CLI | check | probes command -v lean-ctx; hint: cargo install lean-ctx (or brew tap yvgude/lean-ctx && brew install lean-ctx) | | agents | Agents (auto-sync) | copy | syncs fun-agent's agents/*.md → ~/.pi/agent/agents/ (skip-if-exists) | | pi-subagents | Subagents | pi | npm:@tintinweb/pi-subagents |

/ext all runs the three phases in dependency order: all pi installs first, then the copy sync (depends on fun-agent's agents being on disk), then the check probes. The summary reports each group separately.

• /ext all — one-shot setup: installs every missing pi-type companion, re-syncs agents (idempotent, skips existing files), probes the CLI checks. No picker, no prompts.
• /ext setup — interactive checkbox picker (all selected by default, grouped): space toggles a row, a selects all/none, enter runs the checked ones, esc cancels.
• /ext setup <name> [<name>...] — run named companions directly.
• /ext status — at-agent state + companion install status, grouped by aiwayds / rpiv / ecosystem with per-line ✅/❌.

3. /think — cycle/set thinking level

/think cycles off → minimal → low → medium → high → xhigh → max; /think high sets a specific level.

4. Skill shortcuts

• /init → forwards to /skill:init (root AGENTS.md)
• /init-deep → forwards to /skill:init-deep (.architect shadow tree)

Install (fresh environment, three steps)

pi install npm:@aiwayds/pi-ext-fan

Then, inside the pi session:

/ext all    ← full setup: installs every missing companion, syncs agents, probes CLIs
/reload     ← activates the newly installed extensions

That's it — /ext all skips anything already installed, re-syncs agents without touching existing files, and only reports a hint for missing CLIs. It's idempotent and safe to re-run anytime a companion is missing or a new agent file should be picked up.

Prefer a manual pick? Use /ext setup (interactive checkbox list) or /ext setup <name> for a single package. Check what's present with /ext status.

License

MIT