@nclamvn/vibecode-cli 1.5.0 → 1.7.0

package/docs-site/docs/commands/status.md

@@ -0,0 +1,37 @@
+---
+sidebar_position: 3
+---
+
+# vibecode status
+
+Display current state and progress.
+
+## Synopsis
+
+```bash
+vibecode status [options]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON |
+| `-v, --verbose` | Show detailed info |
+
+## Examples
+
+```bash
+# Basic status
+vibecode status
+
+# JSON output
+vibecode status --json
+
+# Detailed info
+vibecode status --verbose
+```
+
+## See Also
+
+- [doctor](./doctor) - Check configuration

package/docs-site/docs/commands/undo.md

@@ -0,0 +1,83 @@
+---
+sidebar_position: 15
+---
+
+# vibecode undo
+
+Undo/rollback to previous state.
+
+## Synopsis
+
+```bash
+vibecode undo [options]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-l, --list` | List available backups |
+| `-s, --step <n>` | Restore to N steps ago |
+| `-c, --clear` | Clear all backups |
+| `-f, --force` | Skip confirmation |
+
+## Examples
+
+### List Backups
+
+```bash
+vibecode undo --list
+```
+
+Output:
+```
+╭────────────────────────────────────────────────────────────╮
+│  📦 BACKUP HISTORY                                         │
+╰────────────────────────────────────────────────────────────╯
+
+   1. build-auto
+      5 phút trước · 12 files
+
+   2. agent-build
+      1 giờ trước · 8 files
+
+  Chạy vibecode undo để restore
+```
+
+### Interactive Restore
+
+```bash
+vibecode undo
+```
+
+### Restore Specific Step
+
+```bash
+vibecode undo --step 2
+```
+
+### Force Restore
+
+```bash
+vibecode undo --step 1 --force
+```
+
+## How Backups Work
+
+Backups are created automatically before:
+- `vibecode build --auto`
+- `vibecode agent`
+- `vibecode go`
+
+Stored in `.vibecode/backups/` with:
+- File content snapshots
+- MD5 hash verification
+- Manifest for restore
+
+Last 10 backups are kept.
+
+## See Also
+
+- [build](./build) - Triggers backup
+- [agent](./agent) - Triggers backup
+- [go](./go) - Triggers backup

package/docs-site/docs/configuration.md

@@ -0,0 +1,72 @@
+---
+sidebar_position: 7
+---
+
+# Configuration
+
+Customize Vibecode behavior to fit your workflow.
+
+## Configuration Files
+
+### `.vibecode/state.json`
+
+Project-level state:
+
+```json
+{
+  "currentState": "initialized",
+  "projectName": "my-project",
+  "spec_hash": "abc123...",
+  "created": "2024-01-01T00:00:00Z"
+}
+```
+
+### `~/.vibecode/config.json`
+
+Global configuration:
+
+```json
+{
+  "defaultProvider": "claude-code",
+  "preferredLanguage": "vi",
+  "autoBackup": true
+}
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `ANTHROPIC_API_KEY` | API key for Claude |
+| `VIBECODE_PROVIDER` | Override default provider |
+| `VIBECODE_DEBUG` | Enable debug logging |
+
+## Provider Configuration
+
+```bash
+# Set default provider
+vibecode config --provider claude-code
+
+# View current config
+vibecode config --show
+```
+
+## Backup Settings
+
+Backups are created automatically before:
+- Auto builds
+- Agent builds
+- Magic mode
+
+Stored in `.vibecode/backups/` (last 10 kept).
+
+## Learning Settings
+
+Learnings stored in:
+- Local: `.vibecode/learning/`
+- Global: `~/.vibecode/learning/`
+
+Clear with:
+```bash
+vibecode learn --clear
+```

package/docs-site/docs/faq.md

