@theme_zzs/vcmds

CLI tool for managing command templates in Cursor IDE and Windsurf IDE

🎉 v0.2.0 - Now with Built-in Templates!

No internet required! All command templates are included in the package.

Features

• 🚀 Instant installation - No downloads, copy from local templates
• 🌍 Multi-language support - Chinese & English (15 commands each)
• 🎨 Multi-editor support - Cursor and Windsurf
• 📦 Built-in templates - 30 templates included in package
• ⚡ Offline ready - Works without internet connection
• 🔄 Version management - Track installed commands

Installation

npm install -g @theme_zzs/vcmds

Quick Start

# Interactive mode
vcmds init

# Install all Chinese commands for Cursor
vcmds init --lang=cn --editor=cursor --commands=all -y

# Install bilingual commands
vcmds init --lang=both --editor=cursor --commands=all -y

# Preview (dry-run)
vcmds init --dry-run

Available Templates

Development (4 commands)

• build - Build and compile project
• test - Run test suites
• implement - Implement new features
• troubleshoot - Debug and fix issues

Code Quality (3 commands)

• code-review - Review code changes
• refactor-code - Refactor existing code
• cleanup - Clean up codebase

Documentation (3 commands)

• explain-code - Explain code logic
• create-architecture-documentation - Generate architecture docs
• architecture-review - Review architecture design

Project Management (5 commands)

• design - Design technical solutions
• estimate - Estimate workload
• workflow - Define workflows
• brainstorm - Brainstorm ideas
• commit - Generate commit messages

All commands available in both Chinese and English!

Commands

vcmds init

Install command templates to your project.

vcmds init [options]

Options:
  --lang <language>      Language: cn, en, or both
  --editor <editor>      Editor: cursor, windsurf, or both
  --commands <commands>  Commands to install (comma-separated or "all")
  --force                Overwrite existing files
  --dry-run              Preview without installing
  -y, --yes              Skip confirmation prompts

vcmds list

List available or installed commands.

vcmds list [mode]        # mode: available (default) or installed

Options:
  --lang <language>      Filter by language
  --json                 Output in JSON format

vcmds update

Check and update commands (coming soon).

vcmds update [options]

Options:
  --check                Check for updates only
  --self                 Update vcmds itself
  --commands <commands>  Update specific commands

vcmds info

Display project information.

vcmds info [options]

Options:
  --json                 Output in JSON format

Configuration

After running vcmds init, a .vcmds.json file is created:

{
  "version": "1.0.0",
  "installedCommands": [
    {
      "name": "build",
      "version": "1.0.0",
      "lang": "cn",
      "installedAt": "2025-10-20T10:00:00Z",
      "filePath": ".cursor/commands/build.md"
    }
  ],
  "config": {
    "editor": "cursor",
    "defaultLang": "cn",
    "autoUpdate": true,
    "updateSource": "local"
  }
}

How It Works

v0.2.0 (Current) - Local Templates ✅

npm install -g @theme_zzs/vcmds
  ↓
Templates bundled in package (templates/cn/, templates/en/)
  ↓
vcmds init → Copy from local templates → .cursor/commands/
  ↓
✅ Fast, reliable, works offline

v0.1.x (Old) - Remote Download ❌

vcmds init → Download from GitHub → .cursor/commands/
  ↓
❌ Slow, requires internet, can fail

Package Contents

@theme_zzs/vcmds/
├── dist/              # Compiled code
├── templates/         # Built-in templates
│   ├── cn/           # 15 Chinese templates
│   └── en/           # 15 English templates
└── package.json

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Lint & format
npm run lint
npm run format

Changelog

See CHANGELOG.md for version history.

License

MIT © theme_zzs

Links

• npm Package
• GitHub Repository

Enjoy faster, more reliable command template management! 🚀