Claude CLI Advanced Starter Pack (CCASP)

╔═══════════════════════════════════════════════════════════════════════════════╗
║                                                                               ║
║   ╔═╗╦  ╔═╗╦ ╦╔╦╗╔═╗  ╔═╗╔╦╗╦  ╦╔═╗╔╗╔╔═╗╔═╗╔╦╗  ╔═╗╔╦╗╔═╗╦═╗╔╦╗╔═╗╦═╗       ║
║   ║  ║  ╠═╣║ ║ ║║║╣   ╠═╣ ║║╚╗╔╝╠═╣║║║║  ║╣  ║║  ╚═╗ ║ ╠═╣╠╦╝ ║ ║╣ ╠╦╝       ║
║   ╚═╝╩═╝╩ ╩╚═╝═╩╝╚═╝  ╩ ╩═╩╝ ╚╝ ╩ ╩╝╚╝╚═╝╚═╝═╩╝  ╚═╝ ╩ ╩ ╩╩╚═ ╩ ╚═╝╩╚═       ║
║                                                                               ║
║                          v2.2.19  •  Production Ready                         ║
║                                                                               ║
╚═══════════════════════════════════════════════════════════════════════════════╝

npx claude-cli-advanced-starter-pack init

Feb 2026 — CCASP now includes a full Neovim plugin with multi-session Claude CLI terminals, collapsible sidebar, and zero-setup launcher. Transform your terminal into an AI command center.

🆕 Neovim Integration (nvim-ccasp)

Features:

• 🚀 Zero Setup: ccasp neovim launches instantly (auto-installs Neovim if needed)
• 🎨 8 Session Colors: Blue, Green, Purple, Orange, Red, Cyan, Pink, Yellow
• ⌨️ Auto-Insert Mode: Click session → instantly start typing
• 📁 Collapsible Sidebar: Mouse-clickable sections, collapsed by default
• 🔌 Prompt Injector: Intercept prompts, optionally enhance with GPT-5.2

Quick Start:

# Zero-setup launch (auto-installs Neovim if missing)
ccasp neovim

# Permanent installation
ccasp nvim-setup

What's New

<!-- CCASP-META
source: /phase-dev-plan
slug: auth-system
progress_file: .claude/docs/auth-system/PROGRESS.json
-->

Upgrade Now

# Update to v2.2.18
npm update -g claude-cli-advanced-starter-pack

# Sync all new features to your project
ccasp init

The Problem

Every new project means:

• ❌ Manually creating .claude/ folders and configurations
• ❌ Copy-pasting commands, hooks, and agents from old projects
• ❌ Forgetting critical settings and enforcement hooks
• ❌ Agents that don't understand your tech stack
• ❌ Hours of setup before you can actually build

The Solution

One command. Fully configured. Stack-aware.

npx claude-cli-advanced-starter-pack init

CCASP scans your project, detects your stack (React? FastAPI? Prisma? Playwright?), and deploys a complete .claude/ folder with:

• ✅ 56 slash commands — deployment, testing, refactoring, GitHub sync
• ✅ 42 enforcement hooks — validation, progress tracking, agent orchestration
• ✅ Stack-specific agents — specialists that know your frameworks
• ✅ Smart updates — add features without losing customizations

What You Get

AI Constitution Framework

Enforce project-specific coding standards and architecture patterns with automatic validation.

Quick Start

ccasp constitution-init --preset senior    # 5% sampling, all sections
ccasp constitution-init --preset minimal   # 2% sampling, security only
ccasp constitution-init --preset strict    # 15% sampling, maximum coverage

Features

• YAML-based rules at .claude/config/constitution.yaml
• Hook enforcement with configurable sampling (1-in-20 default)
• Sensitive pattern bypass - security rules always checked
• Stop → Explain → Suggest → Refactor violation flow
• Neovim integration - edit constitution from sidebar

Rule Sections

See /ai-constitution-framework in Claude Code for full documentation.

See It In Action

📸 Screenshots Gallery (click to expand/collapse)

Desktop UI

/menu — Interactive Navigation Full-featured menu with all options

Project Configuration Settings GitHub, deployment, tunnels, tokens

Mobile UI (Happy.engineering)