@@ -0,0 +1,83 @@
+---
+sidebar_position: 8
+---
+
+# FAQ
+
+Frequently asked questions about Vibecode CLI.
+
+## General
+
+### What is Vibecode?
+
+Vibecode is a CLI tool for AI-assisted software development with built-in discipline and guardrails.
+
+### Is it free?
+
+Yes, Vibecode CLI is open source and free. However, you need an Anthropic API key for Claude Code.
+
+### What models does it use?
+
+Vibecode uses Claude Code CLI which uses Claude 3.5 Sonnet by default.
+
+## Installation
+
+### Why do I need Claude Code?
+
+Claude Code provides the AI capabilities for code generation, debugging, and assistance.
+
+### Node.js version error?
+
+Upgrade to Node.js 18 or higher:
+```bash
+nvm install 20
+nvm use 20
+```
+
+## Usage
+
+### Magic Mode vs Agent Mode?
+
+- **Magic Mode** (`go`): Single-module projects, quick prototypes
+- **Agent Mode** (`agent`): Complex multi-module systems
+
+### How do I undo changes?
+
+```bash
+vibecode undo --list  # See available backups
+vibecode undo         # Interactive restore
+```
+
+### How does learning work?
+
+After each fix, Vibecode asks for feedback. This helps improve future suggestions.
+
+## Troubleshooting
+
+### Build failed?
+
+1. Check logs: `cat .vibecode/sessions/*/evidence/build.log`
+2. Try iterative mode: `vibecode go "desc" --iterate`
+3. Use debug: `vibecode debug --auto`
+
+### Tests failing?
+
+Run with strict mode to see issues:
+```bash
+vibecode build --iterate --strict
+```
+
+### Claude Code not found?
+
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+
+## Contributing
+
+### How can I contribute?
+
+- Report issues on GitHub
+- Submit pull requests
+- Improve documentation
+- Share feedback

package/docs-site/docs/getting-started.md

@@ -0,0 +1,119 @@
+---
+sidebar_position: 2
+---
+
+# Getting Started
+
+Get up and running with Vibecode CLI in minutes.
+
+## Prerequisites
+
+Before installing Vibecode, ensure you have:
+
+1. **Node.js 18+**
+   ```bash
+   node --version  # Should be v18.0.0 or higher
+   ```
+
+2. **Claude Code CLI** (for AI features)
+   ```bash
+   npm install -g @anthropic-ai/claude-code
+   ```
+
+## Installation
+
+Install Vibecode globally:
+
+```bash
+npm install -g @nclamvn/vibecode-cli
+```
+
+Verify installation:
+
+```bash
+vibecode --version
+# Output: 1.6.0
+```
+
+## Your First Project
+
+### Option 1: Interactive Wizard
+
+Simply run `vibecode` with no arguments:
+
+```bash
+vibecode
+```
+
+You'll see an interactive menu:
+
+```
+? Bạn muốn làm gì hôm nay?
+  🚀 Tạo project mới nhanh (go)
+  🤖 Build project phức tạp (agent)
+  🔧 Debug lỗi (debug)
+  💬 Hỏi AI (assist)
+  📊 Xem trạng thái
+```
+
+### Option 2: Magic Mode
+
+Build a complete project with one command:
+
+```bash
+vibecode go "A todo app with React and local storage"
+```
+
+Vibecode will:
+1. Create project directory
+2. Capture requirements
+3. Design architecture
+4. Generate code
+5. Run tests
+6. Show results
+
+### Option 3: Step-by-Step Workflow
+
+For more control, use the guided workflow:
+
+```bash
+# Initialize workspace
+vibecode init
+
+# Start guided session
+vibecode start
+
+# ... follow prompts ...
+
+# Build with AI
+vibecode build --auto
+
+# Review results
+vibecode review
+```
+
+## Project Structure
+
+After running `vibecode init`, your project will have:
+
+```
+your-project/
+├── .vibecode/
+│   ├── state.json         # Current state
+│   ├── sessions/          # Session data
+│   │   └── [session-id]/
+│   │       ├── intake.md      # Requirements
+│   │       ├── blueprint.md   # Architecture
+│   │       ├── contract.md    # Locked spec
+│   │       ├── plan.md        # Execution plan
+│   │       └── evidence/      # Build logs
+│   ├── backups/           # Auto-backups
+│   └── learning/          # AI learnings
+└── ... your code files
+```
+
+## Next Steps
+
+- [Commands Overview](./commands) - Learn all available commands
+- [Magic Mode Guide](./guides/magic-mode) - Deep dive into `vibecode go`
+- [Configuration](./configuration) - Customize Vibecode behavior

