Claude Code Pilot

Universal Claude Code configuration for any project. One-command install, auto-setup wizard, 117 commands, 61 agents, 112 skills.

Install

cd your-project
npx claude-code-pilot
claude
> /ccp:setup

The /ccp:setup wizard scans your codebase, generates a tailored CLAUDE.md, detects your language, and activates the matching rule set.

The Workflow

npx claude-code-pilot              <- install (once)
claude -> /ccp:setup               <- wizard scans codebase, generates CLAUDE.md

# Development
/ccp:discuss-phase 1               <- capture requirements
/ccp:plan-phase 1                  <- atomic plans
/ccp:checkpoint create "before"    <- snapshot
/ccp:execute-phase 1               <- build with fresh contexts
/ccp:verify                        <- build, types, lint, tests, security
/ccp:verify-work 1                 <- does it match the spec?
/ccp:save-session                  <- persist for next session
/ccp:learn                         <- extract reusable patterns

# Next session
/ccp:resume-session                <- load previous context
/ccp:evolve                        <- promote instincts to skills
/ccp:update                        <- update everything

What's Included (~594 files after install)

| Category | Count | Description | |----------|-------|-------------| | /ccp: commands | 117 | Development lifecycle, quality gates, session management, learning | | Agents | 61 | Planning, execution, review, testing, security, documentation | | Skill packs | 112 | Continuous learning, verification, strategic compaction, and more | | Hooks | 16 | 15 event + 1 statusLine: safety guards, context management, notifications, session persistence | | Common rules | 10 | Always active (coding style, security, testing, performance, etc.) | | Chinese language rules | 11 | Always active (zh/ translations of common rules) | | Language-specific rule sets | 13 | Activated by /ccp:setup (see Language Rules below) | | Context modes | 3 | dev, research, review | | Reference examples | 6 | CLAUDE.md examples for different project types |

Command Highlights

| Command | What | |---------|------| | /ccp:setup | Wizard: scan codebase, generate CLAUDE.md, activate language rules | | /ccp:discuss-phase N | Capture requirements for a development phase | | /ccp:plan-phase N | Create atomic plans (max 3 tasks per subagent) | | /ccp:execute-phase N | Build in fresh 200k contexts, preventing context rot | | /ccp:verify | 6-phase quality check: build, types, lint, tests, security, diff | | /ccp:checkpoint | Git-backed snapshots with before/after comparison | | /ccp:save-session | Persist what worked, what didn't, exact next step | | /ccp:resume-session | Load previous session context | | /ccp:learn | Extract reusable patterns from session | | /ccp:evolve | Promote learned instincts into skills, commands, or agents |

Run /ccp:help for the full list of all 117 commands.

Hooks (16 total)

15 event hooks and 1 statusLine, all registered automatically during install.

| Hook | Event | Description | |------|-------|-------------| | Command blocker | PreToolUse:Bash | Blocks dangerous commands (rm -rf, DROP TABLE, push --force) | | File protection | PreToolUse:Write/Edit | Protects .env, lock files, and other sensitive files | | Context monitor | PostToolUse | Tracks context window usage | | Update check | SessionStart | Checks npm for new CCP versions | | Session loader | SessionStart | Loads previous session context | | Session saver | Stop | Persists session state on exit | | Pre-compact save | PreCompact | Saves context before compaction | | Strategic compact | PreToolUse:Edit/Write | Manages context strategically | | Task completed | Stop | Desktop notification on task completion | | Idle prompt | Notification | Desktop alert when idle | | Permission needed | Notification | Desktop alert when permission required | | Auto-format | PostToolUse:Write/Edit | Formats code after writes | | Agent shield | PreToolUse | Agent safety guardrails | | Quality gate | Stop | Final quality verification | | Statusline | Always | Shows project status in Claude Code status bar |

Language Rules

10 common rules are always active. 11 language-specific rule sets are available in available-rules/ and activated by the /ccp:setup wizard when it detects your project language.

Available language rule sets: TypeScript, Python, Go, Swift, Kotlin, PHP, Perl, Java, C++, C#, Rust, Dart, Web.

Self-Updating

On every session start, CCP checks npm for new versions. When available, the agent sees a notification prompting an update.

# From Claude Code:
/ccp:update

# From terminal:
npx claude-code-pilot@latest --update

Updates preserve your CLAUDE.md, architecture docs, and settings customizations.

CLI

npx claude-code-pilot [options]

  -l, --local       Install to .claude/ (default)
  -g, --global      Install to ~/.claude/
  -u, --update      Update existing installation
  --uninstall       Remove kit files (preserves CLAUDE.md)
  -h, --help        Show help

Credits

Built on the shoulders of:

• GSD by TACHES (MIT) -- spec-driven development methodology
• ECC by Affaan Mustafa (MIT) -- session persistence and learning toolbox
• find-skills by Vercel Labs -- skill discovery
• Context7 by Upstash -- documentation context