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 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.
by github
Connects AI tools directly to GitHub, enabling natural‑language interactions for repository browsing, issue and pull‑request management, CI/CD monitoring, code‑security analysis, and team collaboration.