package/docs-site/docs/guides/agent-mode.md

@@ -0,0 +1,94 @@
+---
+sidebar_position: 2
+---
+
+# Agent Mode Guide
+
+Build complex multi-module projects with autonomous agents.
+
+## Overview
+
+Agent Mode decomposes large projects into modules, builds each sequentially, and uses self-healing to recover from errors.
+
+## When to Use Agent Mode
+
+✅ **Good for:**
+- Complex full-stack applications
+- Projects with multiple features
+- Systems with many integrations
+- Production-grade builds
+
+## Architecture
+
+```
+┌─────────────────────────────────────────┐
+│            Orchestrator                 │
+├─────────────────────────────────────────┤
+│  ┌─────────┐ ┌─────────┐ ┌─────────┐   │
+│  │Decompose│→│ Build   │→│ Verify  │   │
+│  └─────────┘ └─────────┘ └─────────┘   │
+│        ↓          ↓          ↓         │
+│  ┌─────────────────────────────────┐   │
+│  │         Memory Engine           │   │
+│  └─────────────────────────────────┘   │
+│        ↓                               │
+│  ┌─────────────────────────────────┐   │
+│  │       Self-Healing Engine       │   │
+│  └─────────────────────────────────┘   │
+└─────────────────────────────────────────┘
+```
+
+## Module Types
+
+Agent Mode recognizes common module patterns:
+
+- **auth** - Authentication/authorization
+- **api** - REST/GraphQL endpoints
+- **database** - Schema and models
+- **ui** - Frontend components
+- **admin** - Admin dashboard
+- **integration** - Third-party services
+
+## Example: E-commerce
+
+```bash
+vibecode agent "E-commerce platform with:
+- User authentication (email, OAuth)
+- Product catalog with categories
+- Shopping cart with sessions
+- Checkout with Stripe
+- Admin dashboard
+- Order management"
+```
+
+Agent decomposes into:
+1. `auth` - User system
+2. `products` - Catalog
+3. `cart` - Shopping cart
+4. `checkout` - Payment
+5. `admin` - Dashboard
+6. `orders` - Management
+
+## Self-Healing
+
+When a module fails:
+
+1. **Analyze** - Identify error pattern
+2. **Hypothesize** - Generate fix
+3. **Apply** - Make changes
+4. **Verify** - Re-test
+5. **Learn** - Store pattern
+
+Max 3 retries per module by default.
+
+## Memory System
+
+Agent remembers:
+- Successful build patterns
+- Common error fixes
+- Technology preferences
+
+View with:
+```bash
+vibecode agent --status
+```

package/docs-site/docs/guides/debug-mode.md

