@meltstudio/meltctl 4.4.1 → 4.5.1

package/README.md

@@ -34,8 +34,8 @@ meltctl version --check
 
 - `AGENTS.md` — AI agent instructions and project standards
 - `.claude/settings.json` — Claude Code permissions
-- `.claude/skills/melt-{plan,review,pr,debug}/SKILL.md` — Claude Code workflow skills
-- `.cursor/commands/melt-{plan,review,pr,debug}.md` — Cursor workflow commands
+- `.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)
 
 ## Requirements

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,7 +151,7 @@ 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');
         }
         await updateGitignore(cwd);
@@ -167,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) {
@@ -178,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:'));
@@ -190,30 +196,50 @@ export async function initCommand(options) {
         console.log(chalk.cyan('Want support for your tool? Let us know in #dev on Slack'));
         console.log();
     }
-    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. 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('  /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'));
-        console.log(chalk.dim('  /debug   — Systematically investigate and fix bugs'));
-        console.log();
+        const skills = '/melt-setup, /melt-plan, /melt-review, /melt-pr, /melt-debug';
+        console.log(chalk.dim(`Available skills: ${skills}`));
     }
     if (tools.cursor) {
-        console.log(chalk.yellow('Available commands (use Cmd+Shift+P in Cursor):'));
-        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'));
-        console.log(chalk.dim('  melt-debug   — Systematically investigate and fix bugs'));
+        console.log(chalk.dim('Available commands: melt-setup, melt-plan, melt-review, melt-pr, melt-debug'));
+    }
+    if (tools.claude || tools.cursor) {
+        console.log();
+    }
+    if (!isReInit) {
+        const setupCmd = tools.claude ? '/melt-setup' : 'melt-setup';
+        const msg = `Next: run ${setupCmd} to customize AGENTS.md for your project`;
+        const pad = 3;
+        const inner = msg.length + pad * 2;
+        const line = '─'.repeat(inner);
+        const space = ' '.repeat(pad);
+        const empty = ' '.repeat(inner);
+        console.log(chalk.bold.cyan(`  ┌${line}┐`));
+        console.log(chalk.bold.cyan(`  │${empty}│`));
+        console.log(chalk.bold.cyan(`  │${space}${msg}${space}│`));
+        console.log(chalk.bold.cyan(`  │${empty}│`));
+        console.log(chalk.bold.cyan(`  └${line}┘`));
         console.log();
     }
     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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meltstudio/meltctl",
-  "version": "4.4.1",
+  "version": "4.5.1",
   "description": "AI-first development tools for teams - set up AGENTS.md, Claude Code, Cursor, and Copilot standards",
   "main": "dist/index.js",
   "type": "module",