@nclamvn/vibecode-cli 1.7.0 → 1.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/SESSION_NOTES.md +119 -0
  2. package/bin/vibecode.js +53 -0
  3. package/package.json +1 -1
  4. package/src/commands/ask.js +230 -0
  5. package/src/commands/docs.js +167 -0
  6. package/src/commands/git.js +103 -2
  7. package/src/commands/migrate.js +341 -0
  8. package/src/commands/refactor.js +205 -0
  9. package/src/commands/review.js +126 -1
  10. package/src/commands/security.js +229 -0
  11. package/src/commands/test.js +194 -0
  12. package/src/config/constants.js +5 -1
  13. package/src/index.js +8 -0
  14. package/docs-site/README.md +0 -41
  15. package/docs-site/blog/2019-05-28-first-blog-post.md +0 -12
  16. package/docs-site/blog/2019-05-29-long-blog-post.md +0 -44
  17. package/docs-site/blog/2021-08-01-mdx-blog-post.mdx +0 -24
  18. package/docs-site/blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg +0 -0
  19. package/docs-site/blog/2021-08-26-welcome/index.md +0 -29
  20. package/docs-site/blog/authors.yml +0 -25
  21. package/docs-site/blog/tags.yml +0 -19
  22. package/docs-site/docs/commands/agent.md +0 -162
  23. package/docs-site/docs/commands/assist.md +0 -71
  24. package/docs-site/docs/commands/build.md +0 -53
  25. package/docs-site/docs/commands/config.md +0 -30
  26. package/docs-site/docs/commands/debug.md +0 -173
  27. package/docs-site/docs/commands/doctor.md +0 -34
  28. package/docs-site/docs/commands/go.md +0 -128
  29. package/docs-site/docs/commands/index.md +0 -79
  30. package/docs-site/docs/commands/init.md +0 -42
  31. package/docs-site/docs/commands/learn.md +0 -82
  32. package/docs-site/docs/commands/lock.md +0 -33
  33. package/docs-site/docs/commands/plan.md +0 -29
  34. package/docs-site/docs/commands/review.md +0 -31
  35. package/docs-site/docs/commands/snapshot.md +0 -34
  36. package/docs-site/docs/commands/start.md +0 -32
  37. package/docs-site/docs/commands/status.md +0 -37
  38. package/docs-site/docs/commands/undo.md +0 -83
  39. package/docs-site/docs/configuration.md +0 -72
  40. package/docs-site/docs/faq.md +0 -83
  41. package/docs-site/docs/getting-started.md +0 -119
  42. package/docs-site/docs/guides/agent-mode.md +0 -94
  43. package/docs-site/docs/guides/debug-mode.md +0 -83
  44. package/docs-site/docs/guides/magic-mode.md +0 -107
  45. package/docs-site/docs/installation.md +0 -98
  46. package/docs-site/docs/intro.md +0 -67
  47. package/docs-site/docusaurus.config.ts +0 -141
  48. package/docs-site/package-lock.json +0 -18039
  49. package/docs-site/package.json +0 -48
  50. package/docs-site/sidebars.ts +0 -70
  51. package/docs-site/src/components/HomepageFeatures/index.tsx +0 -72
  52. package/docs-site/src/components/HomepageFeatures/styles.module.css +0 -16
  53. package/docs-site/src/css/custom.css +0 -30
  54. package/docs-site/src/pages/index.module.css +0 -23
  55. package/docs-site/src/pages/index.tsx +0 -44
  56. package/docs-site/src/pages/markdown-page.md +0 -7
  57. package/docs-site/src/theme/Footer/index.tsx +0 -127
  58. package/docs-site/src/theme/Footer/styles.module.css +0 -285
  59. package/docs-site/static/.nojekyll +0 -0
  60. package/docs-site/static/img/docusaurus-social-card.jpg +0 -0
  61. package/docs-site/static/img/docusaurus.png +0 -0
  62. package/docs-site/static/img/favicon.ico +0 -0
  63. package/docs-site/static/img/logo.svg +0 -1
  64. package/docs-site/static/img/undraw_docusaurus_mountain.svg +0 -171
  65. package/docs-site/static/img/undraw_docusaurus_react.svg +0 -170
  66. package/docs-site/static/img/undraw_docusaurus_tree.svg +0 -40
  67. package/docs-site/tsconfig.json +0 -8
