Fitout — Development skill for Claude Code

Fitout

[](https://github.com/technicalpickles/fitout/actions/workflows/ci.yml)

Context-aware plugin manager for Claude Code.

The Problem

Managing Claude Code plugins across projects is painful:

• Config files look correct but don't reflect what's actually installed
• This mismatch leads to broken sessions and missing capabilities
• Manually syncing plugins across projects is tedious and error-prone

The Solution

Fitout ensures your actual runtime state matches your declared configuration.

1. Declare desired plugins in .claude/fitout.toml
2. Run fitout status to see the diff
3. Run fitout install to sync

Installation

# Install globally
npm install -g fitout

# Set up Claude integration
fitout init

This adds a SessionStart hook to Claude Code that automatically installs missing plugins when you start a session.

Non-interactive setup

fitout init --yes        # Use defaults (creates default profile)
fitout init --hook-only  # Only add hook, no profile

Requires [Claude Code CLI](https://claude.ai/docs/claude-code) to be installed.

Quick Start

Create `.claude/fitout.toml` in your project:

plugins = [
  "superpowers@superpowers-marketplace",
  "ci-cd-tools@pickled-claude-plugins",
]

Check status:

fitout status

Output:

Context: /path/to/project

✗ superpowers@superpowers-marketplace (missing)
✗ ci-cd-tools@pickled-claude-plugins (missing)

0 present, 2 missing

Install missing plugins:

fitout install

Commands

`fitout status`

Shows the diff between desired and installed plugins.

• ✓ - Plugin is installed
• ✗ - Plugin is missing
• ? - Plugin is installed but not in config

Exit code is `1` if any plugins are missing, `0` otherwise.

`fitout install`

Installs missing plugins to sync with config.

fitout install           # Install missing plugins
fitout