@nclamvn/vibecode-cli 1.6.0 → 1.8.0

package/bin/vibecode.js

@@ -23,6 +23,16 @@ import {
   assistCommand,
   undoCommand,
   learnCommand,
+  gitCommand,
+  watchCommand,
+  shellCommand,
+  // Phase K Commands
+  testCommand,
+  docsCommand,
+  refactorCommand,
+  securityCommand,
+  askCommand,
+  migrateCommand,
   VERSION
 } from '../src/index.js';
 
@@ -95,6 +105,8 @@ program
   .command('review')
   .description('Review build against acceptance criteria')
   .option('--skip-manual', 'Skip manual verification prompts')
+  .option('--ai', 'AI-powered code review')
+  .option('-p, --path <dir>', 'Specific path to review')
   .action(reviewCommand);
 
 program
@@ -160,7 +172,8 @@ program
   .option('-i, --interactive', 'Interactive debug session (default if no args)')
   .option('-a, --auto', 'Auto-scan project for errors and fix')
   .option('-l, --log <text>', 'Provide error log directly')
-  .option('--image <path>', 'Provide error screenshot')
+  .option('--image <path>', 'Analyze error from screenshot file')
+  .option('--clipboard', 'Analyze error from clipboard image')
   .option('--attempts <n>', 'Max fix attempts (default: 3)', parseInt)
   .option('-v, --verbose', 'Show detailed output')
   .option('-q, --quiet', 'Minimal output')
@@ -203,6 +216,93 @@ program
   .option('-f, --force', 'Skip confirmation prompts')
   .action(learnCommand);
 
+// ─────────────────────────────────────────────────────────────────────────────
+// Phase I Commands - Git Integration
+// ─────────────────────────────────────────────────────────────────────────────
+
+program
+  .command('git [subcommand] [args...]')
+  .description('Git integration - commit, diff, branch, push with enhanced UI')
+  .option('-a, --auto', 'Auto-stage all changes before commit')
+  .option('-m, --message <msg>', 'Commit message')
+  .option('--staged', 'Show only staged changes (for diff)')
+  .option('--review', 'AI-powered diff review')
+  .option('--count <n>', 'Number of commits to show (for log)', parseInt)
+  .option('--all', 'Include all files (for add)')
+  .action((subcommand, args, options) => {
+    gitCommand(subcommand, args || [], options);
+  });
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Phase I2 Commands - File Watcher
+// ─────────────────────────────────────────────────────────────────────────────
+
+program
+  .command('watch')
+  .description('Watch mode - auto-test/lint/build on file changes')
+  .option('-d, --dir <path>', 'Directory to watch')
+  .option('-t, --test', 'Run tests on change')
+  .option('-l, --lint', 'Run lint on change')
+  .option('-b, --build', 'Run build on change')
+  .option('-T, --typecheck', 'Run TypeScript check on change')
+  .option('-a, --all', 'Run all checks (test, lint, typecheck)')
+  .option('-n, --notify', 'Desktop notifications')
+  .option('-i, --immediate', 'Run checks immediately on start')
+  .action(watchCommand);
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Phase I3 Commands - Shell Mode
+// ─────────────────────────────────────────────────────────────────────────────
+
+program
+  .command('shell')
+  .alias('$')
+  .description('Interactive shell with vibecode context and AI assistance')
+  .action(shellCommand);
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Phase K Commands - Maximize Claude Code
+// ─────────────────────────────────────────────────────────────────────────────
+
+program
+  .command('test [path]')
+  .description('🧪 Test generation and running')
+  .option('-g, --generate', 'Generate tests with AI')
+  .option('-r, --run', 'Run tests')
+  .option('-c, --coverage', 'Show coverage')
+  .action(testCommand);
+
+program
+  .command('docs')
+  .description('📚 Generate documentation with AI')
+  .option('-g, --generate', 'Generate docs')
+  .option('-t, --type <type>', 'Doc type: readme, api, architecture, jsdoc, all')
+  .action(docsCommand);
+
+program
+  .command('refactor [path]')
+  .description('🔄 AI-powered code refactoring')
+  .option('-t, --type <type>', 'Type: clean, dry, performance, architecture, modularize, modernize')
+  .option('-d, --description <desc>', 'Custom refactoring description')
+  .action(refactorCommand);
+
+program
+  .command('security')
+  .description('🔒 Security audit with AI analysis')
+  .option('-f, --fix', 'Auto-fix security issues')
+  .action(securityCommand);
+
+program
+  .command('ask [question...]')
+  .description('💬 Ask questions about your codebase')
+  .action(askCommand);
+
+program
+  .command('migrate [description...]')
+  .description('🔄 AI-powered code migration')
+  .option('-p, --path <path>', 'Specific path to migrate')
+  .action(migrateCommand);
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Parse - If no command provided, show interactive wizard
 // ─────────────────────────────────────────────────────────────────────────────

