pi-loadout

Interactive tool and skill loadouts for Pi sessions.

pi-loadout adds one user-facing command, /loadout, for choosing which tools and skills are active in the current Pi session. Tools and skills are grouped by source extension/package, and group rows can toggle or collapse every item from that source.

All tools and skills are enabled by default. Saved selections persist in the current session branch.

Install

pi install npm:pi-loadout

Usage

/loadout
/loadout --yes

Controls:

• Tab — switch between tool loadout and skill loadout
• Space — toggle selected group, tool, or skill
• Enter — collapse/expand selected group; when on an item, collapse its parent group
• Ctrl+S — save and apply loadout
• ↑ / ↓ — navigate
• J / K — navigate down / up
• Esc — cancel without saving

Use --yes or -y to skip prompt-cache confirmation after reviewing the diff.

Behavior

• Group rows show ● enabled when all items in that group are enabled.
• Group rows show ◐ partial when some items in that group are enabled.
• Group rows show ○ disabled when no items in that group are enabled.
• Toggling a group enables/disables all tools or skills from that extension/package.
• Toggling a tool or skill affects only that item.
• Collapsing a group hides its item rows without changing enabled state.
• Saving shows a concise diff before applying changes.
• Tool/skill changes warn that the next LLM call may miss prompt cache because tool definitions or available skills changed.
• Applied changes are logged as visible session messages for resume/export reproducibility.
• Tool loadouts call Pi's active-tool API immediately after save.
• Skill loadouts filter the skills shown to the model in future turns; explicit /skill:name commands remain available.