@nclamvn/vibecode-cli 1.6.0 → 1.8.0

package/docs-site/docs/installation.md

@@ -0,0 +1,98 @@
+---
+sidebar_position: 3
+---
+
+# Installation
+
+Complete guide to installing Vibecode CLI.
+
+## System Requirements
+
+| Requirement | Minimum | Recommended |
+|-------------|---------|-------------|
+| Node.js | 18.0.0 | 20.x LTS |
+| npm | 9.0.0 | Latest |
+| OS | macOS, Linux, Windows | macOS, Linux |
+| RAM | 4 GB | 8 GB+ |
+
+## Install via npm
+
+```bash
+npm install -g @nclamvn/vibecode-cli
+```
+
+## Install Claude Code (Required for AI features)
+
+Vibecode uses Claude Code CLI for AI-powered features:
+
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+
+Set up your Anthropic API key:
+```bash
+export ANTHROPIC_API_KEY="your-api-key"
+```
+
+## Verify Installation
+
+```bash
+# Check Vibecode version
+vibecode --version
+
+# Check Claude Code
+claude --version
+
+# Run doctor to verify setup
+vibecode doctor
+```
+
+## Updating
+
+```bash
+npm update -g @nclamvn/vibecode-cli
+```
+
+## Uninstalling
+
+```bash
+npm uninstall -g @nclamvn/vibecode-cli
+```
+
+## Troubleshooting
+
+### Permission Errors
+
+If you get `EACCES` errors:
+
+```bash
+# Option 1: Use npx
+npx @nclamvn/vibecode-cli
+
+# Option 2: Fix npm permissions
+mkdir ~/.npm-global
+npm config set prefix '~/.npm-global'
+echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
+source ~/.bashrc
+```
+
+### Node.js Version Issues
+
+```bash
+# Check version
+node --version
+
+# Use nvm to install correct version
+nvm install 20
+nvm use 20
+```
+
+### Claude Code Not Found
+
+```bash
+# Verify installation
+which claude
+
+# Reinstall if needed
+npm install -g @anthropic-ai/claude-code
+```

package/docs-site/docs/intro.md

@@ -0,0 +1,67 @@
+---
+sidebar_position: 1
+---
+
+# Introduction
+
+**Vibecode CLI** is a command-line tool that helps you build software with AI assistance while maintaining discipline and control.
+
+## What is Vibecode?
+
+Vibecode provides a structured workflow for AI-assisted software development:
+
+- **Guided Process**: From requirements capture to deployment
+- **AI Integration**: Powered by Claude Code for intelligent code generation
+- **Quality Guardrails**: Built-in testing, review, and rollback capabilities
+- **Learning System**: AI improves from your feedback over time
+
+## Key Features
+
+### Magic Mode (`vibecode go`)
+One command to build an entire project:
+```bash
+vibecode go "Landing page for my SaaS startup"
+```
+
+### Agent Mode (`vibecode agent`)
+Multi-module autonomous building with self-healing:
+```bash
+vibecode agent "E-commerce platform with auth, products, and checkout"
+```
+
+### Debug Mode (`vibecode debug`)
+Intelligent 9-step bug fixing:
+```bash
+vibecode debug "TypeError in user authentication"
+```
+
+### Undo & Learn
+Auto-backup with rollback, and AI that learns from your feedback:
+```bash
+vibecode undo --list
+vibecode learn --stats
+```
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g @nclamvn/vibecode-cli
+
+# Run interactive wizard
+vibecode
+
+# Or start with Magic Mode
+vibecode go "Your project description"
+```
+
+## Requirements
+
+- Node.js 18.0.0 or higher
+- Claude Code CLI (`npm install -g @anthropic-ai/claude-code`)
+
+## Next Steps
+
+- [Getting Started](./getting-started) - First steps with Vibecode
+- [Installation](./installation) - Detailed installation guide
+- [Commands](./commands) - All available commands

package/docs-site/docusaurus.config.ts

@@ -0,0 +1,141 @@
+import {themes as prismThemes} from 'prism-react-renderer';
+import type {Config} from '@docusaurus/types';
+import type * as Preset from '@docusaurus/preset-classic';
+
+const config: Config = {
+  title: 'Vibecode CLI',
+  tagline: 'Build software with discipline - AI coding with guardrails',
+  favicon: 'img/favicon.ico',
+
+  future: {
+    v4: true,
+  },
+
+  url: 'https://vibecode.dev',
+  baseUrl: '/',
+
+  organizationName: 'nclamvn',
+  projectName: 'vibecode-cli',
+
+  onBrokenLinks: 'throw',
+
+  i18n: {
+    defaultLocale: 'en',
+    locales: ['en', 'vi'],
+  },
+
+  presets: [
+    [
+      'classic',
+      {
+        docs: {
+          sidebarPath: './sidebars.ts',
+          editUrl: 'https://github.com/nclamvn/vibecode-cli/tree/main/docs-site/',
+        },
+        blog: false, // Disable blog for now
+        theme: {
+          customCss: './src/css/custom.css',
+        },
+      } satisfies Preset.Options,
+    ],
+  ],
+
+  themeConfig: {
+    image: 'img/vibecode-social-card.png',
+    colorMode: {
+      defaultMode: 'dark',
+      respectPrefersColorScheme: true,
+    },
+    navbar: {
+      title: 'Vibecode',
+      logo: {
+        alt: 'Vibecode Logo',
+        src: 'img/logo.svg',
+      },
+      items: [
+        {
+          type: 'docSidebar',
+          sidebarId: 'docsSidebar',
+          position: 'left',
+          label: 'Docs',
+        },
+        {
+          href: '/docs/commands',
+          label: 'Commands',
+          position: 'left',
+        },
+        {
+          href: 'https://www.npmjs.com/package/@nclamvn/vibecode-cli',
+          label: 'npm',
+          position: 'right',
+        },
+        {
+          href: 'https://github.com/nclamvn/vibecode-cli',
+          label: 'GitHub',
+          position: 'right',
+        },
+      ],
+    },
+    footer: {
+      style: 'dark',
+      links: [
+        {
+          title: 'Documentation',
+          items: [
+            {
+              label: 'Getting Started',
+              to: '/docs/getting-started',
+            },
+            {
+              label: 'Commands',
+              to: '/docs/commands',
+            },
+            {
+              label: 'Configuration',
+              to: '/docs/configuration',
+            },
+          ],
+        },
+        {
+          title: 'Quick Links',
+          items: [
+            {
+              label: 'Magic Mode (go)',
+              to: '/docs/commands/go',
+            },
+            {
+              label: 'Agent Mode',
+              to: '/docs/commands/agent',
+            },
+            {
+              label: 'Debug Mode',
+              to: '/docs/commands/debug',
+            },
+          ],
+        },
+        {
+          title: 'More',
+          items: [
+            {
+              label: 'npm Package',
+              href: 'https://www.npmjs.com/package/@nclamvn/vibecode-cli',
+            },
+            {
+              label: 'GitHub',
+              href: 'https://github.com/nclamvn/vibecode-cli',
+            },
+          ],
+        },
+      ],
+      copyright: `Copyright © ${new Date().getFullYear()} Vibecode. Built with Docusaurus.`,
+    },
+    prism: {
+      theme: prismThemes.github,
+      darkTheme: prismThemes.dracula,
+      additionalLanguages: ['bash', 'json'],
+    },
+    algolia: undefined, // Add Algolia later for search
+  } satisfies Preset.ThemeConfig,
+};
+
+export default config;