@@ -1,128 +0,0 @@
1
- ---
2
- sidebar_position: 11
3
- ---
4
-
5
- # vibecode go
6
-
7
- **Magic Mode** - Build an entire project with one command.
8
-
9
- ## Synopsis
10
-
11
- ```bash
12
- vibecode go <description> [options]
13
- ```
14
-
15
- ## Description
16
-
17
- The `go` command is Vibecode's "magic mode" - it takes a natural language description and builds a complete project automatically. It combines all workflow steps into one seamless experience.
18
-
19
- ## Arguments
20
-
21
- | Argument | Description |
22
- |----------|-------------|
23
- | `description` | Natural language description of what to build |
24
-
25
- ## Options
26
-
27
- | Option | Description |
28
- |--------|-------------|
29
- | `-t, --template <name>` | Use template (landing, saas, cli, api) |
30
- | `-i, --iterate` | Enable iterative build mode |
31
- | `-m, --max <n>` | Max iterations for iterative mode |
32
- | `-o, --open` | Auto-open result when done |
33
-
34
- ## Examples
35
-
36
- ### Basic Usage
37
-
38
- ```bash
39
- vibecode go "A landing page for my SaaS startup"
40
- ```
41
-
42
- ### With Template
43
-
44
- ```bash
45
- vibecode go "Portfolio website" --template landing
46
- ```
47
-
48
- ### Iterative Mode
49
-
50
- Build, test, and fix until tests pass:
51
-
52
- ```bash
53
- vibecode go "React todo app with tests" --iterate --max 5
54
- ```
55
-
56
- ### Auto-Open Result
57
-
58
- ```bash
59
- vibecode go "Simple blog" --open
60
- ```
61
-
62
- ## What Happens
63
-
64
- When you run `go`, Vibecode automatically:
65
-
66
- 1. **INIT** - Creates project directory
67
- 2. **INTAKE** - Captures requirements from description
68
- 3. **BLUEPRINT** - Designs architecture
69
- 4. **CONTRACT** - Generates contract
70
- 5. **LOCK** - Locks contract with spec hash
71
- 6. **PLAN** - Creates execution plan
72
- 7. **BUILD** - Generates code with Claude Code
73
- 8. **REVIEW** - Runs tests and validates
74
-
75
- ## Progress Display
76
-
77
- ```
78
- ╭────────────────────────────────────────────────────────────╮
79
- │ 🚀 VIBECODE MAGIC MODE │
80
- │ │
81
- │ "Landing page for my startup" │
82
- │ → startup-landing │
83
- │ │
84
- ╰────────────────────────────────────────────────────────────╯
85
-
86
- [████████████████████░░░░░░░░░░░░░░░░░░░░] 45%
87
-
88
- ✓ INIT
89
- ✓ INTAKE
90
- ✓ BLUEPRINT
91
- ✓ CONTRACT
92
- ✓ LOCK
93
- ◐ PLAN (in progress)
94
- ○ BUILD
95
- ○ REVIEW
96
- ```
97
-
98
- ## Output
99
-
100
- On success:
101
-
102
- ```
103
- ╭────────────────────────────────────────────────────────────╮
104
- │ 🎉 BUILD COMPLETE! │
105
- │ │
106
- │ 📁 Project: startup-landing │
107
- │ 📂 Location: /Users/you/startup-landing │
108
- │ 🔐 Spec: abc123... │
109
- │ 📄 Files: 12 created │
110
- │ 🧪 Tests: 8/8 passed │
111
- │ ⏱️ Duration: 2.5 minutes │
112
- │ │
113
- │ 💡 Next: cd startup-landing │
114
- │ │
115
- ╰────────────────────────────────────────────────────────────╯
116
- ```
117
-
118
- ## Tips
119
-
120
- - **Be specific**: More detail = better results
121
- - **Mention tech stack**: "React app with Tailwind" vs just "website"
122
- - **Include features**: "with auth, dashboard, and API"
123
-
124
- ## See Also
125
-
126
- - [Magic Mode Guide](../guides/magic-mode) - In-depth guide
127
- - [agent](./agent) - For complex multi-module projects
128
- - [build](./build) - For step-by-step control
@@ -1,79 +0,0 @@
1
- ---
2
- sidebar_position: 1
3
- ---
4
-
5
- # Commands Overview
6
-
7
- Vibecode CLI provides 16 commands organized into four categories.
8
-
9
- ## Quick Reference
10
-
11
- | Command | Description | Example |
12
- |---------|-------------|---------|
13
- | `go` | Magic mode - one command build | `vibecode go "todo app"` |
14
- | `agent` | Multi-module autonomous build | `vibecode agent "e-commerce"` |
15
- | `debug` | Intelligent bug fixing | `vibecode debug "TypeError..."` |
16
- | `assist` | Direct AI assistance | `vibecode assist "how to..."` |
17
-
18
- ## Categories
19
-
20
- ### Workflow Commands
21
-
22
- Setup and state management:
23
-
24
- | Command | Description |
25
- |---------|-------------|
26
- | [`init`](./init) | Initialize Vibecode workspace |
27
- | [`start`](./start) | Start guided session |
28
- | [`status`](./status) | Display current state |
29
- | [`lock`](./lock) | Lock contract and generate spec hash |
30
- | [`doctor`](./doctor) | Check configuration |
31
-
32
- ### Build Commands
33
-
34
- Code generation and review:
35
-
36
- | Command | Description |
37
- |---------|-------------|
38
- | [`plan`](./plan) | Create execution plan |
39
- | [`build`](./build) | Build with AI |
40
- | [`review`](./review) | Review against criteria |
41
- | [`snapshot`](./snapshot) | Create release snapshot |
42
- | [`config`](./config) | Manage configuration |
43
-
44
- ### Power Features
45
-
46
- Advanced AI capabilities:
47
-
48
- | Command | Description |
49
- |---------|-------------|
50
- | [`go`](./go) | Magic mode - full automated build |
51
- | [`agent`](./agent) | Multi-module autonomous builder |
52
- | [`debug`](./debug) | 9-step intelligent debugging |
53
- | [`assist`](./assist) | Direct Claude Code access |
54
-
55
- ### Polish Features
56
-
57
- UX improvements:
58
-
59
- | Command | Description |
60
- |---------|-------------|
61
- | [`undo`](./undo) | Rollback to previous state |
62
- | [`learn`](./learn) | View AI learning stats |
63
-
64
- ## Global Options
65
-
66
- All commands support:
67
-
68
- ```bash
69
- --help, -h Show help
70
- --version, -V Show version
71
- ```
72
-
73
- ## Interactive Mode
74
-
75
- Run `vibecode` with no arguments for interactive wizard:
76
-
77
- ```bash
78
- vibecode
79
- ```
@@ -1,42 +0,0 @@
1
- ---
2
- sidebar_position: 1
3
- ---
4
-
5
- # vibecode init
6
-
7
- Initialize a Vibecode workspace in the current directory.
8
-
9
- ## Synopsis
10
-
11
- ```bash
12
- vibecode init [options]
13
- ```
14
-
15
- ## Options
16
-
17
- | Option | Description |
18
- |--------|-------------|
19
- | `-f, --force` | Overwrite existing workspace |
20
- | `-q, --quiet` | Minimal output |
21
-
22
- ## Examples
23
-
24
- ```bash
25
- # Basic initialization
26
- vibecode init
27
-
28
- # Force overwrite existing
29
- vibecode init --force
30
- ```
31
-
32
- ## What It Does
33
-
34
- 1. Creates `.vibecode/` directory
35
- 2. Initializes `state.json`
36
- 3. Creates session structure
37
- 4. Sets initial state to `initialized`
38
-
39
- ## See Also
40
-
41
- - [start](./start) - Start guided session
42
- - [status](./status) - Check current state
@@ -1,82 +0,0 @@
1
- ---
2
- sidebar_position: 16
3
- ---
4
-
5
- # vibecode learn
6
-
7
- View and manage AI learnings from feedback.
8
-
9
- ## Synopsis
10
-
11
- ```bash
12
- vibecode learn [options]
13
- ```
14
-
15
- ## Options
16
-
17
- | Option | Description |
18
- |--------|-------------|
19
- | `-s, --stats` | Show learning statistics |
20
- | `-c, --clear` | Clear all learnings |
21
- | `-e, --export` | Export learnings to file |
22
- | `-f, --force` | Skip confirmation |
23
-
24
- ## Examples
25
-
26
- ### View Statistics
27
-
28
- ```bash
29
- vibecode learn --stats
30
- ```
31
-
32
- Output:
33
- ```
34
- ╭────────────────────────────────────────────────────────────╮
35
- │ 📊 LEARNING STATISTICS │
36
- ╰────────────────────────────────────────────────────────────╯
37
-
38
- 📁 Project Learnings
39
- Tổng fixes: 15
40
- Thành công: 12 (80%)
41
-
42
- 🌍 Global Learnings
43
- Tổng fixes: 45
44
- Thành công: 38 (84.4%)
45
-
46
- 📂 Theo Error Category
47
- RUNTIME ██████████ 5/5 (100%)
48
- SYNTAX ████████░░ 4/5 (80%)
49
- MODULE ██████░░░░ 3/5 (60%)
50
-
51
- ⚙️ Preferences đã lưu: 3
52
- 📅 Learning gần nhất: 10 phút trước
53
- ```
54
-
55
- ### Export Learnings
56
-
57
- ```bash
58
- vibecode learn --export
59
- ```
60
-
61
- ### Clear Learnings
62
-
63
- ```bash
64
- vibecode learn --clear --force
65
- ```
66
-
67
- ## How Learning Works
68
-
69
- 1. After each successful fix, Vibecode asks for feedback
70
- 2. Feedback is stored locally and globally (anonymized)
71
- 3. Future suggestions use past successes
72
- 4. Higher confidence for patterns with good track record
73
-
74
- ## Storage
75
-
76
- - Local: `.vibecode/learning/`
77
- - Global: `~/.vibecode/learning/`
78
-
79
- ## See Also
80
-
81
- - [debug](./debug) - Generates learnings
82
- - [assist](./assist) - Uses learnings
@@ -1,33 +0,0 @@
1
- ---
2
- sidebar_position: 4
3
- ---
4
-
5
- # vibecode lock
6
-
7
- Lock contract and generate spec hash.
8
-
9
- ## Synopsis
10
-
11
- ```bash
12
- vibecode lock [options]
13
- ```
14
-
15
- ## Options
16
-
17
- | Option | Description |
18
- |--------|-------------|
19
- | `-d, --dry-run` | Validate without locking |
20
- | `-f, --force` | Lock even with warnings |
21
-
22
- ## Description
23
-
24
- Locking a contract:
25
- 1. Validates contract completeness
26
- 2. Generates unique spec hash
27
- 3. Prevents further contract changes
28
- 4. Enables build phase
29
-
30
- ## See Also
31
-
32
- - [start](./start) - Create contract
33
- - [build](./build) - Build from locked contract
@@ -1,29 +0,0 @@
1
- ---
2
- sidebar_position: 6
3
- ---
4
-
5
- # vibecode plan
6
-
7
- Create execution plan from locked contract.
8
-
9
- ## Synopsis
10
-
11
- ```bash
12
- vibecode plan
13
- ```
14
-
15
- ## Description
16
-
17
- Generates:
18
- 1. Step-by-step execution plan
19
- 2. Coder pack for Claude Code
20
- 3. File structure preview
21
-
22
- ## Prerequisites
23
-
24
- - Contract must be locked (`vibecode lock`)
25
-
26
- ## See Also
27
-
28
- - [lock](./lock) - Lock contract first
29
- - [build](./build) - Execute the plan
@@ -1,31 +0,0 @@
1
- ---
2
- sidebar_position: 8
3
- ---
4
-
5
- # vibecode review
6
-
7
- Review build against acceptance criteria.
8
-
9
- ## Synopsis
10
-
11
- ```bash
12
- vibecode review [options]
13
- ```
14
-
15
- ## Options
16
-
17
- | Option | Description |
18
- |--------|-------------|
19
- | `--skip-manual` | Skip manual verification |
20
-
21
- ## Description
22
-
23
- Runs:
24
- 1. Automated tests
25
- 2. Acceptance criteria check
26
- 3. Manual verification prompts (optional)
27
-
28
- ## See Also
29
-
30
- - [build](./build) - Build first
31
- - [snapshot](./snapshot) - Create release
@@ -1,34 +0,0 @@
1
- ---
2
- sidebar_position: 9
3
- ---
4
-
5
- # vibecode snapshot
6
-
7
- Create release snapshot with version bump.
8
-
9
- ## Synopsis
10
-
11
- ```bash
12
- vibecode snapshot [options]
13
- ```
14
-
15
- ## Options
16
-
17
- | Option | Description |
18
- |--------|-------------|
19
- | `--patch` | Patch version (default) |
20
- | `--minor` | Minor version |
21
- | `--major` | Major version |
22
-
23
- ## Examples
24
-
25
- ```bash
26
- # Patch release (1.0.0 -> 1.0.1)
27
- vibecode snapshot
28
-
29
- # Minor release (1.0.0 -> 1.1.0)
30
- vibecode snapshot --minor
31
-
32
- # Major release (1.0.0 -> 2.0.0)
33
- vibecode snapshot --major
34
- ```
@@ -1,32 +0,0 @@
1
- ---
2
- sidebar_position: 2
3
- ---
4
-
5
- # vibecode start
6
-
7
- Start a guided Vibecode session.
8
-
9
- ## Synopsis
10
-
11
- ```bash
12
- vibecode start [options]
13
- ```
14
-
15
- ## Options
16
-
17
- | Option | Description |
18
- |--------|-------------|
19
- | `-r, --resume` | Resume existing session |
20
-
21
- ## Description
22
-
23
- Launches an interactive session that guides you through:
24
- 1. Requirements capture (intake)
25
- 2. Architecture design (blueprint)
26
- 3. Contract creation
27
- 4. Contract locking
28
-
29
- ## See Also
30
-
31
- - [init](./init) - Initialize workspace
32
- - [lock](./lock) - Lock contract
@@ -1,37 +0,0 @@
1
- ---
2
- sidebar_position: 3
3
- ---
4
-
5
- # vibecode status
6
-
7
- Display current state and progress.
8
-
9
- ## Synopsis
10
-
11
- ```bash
12
- vibecode status [options]
13
- ```
14
-
15
- ## Options
16
-
17
- | Option | Description |
18
- |--------|-------------|
19
- | `--json` | Output as JSON |
20
- | `-v, --verbose` | Show detailed info |
21
-
22
- ## Examples
23
-
24
- ```bash
25
- # Basic status
26
- vibecode status
27
-
28
- # JSON output
29
- vibecode status --json
30
-
31
- # Detailed info
32
- vibecode status --verbose
33
- ```
34
-
35
- ## See Also
36
-
37
- - [doctor](./doctor) - Check configuration
@@ -1,83 +0,0 @@
1
- ---
2
- sidebar_position: 15
3
- ---
4
-
5
- # vibecode undo
6
-
7
- Undo/rollback to previous state.
8
-
9
- ## Synopsis
10
-
11
- ```bash
12
- vibecode undo [options]
13
- ```
14
-
15
- ## Options
16
-
17
- | Option | Description |
18
- |--------|-------------|
19
- | `-l, --list` | List available backups |
20
- | `-s, --step <n>` | Restore to N steps ago |
21
- | `-c, --clear` | Clear all backups |
22
- | `-f, --force` | Skip confirmation |
23
-
24
- ## Examples
25
-
26
- ### List Backups
27
-
28
- ```bash
29
- vibecode undo --list
30
- ```
31
-
32
- Output:
33
- ```
34
- ╭────────────────────────────────────────────────────────────╮
35
- │ 📦 BACKUP HISTORY │
36
- ╰────────────────────────────────────────────────────────────╯
37
-
38
- 1. build-auto
39
- 5 phút trước · 12 files
40
-
41
- 2. agent-build
42
- 1 giờ trước · 8 files
43
-
44
- Chạy vibecode undo để restore
45
- ```
46
-
47
- ### Interactive Restore
48
-
49
- ```bash
50
- vibecode undo
51
- ```
52
-
53
- ### Restore Specific Step
54
-
55
- ```bash
56
- vibecode undo --step 2
57
- ```
58
-
59
- ### Force Restore
60
-
61
- ```bash
62
- vibecode undo --step 1 --force
63
- ```
64
-
65
- ## How Backups Work
66
-
67
- Backups are created automatically before:
68
- - `vibecode build --auto`
69
- - `vibecode agent`
70
- - `vibecode go`
71
-
72
- Stored in `.vibecode/backups/` with:
73
- - File content snapshots
74
- - MD5 hash verification
75
- - Manifest for restore
76
-
77
- Last 10 backups are kept.
78
-
79
- ## See Also
80
-
81
- - [build](./build) - Triggers backup
82
- - [agent](./agent) - Triggers backup
83
- - [go](./go) - Triggers backup
@@ -1,72 +0,0 @@
1
- ---
2
- sidebar_position: 7
3
- ---
4
-
5
- # Configuration
6
-
7
- Customize Vibecode behavior to fit your workflow.
8
-
9
- ## Configuration Files
10
-
11
- ### `.vibecode/state.json`
12
-
13
- Project-level state:
14
-
15
- ```json
16
- {
17
- "currentState": "initialized",
18
- "projectName": "my-project",
19
- "spec_hash": "abc123...",
20
- "created": "2024-01-01T00:00:00Z"
21
- }
22
- ```
23
-
24
- ### `~/.vibecode/config.json`
25
-
26
- Global configuration:
27
-
28
- ```json
29
- {
30
- "defaultProvider": "claude-code",
31
- "preferredLanguage": "vi",
32
- "autoBackup": true
33
- }
34
- ```
35
-
36
- ## Environment Variables
37
-
38
- | Variable | Description |
39
- |----------|-------------|
40
- | `ANTHROPIC_API_KEY` | API key for Claude |
41
- | `VIBECODE_PROVIDER` | Override default provider |
42
- | `VIBECODE_DEBUG` | Enable debug logging |
43
-
44
- ## Provider Configuration
45
-
46
- ```bash
47
- # Set default provider
48
- vibecode config --provider claude-code
49
-
50
- # View current config
51
- vibecode config --show
52
- ```
53
-
54
- ## Backup Settings
55
-
56
- Backups are created automatically before:
57
- - Auto builds
58
- - Agent builds
59
- - Magic mode
60
-
61
- Stored in `.vibecode/backups/` (last 10 kept).
62
-
63
- ## Learning Settings
64
-
65
- Learnings stored in:
66
- - Local: `.vibecode/learning/`
67
- - Global: `~/.vibecode/learning/`
68
-
69
- Clear with:
70
- ```bash
71
- vibecode learn --clear
72
- ```