@meltstudio/meltctl

CLI tool for Melt's AI-assisted development workflow. Initialize projects with Cursor AI commands and streamline your development process.

🚀 Quick Start

# Install globally via npm
npm install -g @meltstudio/meltctl

# Initialize your project
cd your-project
meltctl project init

📋 What It Does

meltctl sets up your project with:

• .cursor/commands/ - 8 AI-powered Cursor commands for your workflow
• .melt/ - Project templates, memory, and outputs structure

🤖 Cursor AI Commands

After running meltctl project init, you get these commands in Cursor:

Core Workflow Commands

• /melt-plan - Create detailed implementation plans
• /melt-test-plan - Generate test strategy and test files
• /melt-docs - Update project documentation
• /melt-implement - Execute implementation with best practices
• /melt-pr - Create pull request with proper description
• /melt-review - Review code for quality and compliance
• /melt-complete - Complete story and handle deployment

Specialized Commands

• /melt-debug - Systematic debugging with AI assistance

🎯 Usage

Initialize a New Project

# Auto-detect shell type
meltctl project init

# Specify shell type explicitly
meltctl project init --shell sh    # for bash/zsh
meltctl project init --shell ps    # for PowerShell

This command:

• Creates necessary directories using bundled templates
• Installs Cursor command templates from organized template files
• Sets up project structure for AI-assisted development
• Supports both shell (sh/bash/zsh) and PowerShell environments
• Uses fs-extra for robust file operations and template copying

Update Project

meltctl project update

Updates your project templates to the latest version. This command:

• Checks for CLI package updates and prompts to update if available
• Updates .cursor/commands/ with the latest command templates
• Verifies .melt/ workspace migration status
• Handles version compatibility automatically

Clean Project

meltctl project clean

Safely removes all Melt-generated files from your project while preserving user-created content. This command:

• Removes the entire .melt/ directory (all Melt-generated content)
• Selectively removes only Melt commands from .cursor/commands/
• Preserves user-created files in .cursor/commands/
• Provides interactive confirmation before deletion

Version Check

meltctl version --check

Checks for available updates to the meltctl CLI. This command:

• Compares your current version with the latest published version
• Provides update instructions based on your package manager (npm/yarn)
• Handles network errors gracefully

CI/CD Usage

For automated environments (CI/CD pipelines), you can skip the update check that runs before every command:

export MELTCTL_SKIP_UPDATE_CHECK=1
meltctl project init

This environment variable bypasses the automatic update enforcement that normally prevents running commands with outdated versions.

🛠️ Requirements

• Node.js 22+ (works with Node.js 18+ but 22+ recommended)
• Cursor IDE for using the AI commands
• Git repository (recommended)

📚 Documentation

For comprehensive documentation, visit:

• Documentation Site
• Getting Started Guide
• Developer Workflow

🏗️ Project Structure

After initialization, your project will have:

your-project/
├── .cursor/
│   └── commands/         # Cursor AI command templates
│       ├── melt-plan.md
│       ├── melt-test-plan.md
│       ├── melt-docs.md
│       ├── melt-implement.md
│       ├── melt-pr.md
│       ├── melt-review.md
│       ├── melt-complete.md
│       └── melt-debug.md
└── .melt/
    ├── memory/           # Project context and state
    ├── outputs/          # Generated plans and implementations
    │   ├── plans/
    │   ├── implementations/
    │   └── reviews/
    ├── scripts/          # Utility scripts
    └── templates/        # Custom templates

🤝 Contributing

This tool is part of the Melt Development Process. For issues or contributions:

• GitHub Repository
• Report Issues

🏛️ Template Architecture

The CLI uses a bundled template system organized in:

packages/cli/
├── memory/            # Project context and standards
├── scripts/           # Utility scripts for sh and PowerShell
│   ├── sh/            # Bash/zsh utility scripts
│   └── ps/            # PowerShell utility scripts
└── templates/
    └── cursor-commands/ # All 8 Cursor AI command templates

Templates support dynamic content replacement (like timestamps) and are copied to your project during initialization.

📄 License

MIT © Melt Studio

Made with ❤️ by Melt Studio for developers who ship fast without sacrificing quality.