/menu — Mobile Navigation Single-key navigation, 40-char width	Setup Wizard — Feature Selection Choose commands, agents, hooks, skills
GitHub Project Setup One-click repo and Project Board sync	/claude-audit — Analysis Report CLAUDE.md analysis with score
Audit Score Breakdown Detailed scoring and summary	Actionable Recommendations Priority-ordered improvements

Highlight Features

/ralph --watch

/create-roadmap "Q1 Feature Sprint"

/deploy-full

/phase-dev-plan "Add user authentication"

/pr-merge

/create-github-epic "Auth System"

ccasp vision init "Build a kanban board with real-time collaboration"

# Initialize and run
ccasp vision init "Your app idea here"
ccasp vision run my-app

# Monitor with web dashboard
ccasp vision dashboard

# Or use slash commands
/vision-init
/vision-status
/vision-run

Architecture

After running ccasp init, your project gets:

.claude/
├── commands/              # 56 slash commands
│   ├── menu.md           # Interactive navigation
│   ├── deploy-full.md    # Full-stack deployment
│   ├── ralph.md          # Test-fix loops
│   └── ...
├── agents/                # Stack-specific AI agents
│   ├── react-specialist.md
│   ├── fastapi-specialist.md
│   └── ...
├── hooks/                 # 42 enforcement hooks
│   ├── ralph-loop-enforcer.js
│   ├── progress-tracker.js
│   └── ...
├── skills/                # RAG-enhanced packages
├── config/
│   └── tech-stack.json    # Your detected stack
└── settings.json          # Project configuration

Everything is customized to your package.json, config files, and directory structure.

Quick Start

# Step 1: Install
npm install -g claude-cli-advanced-starter-pack

# Step 2: Initialize (detects your stack, deploys .claude/)
ccasp init

# Step 3: Restart Claude Code CLI (required for new commands)
claude .

# Step 4: Use slash commands
/menu

One-Time Use (No Install)

npx claude-cli-advanced-starter-pack init

Roadmap

🚀 Coming Soon

Version History

v2.2.19

Neovim Integration (nvim-ccasp) — Feb 2026

• Zero-Setup Launcher: ccasp neovim launches Neovim with CCASP pre-loaded
• Auto-Install Neovim: Detects winget/choco/scoop (Windows), brew (macOS), apt/dnf/pacman (Linux)
• Multi-Session Terminals: Up to 8 Claude CLI sessions with automatic quadrant stacking
• Color-Coded Titlebars: 8 colors (Blue, Green, Purple, Orange, Red, Cyan, Pink, Yellow) with rename/minimize/close
• Auto-Insert Mode: Click on session to start typing immediately
• Collapsible Sidebar: Mouse-clickable sections, all collapsed by default
• Prompt Injector v1.1.0: Intercept prompts, optionally enhance with GPT-5.2
• npm Package Integration: nvim-ccasp/ included in npm distribution
• Permanent Installation: ccasp nvim-setup with symlink/copy options

v2.2.18

Critical Commands & Self-Healing Updates — Feb 2026

• Critical Commands: update-check and __ccasp-sync-marker now ALWAYS update during ccasp init
• Self-Healing Updates: /update-check can now update itself, fixing the bootstrap problem
• Auto-Upgrade Detection: Missing sync marker triggers automatic ccasp init for full 11-category sync
• Backwards Compatibility: Older projects automatically upgraded to new sync system

v2.2.17

Auto-Run Init on Outdated Projects — Feb 2026

• Automatic Upgrade: /update-check now runs ccasp init when sync marker missing
• Zero-Touch Migration: Users don't need to know about the upgrade — it just works

v2.2.16

Sync Marker System — Feb 2026

• New File: __ccasp-sync-marker.md detects if project has full 11-category sync
• Version Detection: Marker indicates v2.2.16+ capabilities
• Upgrade Path: Clear messaging when older versions detected

v2.2.15

Hook File Extension Support — Feb 2026

• .cjs Support: Hooks now support .cjs extension for CommonJS compatibility
• github-progress-hook.cjs: New hook registered for TodoWrite matcher
• Settings Registration: Automatic hook registration during init

v2.2.14

Full Template Category Sync — Feb 2026

• 11 Categories: /update-check now scans ALL template directories
• New Categories: commands-dev, scripts, github/ISSUE_TEMPLATE, workflows, mcp
• Complete Coverage: No more missing files after updates

v2.2.13

Simplified Update Check — Feb 2026

