claude-loadout

A Claude Code plugin for managing optional workflow loadouts in your repo.

Define shared-but-optional workflows (agents, commands, hooks, prompts) that live outside .claude/ and can be equipped on demand.

Install

claude /install /path/to/claude-loadout

Usage

/loadout list              — show all available loadouts
/loadout inspect <name>    — view loadout contents and metadata
/loadout equip <name>      — equip a loadout for the current session
/loadout unequip           — unequip the current loadout
/loadout status            — show what's currently equipped
/loadout doctor            — validate loadout integrity
/loadout create <name>     — create a new loadout

How It Works

• Loadouts are stored in .claude-loadouts/loadouts/<name>/ and versioned with your repo
• Each loadout has a loadout.yaml manifest describing its artifacts
• Equipping is always explicit — the plugin suggests but never auto-equips
• Branch pinning lets the plugin suggest relevant loadouts when you return to a branch

Core Principles

1. Explicit over implicit — never silently equip a loadout
2. Shared storage, optional activation — workflows are versioned but not active by default
3. Observable state — always know what's equipped and why
4. Keep .claude curated — loadouts prevent .claude from becoming a dumping ground