{"id":43703204,"url":"https://github.com/technicalpickles/fitout","last_synced_at":"2026-02-14T00:24:50.530Z","repository":{"id":336106055,"uuid":"1146270478","full_name":"technicalpickles/fitout","owner":"technicalpickles","description":"Context-aware plugin manager for Claude Code","archived":false,"fork":false,"pushed_at":"2026-02-02T20:30:17.000Z","size":299,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-03T10:31:11.326Z","etag":null,"topics":["claude","claude-code","cli","npm","plugins"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/technicalpickles.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-30T21:07:13.000Z","updated_at":"2026-02-02T20:30:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/technicalpickles/fitout","commit_stats":null,"previous_names":["technicalpickles/fitout"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/technicalpickles/fitout","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technicalpickles%2Ffitout","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technicalpickles%2Ffitout/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technicalpickles%2Ffitout/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technicalpickles%2Ffitout/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/technicalpickles","download_url":"https://codeload.github.com/technicalpickles/fitout/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technicalpickles%2Ffitout/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29113202,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T03:44:17.043Z","status":"ssl_error","status_checked_at":"2026-02-05T03:44:12.077Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude","claude-code","cli","npm","plugins"],"created_at":"2026-02-05T05:10:58.636Z","updated_at":"2026-02-05T05:10:58.690Z","avatar_url":"https://github.com/technicalpickles.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fitout\n\n[![CI](https://github.com/technicalpickles/fitout/actions/workflows/ci.yml/badge.svg)](https://github.com/technicalpickles/fitout/actions/workflows/ci.yml)\n\nContext-aware plugin manager for Claude Code.\n\n## The Problem\n\nManaging Claude Code plugins across projects is painful:\n- Config files *look* correct but don't reflect what's actually installed\n- This mismatch leads to broken sessions and missing capabilities\n- Manually syncing plugins across projects is tedious and error-prone\n\n## The Solution\n\nFitout ensures your actual runtime state matches your declared configuration.\n\n1. Declare desired plugins in `.claude/fitout.toml`\n2. Run `fitout status` to see the diff\n3. Run `fitout install` to sync\n\n## Installation\n\n```bash\n# Install globally\nnpm install -g fitout\n\n# Set up Claude integration\nfitout init\n```\n\nThis adds a SessionStart hook to Claude Code that automatically installs missing plugins when you start a session.\n\n### Non-interactive setup\n\n```bash\nfitout init --yes        # Use defaults (creates default profile)\nfitout init --hook-only  # Only add hook, no profile\n```\n\nRequires [Claude Code CLI](https://claude.ai/docs/claude-code) to be installed.\n\n## Quick Start\n\nCreate `.claude/fitout.toml` in your project:\n\n```toml\nplugins = [\n  \"superpowers@superpowers-marketplace\",\n  \"ci-cd-tools@pickled-claude-plugins\",\n]\n```\n\nCheck status:\n\n```bash\nfitout status\n```\n\nOutput:\n\n```\nContext: /path/to/project\n\n✗ superpowers@superpowers-marketplace (missing)\n✗ ci-cd-tools@pickled-claude-plugins (missing)\n\n0 present, 2 missing\n```\n\nInstall missing plugins:\n\n```bash\nfitout install\n```\n\n## Commands\n\n### `fitout status`\n\nShows the diff between desired and installed plugins.\n\n- `✓` - Plugin is installed\n- `✗` - Plugin is missing\n- `?` - Plugin is installed but not in config\n\nExit code is `1` if any plugins are missing, `0` otherwise.\n\n### `fitout install`\n\nInstalls missing plugins to sync with config.\n\n```bash\nfitout install           # Install missing plugins\nfitout install --dry-run # Preview what would be installed\n```\n\n## Profiles\n\nShare plugin sets across projects using profiles.\n\n### User Profiles\n\nCreate profiles at `~/.config/fitout/profiles/`:\n\n```toml\n# ~/.config/fitout/profiles/default.toml\n# Auto-included in every project (silent if missing)\nplugins = [\n  \"superpowers@superpowers-marketplace\",\n]\n```\n\n```toml\n# ~/.config/fitout/profiles/backend.toml\nplugins = [\n  \"database-tools@some-registry\",\n  \"api-helpers@some-registry\",\n]\n```\n\n### Using Profiles\n\nReference profiles in your project config:\n\n```toml\n# .claude/fitout.toml\nprofiles = [\"backend\"]\nplugins = [\n  \"project-specific@registry\",\n]\n```\n\nPlugins merge additively. The `default` profile auto-includes if present.\n\n### Provenance\n\nStatus output shows where each plugin comes from:\n\n```\nContext: /path/to/project\n\n✓ superpowers@superpowers-marketplace (from: default)\n✓ database-tools@some-registry (from: backend)\n✓ project-specific@registry\n\n3 present\n```\n\n## Configuration Reference\n\n### Project Config (`.claude/fitout.toml`)\n\n```toml\n# Optional: explicit profiles to include\nprofiles = [\"backend\", \"testing\"]\n\n# Required: plugins for this project\nplugins = [\n  \"plugin-name@registry\",\n]\n```\n\n### Profile Config (`~/.config/fitout/profiles/\u003cname\u003e.toml`)\n\n```toml\n# Plugins provided by this profile\nplugins = [\n  \"plugin-name@registry\",\n]\n```\n\n## Development\n\n```bash\nnpm install          # Install dependencies\nnpm test             # Run tests\nnpm run dev -- status # Run in dev mode\nnpm run build        # Build to dist/\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechnicalpickles%2Ffitout","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechnicalpickles%2Ffitout","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechnicalpickles%2Ffitout/lists"}