• Comprehensive Sync: /update-check redesigned for complete file synchronization
• Hash Comparison: Detects customized files and skips them automatically
• Smart Merge: Preserves user modifications while adding new features

v2.2.12

Enhanced Issue Templates with Hook-Based Sync — Feb 2026

• Type-Specific Templates: 4 templates (Feature, Refactor, Bug, Testing)
• CCASP-META: Machine-parseable HTML comments for agent updates
• Generated Files Section: All issues link to source documentation
• Hook Infrastructure: PostToolUse hook detects PROGRESS.json changes
• L3 Sync Worker: Background agent updates GitHub issues automatically
• 5-Phase Implementation: Complete architecture from templates to testing

v2.2.11

Consolidated Roadmap Architecture — Feb 2026

• Unified Architecture: Task/Phase/Roadmap share same exploration file structure
• Tunnel URL Support: Development tunnel URLs integrated into deployment workflow
• Consistent Planning: All three scales generate 6-file exploration documents

v2.2.10

Menu Display Fix — Feb 2026

• ASCII Box Menu: Clean display with consistent formatting
• Display Instructions: Better guidance in /menu command

v2.2.9

Mandatory L2 Exploration Files — Feb 2026

• Enforcement: L2 specialists MUST create exploration files before implementation
• 6-File Standard: EXPLORATION_SUMMARY, CODE_SNIPPETS, REFERENCE_FILES, AGENT_DELEGATION, PHASE_BREAKDOWN, findings.json
• Quality Gates: Slash commands validate exploration docs exist

v2.2.8

Graduated Task/Phase/Roadmap Architecture — Feb 2026

• Three Planning Scales: Tasks, Phases, and Roadmaps with unified structure
• L2 Exploration System: Specialists receive full context through generated docs
• Fast Dev-Sync: Quick synchronization for development workflows
• Worktree Integration: Improved dev mode with git worktree support

v2.2.5

Dev Mode Smart Sync & Wizard UX — Feb 2026

