v0.2.0 — God Mode Activated

Your entire
engineering team
in one CLI

Scaffold new projects. Analyze existing ones. Inject features. Score health. Deploy anywhere. Powered by Claude AI — works with any stack.

Get Started View Commands
$ npm install -g vibe-init-cli
Terminal — vibe init
$ vibe init

+------------------------------------------+
| VIBE INIT — GOD MODE ACTIVATED |
| The last CLI you'll ever need. |
+------------------------------------------+

Tell me your idea. Even one line.
> A pet health tracker for managing vet visits

Enriching your idea with Claude...
Generating Architecture Decision Record...
Rendering project templates...
Generating documentation with Claude...
Writing 28 files to pet-health-tracker/...

PROJECT SCAFFOLDED SUCCESSFULLY!
cd pet-health-tracker && make setup && make dev
God Mode Features

Greenfield. Brownfield.
Everything in between.

Not a template generator. A project intelligence engine that works on any codebase.

AI-Powered Scaffolding

Describe your idea in plain English. Claude generates personas, features, architecture decisions, and a complete production-ready codebase. Multi-stack: Next.js, FastAPI, Go.

Brownfield Analysis

vibe scan analyzes any existing project — detects stack, framework, missing best practices, and auto-generates a CLAUDE.md. Works without any API key.

Modular Feature Injection

vibe add docker, vibe add ci, vibe add testing — inject production features into any existing project. Idempotent and stack-aware.

Project Health Scoring

vibe doctor scores your project against best practices — testing, CI/CD, security, documentation, observability. Get a letter grade and fix suggestions.

Deployment Guidance

vibe deploy detects your deployment target (Vercel, Railway, Fly.io, Docker), generates config files, and runs readiness checks before you ship.

Context-Aware AI Commands

vibe run and vibe ask inject your CLAUDE.md as context. Claude understands your architecture, conventions, and patterns before writing a single line.

How It Works

Four phases. Zero config.

From raw idea to running code in under 2 minutes.

Ignition

You describe your idea in 1-5 sentences. Plain English, broken grammar, half-formed thoughts — all accepted.

Enrichment

Claude analyzes your idea and generates a structured brief: vision, personas, prioritized features (P0/P1/P2), tech stack, and architecture.

Architecture

An ADR is auto-generated documenting your architecture decision, alternatives considered, trade-offs, and 12-Factor compliance mapping.

Scaffold

25+ production-ready files are generated: app code, API routes, database schema, tests, Docker, CI/CD, docs — all wired together and running.

Brownfield Mode

Works on your existing projects too.

Not starting from scratch? Vibe Init analyzes, scores, and upgrades any codebase.

Brownfield Workflow
# Analyze your existing project
$ vibe scan

Stack: Next.js 15 (TypeScript)
Framework: Next.js
Package: npm

FOUND Testing vitest.config.ts
FOUND Docker Dockerfile
MISSING CI/CD
MISSING Health check
MISSING Structured logging

# Fix the gaps
$ vibe add ci
Created .github/workflows/ci.yml

$ vibe add health
Created src/app/api/health/route.ts

# Check your score
$ vibe doctor

Overall: B+ (82/100)
CLI Reference

Eight commands.
God mode unlocked.

From greenfield scaffolding to brownfield analysis — every command you need.

vibe init
--verbose --dry-run
Scaffold a new full-stack project from an idea. Interactive enrichment flow with Claude, ADR generation, and 25+ production-ready files. Supports Next.js, FastAPI, and Go.
vibe scan
--generate-claude-md
Analyze any existing project. Detects stack, framework, and best practice gaps (testing, CI, Docker, security, logging). Auto-generates a CLAUDE.md. No API key needed for detection.
vibe add <feature>
--force --verbose
Inject production features into any project. Available: docker, ci, testing, logging, validation, health, hooks, auth, db. Also generators: api <name>, component <name>, model <name>.
vibe doctor
--verbose
Score your project against engineering best practices. Checks testing, CI/CD, containerization, security, code quality, documentation, and observability. Returns a letter grade (A+ through F) with fix suggestions.
vibe run <task>
--verbose
Execute a coding task with Claude Code, enriched with your CLAUDE.md context. Use for features, refactoring, debugging, or any code change.
vibe ask <question>
--verbose
Ask Claude a question about your project in read-only advisory mode. No files are changed. Great for architecture decisions and trade-off analysis.
vibe deploy
--target
Detect deployment target (Vercel, Railway, Fly.io, Docker), generate config files, run readiness checks, and print a step-by-step deployment guide.
vibe upgrade
--dry-run
Compare your vibe-scaffolded project against the latest templates. Show what has changed and selectively apply updates without overwriting your customizations.
Generated Stack

What ships in every project

V1 scaffolds a complete TypeScript/Next.js full-stack application.

Next.js 15

App Router

TypeScript

Strict mode

Prisma

ORM + Migrations

PostgreSQL

Primary database

Redis

Cache layer

Docker

Multi-stage builds

GitHub Actions

CI/CD pipeline

Vitest

Fast testing

Pino

Structured logging

Zod

Validation

Husky

Git hooks

Commitlint

Conventional commits

Quickstart

Up and running in 60 seconds

New Project (Greenfield)
# Install
$ npm install -g vibe-init-cli

# Scaffold a new project
$ vibe init

# Start developing
$ cd my-project && make setup
$ make dev

# Check project health
$ vibe doctor
Existing Project (Brownfield)
# Analyze your codebase
$ cd my-existing-app
$ vibe scan

# Add missing features
$ vibe add docker
$ vibe add ci
$ vibe add testing

# Generate CLAUDE.md
$ vibe scan --generate-claude-md

Stop configuring.
Start shipping.

Your next project is one command away.

$ npm install -g vibe-init-cli