@@ -0,0 +1,83 @@
+---
+sidebar_position: 3
+---
+
+# Debug Mode Guide
+
+Master the 9-step intelligent debugging protocol.
+
+## Overview
+
+Debug Mode uses a systematic approach to identify, fix, and prevent bugs.
+
+## The 9 Steps
+
+### Step 1: Evidence
+Collect information about the error from:
+- Error logs
+- Stack traces
+- User descriptions
+- Screenshots
+
+### Step 2: Reproduce
+Confirm the error exists by running:
+- Type checking
+- Build commands
+- Test suites
+
+### Step 3: Analyze
+Identify root cause:
+- Pattern matching
+- AI analysis
+- Category detection
+
+### Step 4: Hypothesize
+Generate fix hypotheses:
+- Ranked by confidence
+- Based on past successes
+- Multiple approaches
+
+### Step 5: Test
+Validate the approach:
+- Generate fix prompt
+- Prepare changes
+
+### Step 6: Fix
+Apply fix via Claude Code:
+- Make changes
+- Log evidence
+
+### Step 7: Verify
+Confirm fix works:
+- Re-run tests
+- Check functionality
+
+### Step 8: Document
+Log for future:
+- Store fix pattern
+- Update history
+
+### Step 9: Prevent
+Add prevention rules:
+- Update CLAUDE.md
+- Add warnings
+
+## Error Categories
+
+| Category | Examples |
+|----------|----------|
+| RUNTIME | undefined, null, type errors |
+| SYNTAX | Unexpected tokens |
+| MODULE | Missing imports |
+| FILE | ENOENT |
+| NETWORK | ECONNREFUSED |
+| NPM | Dependency issues |
+| DATABASE | Connection, query errors |
+| TYPESCRIPT | Type mismatches |
+
+## Tips
+
+1. **Be specific** - Include full error message
+2. **Use auto mode** - Let AI scan for all errors
+3. **Provide context** - Mention what you were doing
+4. **Give feedback** - Help AI learn from fixes

package/docs-site/docs/guides/magic-mode.md

@@ -0,0 +1,107 @@
+---
+sidebar_position: 1
+---
+
+# Magic Mode Guide
+
+A comprehensive guide to using `vibecode go` for one-command project building.
+
+## Overview
+
+Magic Mode is Vibecode's flagship feature - describe what you want, and it builds the entire project automatically.
+
+## When to Use Magic Mode
+
+✅ **Good for:**
+- Prototypes and MVPs
+- Landing pages
+- Simple full-stack apps
+- Learning projects
+
+❌ **Consider Agent Mode for:**
+- Complex multi-module systems
+- Enterprise applications
+- Projects with many integrations
+
+## Best Practices
+
+### 1. Be Specific
+
+```bash
+# ❌ Too vague
+vibecode go "a website"
+
+# ✅ Specific
+vibecode go "Landing page for a SaaS product with hero, features, pricing, and contact sections using React and Tailwind"
+```
+
+### 2. Mention Tech Stack
+
+```bash
+vibecode go "Todo app with React, TypeScript, and local storage"
+```
+
+### 3. Include Key Features
+
+```bash
+vibecode go "Blog platform with markdown support, categories, search, and dark mode"
+```
+
+### 4. Use Templates
+
+```bash
+vibecode go "My startup landing" --template landing
+```
+
+## Understanding the Process
+
+### Phase 1: Initialization (5%)
+- Creates project directory
+- Sets up workspace structure
+
+### Phase 2: Requirements (10%)
+- Parses your description
+- Generates intake document
+
+### Phase 3: Architecture (15%)
+- Designs system blueprint
+- Identifies components
+
+### Phase 4: Contract (20%)
+- Creates acceptance criteria
+- Defines deliverables
+
+### Phase 5: Planning (25%)
+- Generates execution plan
+- Prepares coder pack
+
+### Phase 6: Building (85%)
+- Claude Code generates files
+- Implements features
+
+### Phase 7: Testing (95%)
+- Runs automated tests
+- Validates functionality
+
+## Troubleshooting
+
+### Build Failed
+
+```bash
+# Check logs
+cat .vibecode/sessions/*/evidence/build.log
+
+# Try iterative mode
+vibecode go "your description" --iterate
+```
+
+### Tests Failing
+
+```bash
+# Use strict mode to see issues
+vibecode go "your description" --iterate --strict
+```
+
+### Missing Features
+
+Be more explicit in your description or use `vibecode assist` to add features after initial build.