by evan043
Enables a one‑command setup that configures Claude Code environments, auto‑generates stack‑aware agents, slash commands, enforcement hooks, and integrates MCP servers for any tech stack.
Provides a complete, stack‑customized Claude Code configuration delivered through a single npx command. It scaffolds the .claude/ directory with agents, commands, hooks, skills, and MCP server integrations, allowing developers to start building immediately without manual setup.
npm install -g claude-cli-advanced-starter-pack or run directly with npx.npx claude-cli-advanced-starter-pack init – detects the project's tech stack, creates .claude/ and installs all required components.claude . (or use the provided Neovim plugin via ccasp neovim)./menu, /deploy-full, /ralph, /vision-init, etc., to perform deployment, testing, roadmap creation, and autonomous MVP generation..claude/ generation based on detected stack (React, FastAPI, Prisma, Playwright, etc.).http://localhost:3848./deploy-full to push full‑stack applications to Railway, Cloudflare, Vercel, etc., with pre‑flight validation and rollback./ralph --watch runs tests, auto‑fixes failures, and retries until the suite passes.Q: Do I need to install the package globally?
A: No. The recommended usage is npx claude-cli-advanced-starter-pack init, which works without a global install.
Q: Can I run the tool on any operating system? A: Yes. It requires Node.js 18+ and works on Windows, macOS, and Linux.
Q: How does the Neovim integration work?
A: Run ccasp neovim to launch Neovim with the nvim-ccasp plugin pre‑loaded. The command also auto‑installs Neovim if it is missing.
Q: What if my project uses a technology that isn’t detected?
A: The stack detector supports 55+ frameworks. Unrecognized tech can be added manually by editing .claude/config/tech-stack.json.
Q: Is an Anthropic API key required?
A: Only when you use the MCP Registry integration or any Anthropic‑backed agents. Set ANTHROPIC_API_KEY in your environment.
Q: How are updates handled?
A: Running npm update -g claude-cli-advanced-starter-pack (or npx for the latest version) upgrades the CLI. Existing projects can be refreshed with ccasp init which syncs new templates and hooks.
╔═══════════════════════════════════════════════════════════════════════════════╗
║ ║
║ ╔═╗╦ ╔═╗╦ ╦╔╦╗╔═╗ ╔═╗╔╦╗╦ ╦╔═╗╔╗╔╔═╗╔═╗╔╦╗ ╔═╗╔╦╗╔═╗╦═╗╔╦╗╔═╗╦═╗ ║
║ ║ ║ ╠═╣║ ║ ║║║╣ ╠═╣ ║║╚╗╔╝╠═╣║║║║ ║╣ ║║ ╚═╗ ║ ╠═╣╠╦╝ ║ ║╣ ╠╦╝ ║
║ ╚═╝╩═╝╩ ╩╚═╝═╩╝╚═╝ ╩ ╩═╩╝ ╚╝ ╩ ╩╝╚╝╚═╝╚═╝═╩╝ ╚═╝ ╩ ╩ ╩╩╚═ ╩ ╚═╝╩╚═ ║
║ ║
║ v2.5.0 • Production Ready ║
║ ║
╚═══════════════════════════════════════════════════════════════════════════════╝
npx claude-cli-advanced-starter-pack init
Quick Start • What You Get • 📚 Wiki • Roadmap
Feb 2026 — Major release: 7-phase Neovim plugin refactoring (health score 87/100), 5-layer Website Intelligence System with MCP server, Anthropic MCP Registry API integration, and JS module decomposition.
Complete modular rewrite of nvim-ccasp (39 files, 12,505 lines):
helpers.lua5-layer MCP server for site analysis:
http://localhost:3848Official MCP server discovery from Anthropic's registry API:
Codebase cleanup across 3 phases:
json-io.js, constants.js, index.js5 new enforcement hooks:
agent-guardrails — Prevent agent scope creepfile-collision-detector — Detect parallel edit conflictsquality-check — Code quality gatesralph-bdd-mode — BDD-style test enforcementtdd-enforcer — Test-first development guardAdditions to the template library:
github-actions-generator skill with best practices & security refssite-intel.template.md slash commandupdate-check.template.md enhancements# Update to v2.5.0
npm update -g claude-cli-advanced-starter-pack
# Sync all new features to your project
ccasp init
Every new project means:
.claude/ folders and configurationsOne 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:
| Component | Count | Examples |
|---|---|---|
| Slash Commands | 56 | /deploy-full, /pr-merge, /ralph, /phase-dev-plan |
| Enforcement Hooks | 42 | Token tracking, agent orchestration, refactor safety |
| Tech Stack Detection | 55+ | React, Vue, FastAPI, Express, Prisma, Playwright |
| Agent Templates | L1/L2/L3 | Orchestrators → Specialists → Workers |
| MCP Integrations | 50+ | Railway, Cloudflare, GitHub, Playwright |
| Skills (RAG) | 5 | agent-creator, hook-creator, refactor patterns |
Enforce project-specific coding standards and architecture patterns with automatic validation.
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
.claude/config/constitution.yaml| Section | Examples |
|---|---|
code_style |
Naming, types, imports |
architecture |
Patterns, boundaries |
security |
Credentials, validation |
performance |
Async, memoization |
git |
Commits, branches |
dependencies |
Versions, security |
See /ai-constitution-framework in Claude Code for full documentation.
Auto-generates agents that know your tech:
Continuous test-fix cycle until green:
/ralph --watch
Runs tests → Parses failures → Fixes code → Repeats.
Smart Recovery: Every 3rd failed attempt deploys a web search agent to find best-practice solutions for stubborn bugs or implementation issues.
Max 10 iterations. Stops on 3x same failure.
Coordinate full-stack, multi-feature development:
/create-roadmap "Q1 Feature Sprint"
Full-stack deploy to Railway + Cloudflare:
/deploy-full
Break complex features into phases:
/phase-dev-plan "Add user authentication"
9-phase merge workflow with safety:
/pr-merge
Multi-issue epic workflows:
/create-github-epic "Auth System"
Works with Happy.engineering:
Transform natural language into complete, working MVPs:
ccasp vision init "Build a kanban board with real-time collaboration"
8-Stage Orchestrated Workflow:
Features:
http://localhost:3847# 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
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.
# 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
npx claude-cli-advanced-starter-pack init
| Feature | Status |
|---|---|
| Vision Mode Orchestration | ✅ Complete |
| Website Intelligence (Site-Intel) | ✅ Complete |
| Anthropic MCP Registry | ✅ Complete |
| nvim-ccasp Modular Refactoring | ✅ Complete |
| JS Module Decomposition (Epic 3) | ✅ Complete |
| Jira Integration | 🔨 In Development |
| Linear Sync | 🔨 In Development |
| ClickUp Integration | 📋 Planned |
| Vision Driver Bot (VDB) v2 | 🔨 In Development |
| Multi-Repo Orchestration | 📋 Planned |
Neovim Plugin Refactoring + Site Intelligence + MCP Registry — Feb 2026
Neovim Integration (nvim-ccasp) — Feb 2026
ccasp neovim launches Neovim with CCASP pre-loadednvim-ccasp/ included in npm distributionccasp nvim-setup with symlink/copy optionsCritical Commands & Self-Healing Updates — Feb 2026
update-check and __ccasp-sync-marker now ALWAYS update during ccasp init/update-check can now update itself, fixing the bootstrap problemccasp init for full 11-category syncAuto-Run Init on Outdated Projects — Feb 2026
/update-check now runs ccasp init when sync marker missingSync Marker System — Feb 2026
__ccasp-sync-marker.md detects if project has full 11-category syncHook File Extension Support — Feb 2026
.cjs Support: Hooks now support .cjs extension for CommonJS compatibilityFull Template Category Sync — Feb 2026
/update-check now scans ALL template directoriesSimplified Update Check — Feb 2026
/update-check redesigned for complete file synchronizationEnhanced Issue Templates with Hook-Based Sync — Feb 2026
Consolidated Roadmap Architecture — Feb 2026
Menu Display Fix — Feb 2026
/menu commandMandatory L2 Exploration Files — Feb 2026
Graduated Task/Phase/Roadmap Architecture — Feb 2026
Dev Mode Smart Sync & Wizard UX — Feb 2026
smart-sync.js utility preserves user customizations when syncing from worktree[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.js to .cjs for CommonJS compatibilityE2E Testing Integration & Happy Mode Fix — Feb 2025
HAPPY_SERVER_URL alone no longer triggers mobile mode; requires active session indicatorsSecurity & Packaging — Feb 2025
Vision Driver Bot & GitHub Epics — Jan 2025
/create-github-epic/init-ccasp-new-project for Happy usersAutonomous 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:
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 detectedAutonomous 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
Multi-issue epic workflows:
/create-github-epic "User Authentication System"
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)
# Continuous test-fix until green
/ralph --watch
# Characterization tests before refactoring
/golden-master src/utils/calculate.ts
# Guided 8-step refactoring workflow
/refactor-workflow
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:
Keybindings:
| Key | Action |
|---|---|
Ctrl+B |
Toggle sidebar |
Ctrl+Shift+N |
New Claude session |
` (backtick) |
Quick toggle sessions |
Tab |
Cycle sessions |
,p |
Control Panel |
,g |
Agent Grid |
,i |
Toggle Prompt Injector |
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).
Auto-detected. Mobile-optimized formatting:
┌────────────────────────────────────┐
│ [1] Issue #42 │
│ Add JWT authentication │
├────────────────────────────────────┤
│ Status: Ready │
│ Priority: High │
│ @johndoe • 2h ago │
└────────────────────────────────────┘
/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
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
| Command | Description |
|---|---|
ccasp wizard |
Vibe-friendly setup wizard |
ccasp init |
Deploy to project |
ccasp detect-stack |
Auto-detect tech stack |
ccasp create-agent |
Create L1/L2/L3 agents |
ccasp create-hook |
Create enforcement hooks |
ccasp explore-mcp |
MCP server discovery |
ccasp neovim |
Launch Neovim with CCASP (zero-setup) |
ccasp nvim-setup |
Install nvim-ccasp permanently |
| Command | Description |
|---|---|
/menu |
Interactive navigation |
/deploy-full |
Full-stack deployment |
/pr-merge |
Safe PR merge workflow |
/ralph |
Test-fix loops |
/phase-dev-plan |
Phased development |
/create-github-epic |
Epic workflows |
/refactor-workflow |
Guided refactoring |
/golden-master |
Characterization tests |
/vision-init |
Autonomous MVP from prompt |
/vision-status |
Vision progress dashboard |
/vision-adjust |
Adjust Vision plan |
| Category | Hooks |
|---|---|
| Token & Session | token-usage-monitor, session-id-generator, context-guardian |
| Deployment | branch-merge-checker, deployment-orchestrator |
| Refactoring | ralph-loop-enforcer, refactor-verify, refactor-transaction |
| Agent Orchestration | hierarchy-validator, progress-tracker, l2-completion-reporter |
| Happy.engineering | happy-mode-detector, happy-checkpoint-manager |
Detects 55+ frameworks by reading project files (no AI):
| Category | Detected |
|---|---|
| Frontend | React, Vue, Angular, Svelte, Next.js, Nuxt, Astro |
| Backend | FastAPI, Express, NestJS, Django, Flask, Rails |
| Database | PostgreSQL, MySQL, MongoDB, SQLite, Redis |
| ORM | Prisma, TypeORM, SQLAlchemy, Drizzle |
| Testing | Jest, Vitest, Playwright, Cypress, pytest |
| Deployment | Railway, Vercel, Netlify, Cloudflare |
ccasp explore-mcp # Interactive menu
ccasp explore-mcp --recommend # Auto-recommend for your stack
| Category | Servers |
|---|---|
| Testing | Playwright, Puppeteer, Skyvern |
| Deployment | Railway, Cloudflare, Vercel |
| Database | PostgreSQL, Supabase, Redis |
| Tunnel | ngrok, Cloudflare Tunnel |
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
MIT © evan043
Stop configuring Claude Code for every project. CCASP gives you a complete, stack-customized setup in one command.
Get Started • Documentation • Issues • npm
Please log in to share your review and rating for this MCP.
Explore related MCPs that share similar capabilities and solve comparable challenges
by headroomlabs-ai
Compress tool outputs, logs, files, RAG chunks, and conversation history before they reach the LLM, keeping answers identical while saving up to 95% of tokens for JSON payloads.
by modelcontextprotocol
A Model Context Protocol server for Git repository interaction and automation.
by zed-industries
A high‑performance, multiplayer code editor designed for speed and collaboration.
by modelcontextprotocol
Model Context Protocol Servers
by modelcontextprotocol
A Model Context Protocol server that provides time and timezone conversion capabilities.
by cline
An autonomous coding assistant that can create and edit files, execute terminal commands, and interact with a browser directly from your IDE, operating step‑by‑step with explicit user permission.
by upstash
Provides up-to-date, version‑specific library documentation and code examples directly inside LLM prompts, eliminating outdated information and hallucinated APIs.
by daytonaio
Provides a secure, elastic infrastructure that creates isolated sandboxes for running AI‑generated code with sub‑90 ms startup, unlimited persistence, and OCI/Docker compatibility.
by continuedev
Enables faster shipping of code by integrating continuous AI agents across IDEs, terminals, and CI pipelines, offering chat, edit, autocomplete, and customizable agent workflows.