package/docs-site/README.md

@@ -0,0 +1,41 @@
+# Website
+
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+
+## Installation
+
+```bash
+yarn
+```
+
+## Local Development
+
+```bash
+yarn start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+## Build
+
+```bash
+yarn build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+## Deployment
+
+Using SSH:
+
+```bash
+USE_SSH=true yarn deploy
+```
+
+Not using SSH:
+
+```bash
+GIT_USER=<Your GitHub username> yarn deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

package/docs-site/blog/2019-05-28-first-blog-post.md

@@ -0,0 +1,12 @@
+---
+slug: first-blog-post
+title: First Blog Post
+authors: [slorber, yangshun]
+tags: [hola, docusaurus]
+---
+
+Lorem ipsum dolor sit amet...
+
+<!-- truncate -->
+
+...consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

package/docs-site/blog/2019-05-29-long-blog-post.md

@@ -0,0 +1,44 @@
+---
+slug: long-blog-post
+title: Long Blog Post
+authors: yangshun
+tags: [hello, docusaurus]
+---
+
+This is the summary of a very long blog post,
+
+Use a `<!--` `truncate` `-->` comment to limit blog post size in the list view.
+
+<!-- truncate -->
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet

package/docs-site/blog/2021-08-01-mdx-blog-post.mdx

@@ -0,0 +1,24 @@
+---
+slug: mdx-blog-post
+title: MDX Blog Post
+authors: [slorber]
+tags: [docusaurus]
+---
+
+Blog posts support [Docusaurus Markdown features](https://docusaurus.io/docs/markdown-features), such as [MDX](https://mdxjs.com/).
+
+:::tip
+
+Use the power of React to create interactive blog posts.
+
+:::
+
+{/* truncate */}
+
+For example, use JSX to create an interactive button:
+
+```js
+<button onClick={() => alert('button clicked!')}>Click me!</button>
+```
+
+<button onClick={() => alert('button clicked!')}>Click me!</button>

package/docs-site/blog/2021-08-26-welcome/index.md

@@ -0,0 +1,29 @@
+---
+slug: welcome
+title: Welcome
+authors: [slorber, yangshun]
+tags: [facebook, hello, docusaurus]
+---
+
+[Docusaurus blogging features](https://docusaurus.io/docs/blog) are powered by the [blog plugin](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-blog).
+
+Here are a few tips you might find useful.
+
+<!-- truncate -->
+
+Simply add Markdown files (or folders) to the `blog` directory.
+
+Regular blog authors can be added to `authors.yml`.
+
+The blog post date can be extracted from filenames, such as:
+
+- `2019-05-30-welcome.md`
+- `2019-05-30-welcome/index.md`
+
+A blog post folder can be convenient to co-locate blog post images:
+
+![Docusaurus Plushie](./docusaurus-plushie-banner.jpeg)
+
+The blog supports tags as well!
+
+**And if you don't want a blog**: just delete this directory, and use `blog: false` in your Docusaurus config.

package/docs-site/blog/authors.yml

@@ -0,0 +1,25 @@
+yangshun:
+  name: Yangshun Tay
+  title: Ex-Meta Staff Engineer, Co-founder GreatFrontEnd
+  url: https://linkedin.com/in/yangshun
+  image_url: https://github.com/yangshun.png
+  page: true
+  socials:
+    x: yangshunz
+    linkedin: yangshun
+    github: yangshun
+    newsletter: https://www.greatfrontend.com
+
+slorber:
+  name: Sébastien Lorber
+  title: Docusaurus maintainer
+  url: https://sebastienlorber.com
+  image_url: https://github.com/slorber.png
+  page:
+    # customize the url of the author page at /blog/authors/<permalink>
+    permalink: '/all-sebastien-lorber-articles'
+  socials:
+    x: sebastienlorber
+    linkedin: sebastienlorber
+    github: slorber
+    newsletter: https://thisweekinreact.com

package/docs-site/blog/tags.yml

@@ -0,0 +1,19 @@
+facebook:
+  label: Facebook
+  permalink: /facebook
+  description: Facebook tag description
+
+hello:
+  label: Hello
+  permalink: /hello
+  description: Hello tag description
+
+docusaurus:
+  label: Docusaurus
+  permalink: /docusaurus
+  description: Docusaurus tag description
+
+hola:
+  label: Hola
+  permalink: /hola
+  description: Hola tag description

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

@@ -0,0 +1,162 @@
+---
+sidebar_position: 12
+---
+
+# vibecode agent
+
+**Agent Mode** - Autonomous multi-module builder with self-healing.
+
+## Synopsis
+
+```bash
+vibecode agent <description> [options]
+```
+
+## Description
+
+The `agent` command is designed for complex projects with multiple modules. It decomposes your project into independent modules, builds them sequentially, and uses self-healing to recover from errors.
+
+## Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `description` | Description of the project to build |
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-n, --new` | Create new project directory |
+| `-v, --verbose` | Show detailed progress |
+| `--analyze` | Analyze project without building |
+| `--status` | Show agent status and memory |
+| `--report` | Export memory report |
+| `--clear` | Clear agent memory |
+| `--force` | Force operation |
+| `--json` | Output as JSON |
+| `--max-retries <n>` | Max retries per module (default: 3) |
+| `--skip-tests` | Skip tests after each module |
+| `--continue` | Continue on module failure |
+
+## Examples
+
+### Build Complex Project
+
+```bash
+vibecode agent "E-commerce platform with user auth, product catalog, shopping cart, and checkout"
+```
+
+### Create New Project
+
+```bash
+vibecode agent "Blog platform with CMS" --new
+```
+
+### Analyze Without Building
+
+```bash
+vibecode agent "My project" --analyze
+```
+
+### Check Agent Status
+
+```bash
+vibecode agent --status
+```
+
+### Export Report
+
+```bash
+vibecode agent --report
+```
+
+## How It Works
+
+### 1. Decomposition
+
+The agent analyzes your description and breaks it into modules:
+
+```
+📦 Project: E-commerce Platform
+├── 🔐 auth          (User authentication)
+├── 📦 products      (Product catalog)
+├── 🛒 cart          (Shopping cart)
+├── 💳 checkout      (Payment processing)
+└── 📊 admin         (Admin dashboard)
+```
+
+### 2. Sequential Building
+
+Each module is built in dependency order with its own:
+- Requirements capture
+- Code generation
+- Test execution
+- Verification
+
+### 3. Self-Healing
+
+If a module fails:
+1. Analyze the error
+2. Generate fix
+3. Retry build
+4. Max 3 attempts per module
+
+### 4. Memory System
+
+The agent remembers:
+- Successful patterns
+- Common errors
+- Fix strategies
+
+## Progress Dashboard
+
+```
+╭────────────────────────────────────────────────────────────╮
+│  🤖 VIBECODE AGENT                                         │
+│                                                            │
+│  Project: e-commerce-platform                              │
+│  Mode: build                                               │
+│                                                            │
+│  [████████████████░░░░░░░░░░░░░░░░░░░░░░]  40%             │
+│                                                            │
+│  ✓ auth                                                    │
+│  ✓ products                                                │
+│  ◐ cart (building...)                                      │
+│  ○ checkout                                                │
+│  ○ admin                                                   │
+│                                                            │
+│  Elapsed: 5m 32s     │  ETA: ~8m remaining                 │
+│                                                            │
+╰────────────────────────────────────────────────────────────╯
+```
+
+## Memory Report
+
+```bash
+vibecode agent --report
+```
+
+Output:
+```markdown
+# Vibecode Agent Memory Report
+
+## Statistics
+- Total builds: 15
+- Success rate: 87%
+- Modules built: 42
+
+## Common Patterns
+- Next.js App Router: 8 times
+- Prisma + PostgreSQL: 5 times
+- Tailwind CSS: 12 times
+
+## Learned Fixes
+- TypeScript strict mode: 3 applications
+- ESLint config: 2 applications
+```
+
+## See Also
+
+- [Agent Mode Guide](../guides/agent-mode) - In-depth guide
+- [go](./go) - For simpler single-module projects
+- [debug](./debug) - For fixing issues

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

