@meltstudio/meltctl 4.4.0 → 4.5.0

package/README.md

@@ -1,174 +1,48 @@
 # @meltstudio/meltctl
 
-CLI tool for Melt's AI-assisted development workflow. Initialize projects with Cursor AI commands and streamline your development process.
+CLI tool for setting up AI-first development standards in your project.
 
-## 🚀 Quick Start
+## Installation
 
 ```bash
-# 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
-
-```bash
-# 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
+## Usage
 
 ```bash
-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
-
-```bash
-meltctl project clean
-```
+# Authenticate (required)
+meltctl login
 
-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
-
-```bash
-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:
-
-```bash
-export MELTCTL_SKIP_UPDATE_CHECK=1
+# Initialize your project
 meltctl project init
-```
-
-This environment variable bypasses the automatic update enforcement that normally prevents running commands with outdated versions.
 
-## 🛠️ Requirements
+# Select specific tools
+meltctl project init --claude         # Claude Code only
+meltctl project init --cursor         # Cursor only
+meltctl project init --claude --cursor # Both
 
-- Node.js 22+ (works with Node.js 18+ but 22+ recommended)
-- [Cursor IDE](https://cursor.sh) for using the AI commands
-- Git repository (recommended)
+# Re-initialize
+meltctl project init --force
 
-## 📚 Documentation
-
-For comprehensive documentation, visit:
-- [Documentation Site](https://melt-development-prompts.vercel.app)
-- [Getting Started Guide](https://melt-development-prompts.vercel.app/getting-started)
-- [Developer Workflow](https://melt-development-prompts.vercel.app/workflows)
-
-## 🏗️ 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
+# Other commands
+meltctl logout
+meltctl version --check
 ```
 
-## 🤝 Contributing
-
-This tool is part of the Melt Development Process. For issues or contributions:
-- [GitHub Repository](https://github.com/MeltStudio/melt-development-prompts)
-- [Report Issues](https://github.com/MeltStudio/melt-development-prompts/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
-```
+## What Gets Created
 
-Templates support dynamic content replacement (like timestamps) and are copied to your project during initialization.
+- `AGENTS.md` — AI agent instructions and project standards
+- `.claude/settings.json` — Claude Code permissions
+- `.claude/skills/melt-{setup,plan,review,pr,debug}/SKILL.md` — Claude Code workflow skills
+- `.cursor/commands/melt-{setup,plan,review,pr,debug}.md` — Cursor workflow commands
+- `.mcp.json` — MCP server configuration (Chrome DevTools)
 
-## 📄 License
+## Requirements
 
-MIT © Melt Studio
+- Node.js 22+
+- `@meltstudio.co` Google Workspace account
 
----
+## License
 
-Made with ❤️ by [Melt Studio](https://meltstudio.co) for developers who ship fast without sacrificing quality.
+Proprietary. All rights reserved.

package/dist/commands/init.js

@@ -4,6 +4,12 @@ import fs from 'fs-extra';
 import path from 'path';
 import { authenticatedFetch, isAuthenticated } from '../utils/auth.js';
 const SKILL_FRONTMATTER = {
+    setup: `---
+user-invocable: true
+description: Analyze the project and customize AGENTS.md for this codebase
+---
+
+`,
     plan: `---
 user-invocable: true
 description: Design an implementation approach before writing code
@@ -135,7 +141,7 @@ export async function initCommand(options) {
     console.log(chalk.bold('Initializing Melt development tools...'));
     console.log();
     const createdFiles = [];
-    const workflows = ['plan', 'review', 'pr', 'debug'];
+    const workflows = ['setup', 'plan', 'review', 'pr', 'debug'];
     // Shared files (skip on re-init)
     if (!isReInit) {
         const agentsMd = templates['agents-md.md'];
@@ -145,14 +151,9 @@ export async function initCommand(options) {
         }
         const mcpConfig = templates['mcp-configs/base.json'];
         if (mcpConfig) {
-            await fs.writeFile(path.join(cwd, '.mcp.json'), mcpConfig, 'utf-8');
+            await mergeMcpConfig(cwd, mcpConfig);
             createdFiles.push('.mcp.json');
         }
-        const envExample = templates['env-melt-example'];
-        if (envExample) {
-            await fs.writeFile(path.join(cwd, '.env.melt.example'), envExample, 'utf-8');
-            createdFiles.push('.env.melt.example');
-        }
         await updateGitignore(cwd);
     }
     // Claude Code files
@@ -172,7 +173,7 @@ export async function initCommand(options) {
                 await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillContent, 'utf-8');
             }
         }
-        createdFiles.push('.claude/skills/melt-{plan,review,pr,debug}/SKILL.md');
+        createdFiles.push('.claude/skills/melt-{setup,plan,review,pr,debug}/SKILL.md');
     }
     // Cursor files
     if (tools.cursor) {
@@ -183,7 +184,7 @@ export async function initCommand(options) {
                 await fs.writeFile(path.join(cwd, `.cursor/commands/melt-${name}.md`), workflowContent, 'utf-8');
             }
         }
-        createdFiles.push('.cursor/commands/melt-{plan,review,pr,debug}.md');
+        createdFiles.push('.cursor/commands/melt-{setup,plan,review,pr,debug}.md');
     }
     // Print summary
     console.log(chalk.green('Created files:'));
@@ -197,13 +198,13 @@ export async function initCommand(options) {
     }
     if (!isReInit) {
         console.log(chalk.yellow('Next steps:'));
-        console.log(chalk.dim('  1. Run your AI agent — it will automatically fill in project details in AGENTS.md'));
-        console.log(chalk.dim('  2. Copy .env.melt.example to .env.local and fill in credentials'));
-        console.log(chalk.dim('  3. Commit the generated files'));
+        console.log(chalk.dim('  1. Run /setup to customize AGENTS.md for your project'));
+        console.log(chalk.dim('  2. Commit the generated files'));
         console.log();
     }
     if (tools.claude) {
         console.log(chalk.yellow('Available skills (type / in Claude Code to use):'));
+        console.log(chalk.dim('  /setup   — Analyze the project and customize AGENTS.md for this codebase'));
         console.log(chalk.dim('  /plan    — Design an implementation approach before writing code'));
         console.log(chalk.dim('  /review  — Review changes against project standards'));
         console.log(chalk.dim('  /pr      — Create a well-structured pull request'));
@@ -212,6 +213,7 @@ export async function initCommand(options) {
     }
     if (tools.cursor) {
         console.log(chalk.yellow('Available commands (use Cmd+Shift+P in Cursor):'));
+        console.log(chalk.dim('  melt-setup   — Analyze the project and customize AGENTS.md for this codebase'));
         console.log(chalk.dim('  melt-plan    — Design an implementation approach before writing code'));
         console.log(chalk.dim('  melt-review  — Review changes against project standards'));
         console.log(chalk.dim('  melt-pr      — Create a well-structured pull request'));
@@ -220,6 +222,23 @@ export async function initCommand(options) {
     }
     console.log(chalk.green('Done!'));
 }
+async function mergeMcpConfig(cwd, templateContent) {
+    const mcpPath = path.join(cwd, '.mcp.json');
+    const templateConfig = JSON.parse(templateContent);
+    if (await fs.pathExists(mcpPath)) {
+        const existingContent = await fs.readFile(mcpPath, 'utf-8');
+        const existingConfig = JSON.parse(existingContent);
+        // Merge: add our servers without overwriting existing ones
+        existingConfig.mcpServers = {
+            ...existingConfig.mcpServers,
+            ...templateConfig.mcpServers,
+        };
+        await fs.writeFile(mcpPath, JSON.stringify(existingConfig, null, 2) + '\n', 'utf-8');
+    }
+    else {
+        await fs.writeFile(mcpPath, templateContent, 'utf-8');
+    }
+}
 async function updateGitignore(cwd) {
     const gitignorePath = path.join(cwd, '.gitignore');
     let content = '';

package/dist/index.js

@@ -16,7 +16,7 @@ const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'),
 const program = new Command();
 program
     .name('meltctl')
-    .description('Set up AI-first development standards (AGENTS.md, Claude skills, Cursor rules, MCP config) in your project.\n\nRequires a @meltstudio.co Google Workspace account. Run `meltctl login` first, then `meltctl project init` in your repo.')
+    .description('Set up AI-first development standards (AGENTS.md, Claude skills, Cursor commands, MCP config) in your project.\n\nRequires a @meltstudio.co Google Workspace account. Run `meltctl login` first, then `meltctl project init` in your repo.')
     .version(packageJson.version)
     .addHelpText('beforeAll', () => {
     printBanner();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meltstudio/meltctl",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "description": "AI-first development tools for teams - set up AGENTS.md, Claude Code, Cursor, and Copilot standards",
   "main": "dist/index.js",
   "type": "module",
@@ -9,8 +9,7 @@
   },
   "files": [
     "dist/**/*",
-    "README.md",
-    "LICENSE"
+    "README.md"
   ],
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -45,7 +44,7 @@
     "automation"
   ],
   "author": "Melt Studio",
-  "license": "MIT",
+  "license": "UNLICENSED",
   "dependencies": {
     "@commander-js/extra-typings": "^12.1.0",
     "@inquirer/prompts": "^8.2.1",