• Smart Sync for Dev Mode: New smart-sync.js utility preserves user customizations when syncing from worktree
• Menu Worktree Sync: [W] Sync from Worktree option appears during dev mode with sync status banner
• /dev-mode-deploy-to-projects: New slash command with --dry-run, --force, --project options
• /menu-happy: Dedicated mobile menu command (40-char width) — auto-detection removed from /menu
• Wizard UX Improvements: Reinstall option, accurate template counts, better mismatch handling (#64)
• Hook Migration: Hooks migrated from .js to .cjs for CommonJS compatibility

v2.2.4

E2E Testing Integration & Happy Mode Fix — Feb 2025

• Comprehensive E2E Testing Integration: Deep Playwright integration with credential injection, tunnel services, and Ralph Loop configuration
• Happy Mode Detection Fix: BREAKING - HAPPY_SERVER_URL alone no longer triggers mobile mode; requires active session indicators
• GitHub Integration Improvements: Enhanced error handling, cleaner issue parsing, refined MCP handling
• Screenshot Gallery: Added 6 screenshots showcasing desktop and mobile UI
• Developer Guides: New wiki sections for forking, local development, contributing, and npm updates

v2.2.3

Security & Packaging — Feb 2025

• Removed hardcoded paths from npm package
• Improved template portability

v2.2.0

Vision Driver Bot & GitHub Epics — Jan 2025

• Vision Driver Bot (VDB): Autonomous development with lint fixes
• GitHub Epic System: Multi-issue epic workflows with /create-github-epic
• Init for New Projects: /init-ccasp-new-project for Happy users
• Modular Commands: 7 large files refactored for maintainability

Full v2.2.0 Release Notes →

View All Releases →

Top Features

Vision Mode Orchestration (NEW in v2.3.0)

Autonomous MVP development from natural language:

/vision-init "Build a task management app with drag-and-drop"

Vision Mode is an L0+ orchestration layer above Epics, enabling:

• Natural Language → MVP: Describe your product, Claude builds it autonomously
• 8-Phase Architecture: Schema → Analysis → Architecture → Observer → Agent Factory → Security → Autonomous Execution → Integration
• Drift Detection: Observer hook monitors PROGRESS.json and ROADMAP.json for alignment
• Self-Healing: Autonomous loop retries failed tasks with intelligent fixes

Vision Hierarchy:
VISION (L0+) ← Natural language prompt
├── EPIC (L0) ← Generated epic with milestones
│   ├── ROADMAP (L1) ← Multi-phase roadmap
│   │   └── PHASE-DEV (L2) ← Individual phases
│   │       └── TASKS (L3) ← Atomic work units

Commands:

• /vision-init — Initialize from prompt
• /vision-status — View progress and alignment
• /vision-adjust — Adjust when drift detected

Vision Driver Bot (VDB) (Actively Being Developed)

Autonomous development workflows with automatic lint fixes:

VDB State (.claude/vdb/state.json)
├── Current task tracking
├── Lint error queue
├── Fix history
└── Session metrics

Workflow: Detect lint errors → Queue fixes → Apply → Verify

GitHub Epic System (Actively Being Developed)

Multi-issue epic workflows:

/create-github-epic "User Authentication System"

• Creates parent epic issue
• Links child issues automatically
• Tracks completion across issues
• Syncs with Project Board

Agent Orchestration

Hierarchical agent execution:

L1 Orchestrator (You / Main Conversation)
├── L2 Frontend Specialist (Sonnet)
│   ├── L3 Component Search Worker (Haiku)
│   └── L3 Style Analyzer Worker (Haiku)
├── L2 Backend Specialist (Sonnet)
│   └── L3 API Discovery Worker (Haiku)
├── L2 Testing Specialist (Sonnet)
└── L2 Deployment Specialist (Sonnet)

Refactoring System

# Continuous test-fix until green
/ralph --watch

# Characterization tests before refactoring
/golden-master src/utils/calculate.ts

# Guided 8-step refactoring workflow
/refactor-workflow

Neovim Plugin (nvim-ccasp) (Production Ready)

Zero-Setup Launch:

ccasp neovim              # Launch with CCASP pre-loaded
ccasp neovim /path/to/dir # Launch in specific directory
ccasp nvim-setup          # Install permanently to Neovim config

Features:

• Multi-Session Terminals: Up to 8 Claude CLI sessions with quadrant stacking
• Color-Coded Titlebars: 8 colors with rename, minimize, close buttons
• Auto-Insert Mode: Click session to start typing immediately
• Collapsible Sidebar: Mouse-clickable sections, all collapsed by default
• Control Panel: Toggle features, change models, restart agents
• Prompt Injector: Intercept and enhance prompts with GPT-5.2
• Telescope Integration: Browse commands, skills, hooks with fuzzy finding
• Statusline: Token usage, agent status, version info

Keybindings:

lazy.nvim Config:

{
  dir = "path/to/nvim-ccasp",  -- Auto-generated by ccasp neovim
  config = function()
    require("ccasp").setup({
      layout = "classic",
      sidebar = { width = 40, auto_open = true },
      terminal = { shell = "claude", size = 60 },
    })
  end,
}

Auto-installs Neovim on first run (winget/brew/apt detected automatically).

Happy.engineering Mobile UI

Auto-detected. Mobile-optimized formatting:

┌────────────────────────────────────┐
│ [1] Issue #42                      │
│ Add JWT authentication             │
├────────────────────────────────────┤
│ Status: Ready                      │
│ Priority: High                     │
│ @johndoe • 2h ago                  │
└────────────────────────────────────┘

PR Merge Workflow

/pr-merge        # Current branch
/pr-merge 123    # Specific PR
/pr-merge --dry-run

9 phases: Identify → Checkpoint → Detect blockers → Resolve → Message → Merge method → Execute → Cleanup → Summary

Roadmap Orchestration

ccasp create-roadmap          # Mode A: Natural language → phases
ccasp roadmap import          # Mode B: GitHub issues → phases

/roadmap-status               # Progress dashboard
/roadmap-edit                 # Reorder, merge, split phases
/roadmap-track                # Execute with dependency checking

Commands Reference

Terminal Commands (No AI)

Slash Commands (AI-Powered)

Full Commands Reference →

Hook Templates (42)

Tech Stack Detection

Detects 55+ frameworks by reading project files (no AI):

MCP Server Integration

ccasp explore-mcp              # Interactive menu
ccasp explore-mcp --recommend  # Auto-recommend for your stack

Contributing

git clone https://github.com/evan043/claude-cli-advanced-starter-pack.git
cd claude-cli-advanced-starter-pack
npm install
npm run lint
npm test

Contributing Guidelines →

License

MIT © evan043