@@ -0,0 +1,71 @@
+---
+sidebar_position: 14
+---
+
+# vibecode assist
+
+**Expert Mode** - Direct Claude Code access with project context.
+
+## Synopsis
+
+```bash
+vibecode assist [prompt...] [options]
+```
+
+## Alias
+
+```bash
+vibecode expert [prompt...]
+```
+
+## Description
+
+The `assist` command provides direct access to Claude Code with full project context injected. Use it for quick questions, code explanations, or custom tasks.
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--no-context` | Skip context injection |
+
+## Examples
+
+### Ask a Question
+
+```bash
+vibecode assist "How do I add authentication to this app?"
+```
+
+### Code Explanation
+
+```bash
+vibecode assist "Explain the user service module"
+```
+
+### Custom Task
+
+```bash
+vibecode assist "Add error handling to all API routes"
+```
+
+### Without Context
+
+```bash
+vibecode assist "What is the best way to handle state in React?" --no-context
+```
+
+## Context Injection
+
+By default, `assist` injects project context including:
+
+- Current state and session info
+- Contract and blueprint (if available)
+- Recent build history
+- Error patterns
+
+This helps Claude Code provide more relevant responses.
+
+## See Also
+
+- [debug](./debug) - For bug fixing
+- [go](./go) - For building new features

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

@@ -0,0 +1,53 @@
+---
+sidebar_position: 7
+---
+
+# vibecode build
+
+Manage build process and capture evidence.
+
+## Synopsis
+
+```bash
+vibecode build [options]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-s, --start` | Start build process |
+| `-c, --complete` | Mark build complete |
+| `-e, --evidence` | Capture evidence snapshot |
+| `-a, --auto` | Auto-build with Claude Code |
+| `-i, --iterate` | Build-test-fix loop |
+| `-m, --max <n>` | Max iterations |
+| `--strict` | Exit with error if tests fail |
+| `--provider <name>` | Provider (default: claude-code) |
+
+## Examples
+
+### Manual Build
+
+```bash
+vibecode build --start
+# ... do work ...
+vibecode build --complete
+```
+
+### Auto Build
+
+```bash
+vibecode build --auto
+```
+
+### Iterative Build
+
+```bash
+vibecode build --iterate --max 5
+```
+
+## See Also
+
+- [plan](./plan) - Create plan first
+- [review](./review) - Review after build

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

@@ -0,0 +1,30 @@
+---
+sidebar_position: 10
+---
+
+# vibecode config
+
+Manage Vibecode configuration.
+
+## Synopsis
+
+```bash
+vibecode config [options]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--show` | Show current configuration |
+| `--provider <name>` | Set default AI provider |
+
+## Examples
+
+```bash
+# Show config
+vibecode config --show
+
+# Set provider
+vibecode config --provider claude-code
+```