start-vibing

One command to set up Claude Code with a complete AI development workflow.

Quick Start

# Just run this in any project
npx start-vibing

That's it! The CLI will:

1. Check for updates
2. Set up the .claude/ folder with agents, skills, and plugins
3. Install Claude Code if not found on your system
4. Launch Claude Code with --dangerously-skip-permissions

Installation

Recommended: Install Globally

npm install -g start-vibing

Then just run start-vibing in any project.

Or use npx/bunx

npx start-vibing    # npm
bunx start-vibing   # bun (faster)

What It Does

1. Auto-installs Claude Code (Native)

Installs Claude Code using the official native installer (recommended):

| Platform | Installation Command | | -------------------- | ------------------------------------------------- | | macOS/Linux | curl -fsSL https://claude.ai/install.sh \| bash | | Windows (PowerShell) | irm https://claude.ai/install.ps1 \| iex | | Windows (CMD) | Downloads and runs install.cmd |

Automatic Migration: If you have an old npm installation, it automatically migrates to native installer for better auto-update support.

2. Sets Up Complete Workflow

Creates a .claude/ folder with:

.claude/
├── agents/          # 6 specialized AI subagents
│   ├── research-web.md       # Best practices research
│   ├── documenter.md         # Domain documentation
│   ├── domain-updater.md     # Session learnings
│   ├── commit-manager.md     # Git workflow
│   ├── claude-md-compactor.md # CLAUDE.md maintenance
│   └── tester-unit.md        # Unit testing
├── skills/          # 20 skill systems (auto-injected)
│   ├── typescript-strict/    # TypeScript patterns
│   ├── react-patterns/       # React 19 patterns
│   ├── security-scan/        # OWASP validation
│   ├── quality-gate/         # Quality checks
│   └── ...
├── config/          # Project configuration
│   ├── project-config.json
│   ├── domain-mapping.json
│   └── ...
└── commands/        # Slash commands

3. Auto-launches Claude Code

After setup, automatically runs claude --dangerously-skip-permissions so you can start working immediately.

4. Self-updates

Checks for updates on every run (cached for 1 hour) and notifies you when a new version is available.

Architecture

6 Subagents

| Agent | Purpose | | ------------------ | ------------------------------------ | | research-web | Researches best practices (2024-2026)| | documenter | Maps files to domains, creates docs | | domain-updater | Records learnings in domain docs | | commit-manager | Manages git commits | | claude-md-compactor| Compacts CLAUDE.md when > 40k chars | | tester-unit | Creates unit tests with Vitest |

5 Plugins (auto-install)

| Plugin | Mechanism | Purpose | | ------------------ | ---------------- | -------------------------- | | typescript-lsp | LSP server | Type diagnostics (auto) | | security-guidance | PreToolUse hook | OWASP vulnerability scan | | code-review | /code-review cmd | Code quality analysis | | commit-commands | /commit cmd | Git commit/push/PR flows | | frontend-design | /frontend-design | Production-grade UI design |

20 Skills

Skills are auto-injected into context when the task matches their description.

| Category | Skills | | ------------------ | --------------------------------------------------------- | | Development | bun-runtime, typescript-strict, react-patterns, nextjs-app-router, trpc-api, zod-validation, shadcn-ui, tailwind-patterns | | Quality & Testing | quality-gate, security-scan, test-coverage, final-check | | Infrastructure | docker-patterns, git-workflow, performance-patterns, debugging-patterns | | Documentation | codebase-knowledge, docs-tracker, research-cache, ui-ux-audit |

Smart Copy Behavior

When you run start-vibing in an existing project:

• ALWAYS overwrites: Agent files, settings.json
• PRESERVES: Your custom domains, cached research
• MERGES: New skills with existing ones

Use --force to overwrite everything.

CLI Options

| Flag | Description | | ------------------- | ---------------------------------------- | | --force | Overwrite all files | | --new | Start fresh session (skip resume) | | --no-claude | Skip Claude Code installation and launch | | --no-update-check | Skip checking for updates | | --help, -h | Show help message | | --version, -v | Show version |

After Setup

# 1. Configure your project
edit .claude/config/project-config.json

# 2. Claude Code is already running!
# The agents and skills will guide you through the workflow

Configuration

Edit .claude/config/project-config.json:

{
  "stack": {
    "runtime": "bun",
    "language": "typescript",
    "database": "mongodb"
  },
  "commands": {
    "typecheck": "bun run typecheck",
    "lint": "bun run lint",
    "test": "bun run test",
    "build": "bun run build"
  }
}

Requirements

• Node.js >= 18 or Bun
• Internet connection (for Claude Code installation if needed)

Platforms

| Platform | Status | | -------------------- | --------------- | | macOS | Fully supported | | Linux | Fully supported | | Windows (PowerShell) | Fully supported | | Windows (CMD) | Fully supported | | Windows (WSL) | Fully supported |

License

MIT

Links

• Claude Code Documentation
• GitHub Repository
• Report Issues