# Install globally (requires Node.js ≥22.0.0)
npm install -g @vibe-dev-kit/cli

# Verify installation
vdk --version

# Install globally with pnpm
pnpm add -g @vibe-dev-kit/cli

# Verify installation
vdk --version

# Install as a dev dependency
npm install --save-dev @vibe-dev-kit/cli

# Or with pnpm
pnpm add -D @vibe-dev-kit/cli

# Run via npx
npx vdk --version

# Or via pnpm
pnpm vdk --version

# Check version
vdk --version

# View help
vdk --help

# List available commands
vdk

VDK CLI v2.0.1: The world's first Vibe Development Kit - Make your AI assistant project-aware
Version: 2.0.1

Commands:
  init         Initialize VDK and generate project-aware blueprints
  update       Update blueprints from VDK-Blueprints repository
  status       Check VDK setup and integration status
  validate     Validate generated rules and configurations
  scan         Re-analyze project and update rules
  integrations Manage AI platform integrations

npm install -g @anthropic-ai/claude-code

# Navigate to your project
cd your-project

# Initialize VDK (interactive mode)
vdk init --interactive

# Check integration status
vdk status --check-integrations

your-project/
├── vdk.config.json          # Main VDK configuration
├── .claude/                 # Claude Code specific files
│   ├── CLAUDE.md           # Main project memory
│   ├── CLAUDE_COMMANDS.md  # Slash command definitions
│   ├── blueprints/         # Selected blueprints
│   └── memory/             # Memory chunks
├── .cursor/                 # Cursor AI specific files
│   └── rules/              # .mdc files with YAML frontmatter
├── .windsurf/              # Windsurf specific files
│   └── rules/              # XML memory files
└── .github/                # GitHub Copilot specific files
    └── copilot/            # JSON guidelines

# GitHub token for blueprint repository access
export VDK_GITHUB_TOKEN=ghp_your_token_here

# Enable debug mode
export VDK_DEBUG=true

# Custom blueprint repository
export VDK_BLUEPRINTS_REPO=your-org/your-blueprints

# Disable telemetry
export VDK_TELEMETRY=false

# Blueprint cache directory
export VDK_CACHE_DIR=~/.vdk/cache

# macOS/Linux: Use npm with --unsafe-perm
sudo npm install -g @vibe-dev-kit/cli --unsafe-perm

# Or configure npm to use a different directory
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

# Check Node.js version
node --version

# Update Node.js using nvm (recommended)
nvm install 22
nvm use 22

# Clear npm cache
npm cache clean --force

# Reinstall
npm uninstall -g @vibe-dev-kit/cli
npm install -g @vibe-dev-kit/cli

# Check all dependencies
vdk status

# Test blueprint fetching
vdk update --verbose

# Verify AI platform integrations
vdk integrations --scan --confidence-threshold medium

# Validate configurations
vdk validate