@meltstudio/meltctl 4.22.0 → 4.23.1

package/README.md

@@ -20,7 +20,8 @@ meltctl project init
 # Select specific tools
 meltctl project init --claude         # Claude Code only
 meltctl project init --cursor         # Cursor only
-meltctl project init --claude --cursor # Both
+meltctl project init --opencode       # OpenCode only
+meltctl project init --claude --cursor --opencode # All tools
 
 # Re-initialize
 meltctl project init --force
@@ -49,6 +50,7 @@ meltctl version --check
 - `.claude/settings.json` — Claude Code permissions
 - `.claude/skills/melt-{setup,plan,...,update}/SKILL.md` — Claude Code workflow skills
 - `.cursor/commands/melt-{setup,plan,...,update}.md` — Cursor workflow commands
+- `.opencode/commands/melt-{setup,plan,...,update}.md` — OpenCode workflow commands
 - `.mcp.json` — MCP server configuration (Chrome DevTools)
 
 ## Requirements

package/dist/commands/init.d.ts

@@ -2,6 +2,7 @@ interface InitOptions {
     force?: boolean;
     claude?: boolean;
     cursor?: boolean;
+    opencode?: boolean;
 }
 export declare function initCommand(options: InitOptions): Promise<void>;
 export {};

package/dist/commands/init.js

@@ -96,6 +96,53 @@ description: >-
   This is a reference skill — it explains the process, not executes it.
 ---
 
+`,
+};
+const OPENCODE_COMMAND_FRONTMATTER = {
+    setup: `---
+description: Analyze the project and customize AGENTS.md for this codebase.
+---
+
+`,
+    plan: `---
+description: Design an implementation approach before writing code.
+---
+
+`,
+    review: `---
+description: Review code changes against project standards and address PR feedback.
+---
+
+`,
+    pr: `---
+description: Create a well-structured pull request from current changes.
+---
+
+`,
+    debug: `---
+description: Systematically investigate and fix bugs.
+---
+
+`,
+    audit: `---
+description: Run a comprehensive project compliance audit against team standards.
+---
+
+`,
+    validate: `---
+description: Run the validation plan from the plan document after implementation.
+---
+
+`,
+    update: `---
+description: Update Melt skills and standards to the latest version.
+---
+
+`,
+    help: `---
+description: Answer questions about the AI-First Development Playbook and team workflow.
+---
+
 `,
 };
 const GITIGNORE_ENTRIES = ['.env.local', '.claude/settings.local.json'];
@@ -103,6 +150,7 @@ function detectExistingTools(cwd) {
     return {
         claude: fs.pathExistsSync(path.join(cwd, '.claude/settings.json')),
         cursor: fs.pathExistsSync(path.join(cwd, '.cursor/commands')),
+        opencode: fs.pathExistsSync(path.join(cwd, '.opencode/commands')),
     };
 }
 async function promptToolSelection(existingTools) {
@@ -113,6 +161,9 @@ async function promptToolSelection(existingTools) {
     if (!existingTools?.cursor) {
         choices.push({ name: 'Cursor', value: 'cursor', checked: true });
     }
+    if (!existingTools?.opencode) {
+        choices.push({ name: 'OpenCode', value: 'opencode', checked: true });
+    }
     choices.push({
         name: 'Other — contact us in #dev on Slack to request support',
         value: 'other',
@@ -124,6 +175,7 @@ async function promptToolSelection(existingTools) {
     return {
         claude: selected.includes('claude'),
         cursor: selected.includes('cursor'),
+        opencode: selected.includes('opencode'),
         other: selected.includes('other'),
     };
 }
@@ -156,18 +208,27 @@ export async function initCommand(options) {
     if (alreadyInitialized && !options.force) {
         // Re-init scenario: project already set up, developer wants to add another tool
         const existing = detectExistingTools(cwd);
-        const existingNames = [existing.claude ? 'Claude Code' : '', existing.cursor ? 'Cursor' : '']
+        const existingNames = [
+            existing.claude ? 'Claude Code' : '',
+            existing.cursor ? 'Cursor' : '',
+            existing.opencode ? 'OpenCode' : '',
+        ]
             .filter(Boolean)
-            .join(' and ');
-        if (existing.claude && existing.cursor) {
-            console.log(chalk.yellow('Project already initialized with Claude Code and Cursor. Use --force to overwrite.'));
+            .join(', ');
+        if (existing.claude && existing.cursor && existing.opencode) {
+            console.log(chalk.yellow('Project already initialized with all tools. Use --force to overwrite.'));
             process.exit(1);
         }
         console.log(chalk.dim(`Project already initialized${existingNames ? ` with ${existingNames}` : ''}.`));
         isReInit = true;
-        if (options.claude || options.cursor) {
+        if (options.claude || options.cursor || options.opencode) {
             // Non-interactive: use flags directly, skip confirm prompt
-            tools = { claude: !!options.claude, cursor: !!options.cursor, other: false };
+            tools = {
+                claude: !!options.claude,
+                cursor: !!options.cursor,
+                opencode: !!options.opencode,
+                other: false,
+            };
         }
         else {
             const addMore = await confirm({
@@ -182,14 +243,19 @@ export async function initCommand(options) {
     }
     else {
         // Fresh init or --force
-        if (options.claude || options.cursor) {
-            tools = { claude: !!options.claude, cursor: !!options.cursor, other: false };
+        if (options.claude || options.cursor || options.opencode) {
+            tools = {
+                claude: !!options.claude,
+                cursor: !!options.cursor,
+                opencode: !!options.opencode,
+                other: false,
+            };
         }
         else {
             tools = await promptToolSelection();
         }
     }
-    if (!tools.claude && !tools.cursor && !tools.other) {
+    if (!tools.claude && !tools.cursor && !tools.opencode && !tools.other) {
         console.log(chalk.yellow('No tools selected. Nothing to do.'));
         process.exit(0);
     }
@@ -267,6 +333,18 @@ export async function initCommand(options) {
         }
         createdFiles.push('.cursor/commands/melt-{setup,plan,validate,review,pr,debug,audit,update,help}.md');
     }
+    // OpenCode files
+    if (tools.opencode) {
+        await fs.ensureDir(path.join(cwd, '.opencode/commands'));
+        for (const name of workflows) {
+            const workflowContent = templates[`workflows/${name}.md`];
+            if (workflowContent) {
+                const commandContent = OPENCODE_COMMAND_FRONTMATTER[name] + workflowContent;
+                await fs.writeFile(path.join(cwd, `.opencode/commands/melt-${name}.md`), commandContent, 'utf-8');
+            }
+        }
+        createdFiles.push('.opencode/commands/melt-{setup,plan,validate,review,pr,debug,audit,update,help}.md');
+    }
     // Print summary
     console.log(chalk.green('Created files:'));
     for (const file of createdFiles) {
@@ -277,35 +355,58 @@ export async function initCommand(options) {
         console.log(chalk.cyan('Want support for your tool? Let us know in #dev on Slack'));
         console.log();
     }
+    const commandNames = 'melt-setup, melt-plan, melt-validate, melt-review, melt-pr, melt-debug, melt-audit, melt-update, melt-help';
     if (tools.claude) {
-        const skills = '/melt-setup, /melt-plan, /melt-validate, /melt-review, /melt-pr, /melt-debug, /melt-audit, /melt-update, /melt-help';
-        console.log(chalk.dim(`Available skills: ${skills}`));
+        console.log(chalk.dim(`Available skills: /${commandNames.replace(/, /g, ', /')}`));
     }
     if (tools.cursor) {
-        console.log(chalk.dim('Available commands: melt-setup, melt-plan, melt-validate, melt-review, melt-pr, melt-debug, melt-audit, melt-update, melt-help'));
+        console.log(chalk.dim(`Available Cursor commands: ${commandNames}`));
+    }
+    if (tools.opencode) {
+        console.log(chalk.dim(`Available OpenCode commands: /${commandNames.replace(/, /g, ', /')}`));
     }
-    if (tools.claude || tools.cursor) {
+    if (tools.claude || tools.cursor || tools.opencode) {
         console.log();
     }
     if (!isReInit) {
         console.log(chalk.bold.cyan('  Next step: run /melt-setup to customize AGENTS.md for your project'));
         console.log();
-        if (tools.claude && tools.cursor) {
-            console.log(chalk.dim('  Claude Code:'));
-            console.log(chalk.dim('    - Type /melt-setup in the chat prompt, or'));
-            console.log(chalk.dim('    - Open the skills menu and select melt-setup'));
-            console.log();
-            console.log(chalk.dim('  Cursor:'));
-            console.log(chalk.dim('    - Open the command menu (Cmd+K) and search for melt-setup'));
+        const toolInstructions = [];
+        if (tools.claude) {
+            toolInstructions.push({
+                name: 'Claude Code',
+                steps: [
+                    'Type /melt-setup in the chat prompt, or',
+                    'Open the skills menu and select melt-setup',
+                ],
+            });
         }
-        else if (tools.claude) {
-            console.log(chalk.dim('  In Claude Code:'));
-            console.log(chalk.dim('    - Type /melt-setup in the chat prompt, or'));
-            console.log(chalk.dim('    - Open the skills menu and select melt-setup'));
+        if (tools.cursor) {
+            toolInstructions.push({
+                name: 'Cursor',
+                steps: ['Open the command menu (Cmd+K) and search for melt-setup'],
+            });
+        }
+        if (tools.opencode) {
+            toolInstructions.push({
+                name: 'OpenCode',
+                steps: ['Type /melt-setup in the chat prompt'],
+            });
+        }
+        if (toolInstructions.length === 1 && toolInstructions[0]) {
+            console.log(chalk.dim(`  In ${toolInstructions[0].name}:`));
+            for (const step of toolInstructions[0].steps) {
+                console.log(chalk.dim(`    - ${step}`));
+            }
         }
         else {
-            console.log(chalk.dim('  In Cursor:'));
-            console.log(chalk.dim('    - Open the command menu (Cmd+K) and search for melt-setup'));
+            for (const tool of toolInstructions) {
+                console.log(chalk.dim(`  ${tool.name}:`));
+                for (const step of tool.steps) {
+                    console.log(chalk.dim(`    - ${step}`));
+                }
+                console.log();
+            }
         }
         console.log();
         console.log(chalk.dim('  The setup skill will analyze your project and fill in AGENTS.md.'));

package/dist/index.js

@@ -21,7 +21,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 commands, MCP config) in your project.\n\nRequires a @meltstudio.co Google Workspace account. Run `npx @meltstudio/meltctl@latest login` first, then `npx @meltstudio/meltctl@latest project init` in your repo.')
+    .description('Set up AI-first development standards (AGENTS.md, Claude skills, Cursor commands, OpenCode commands, MCP config) in your project.\n\nRequires a @meltstudio.co Google Workspace account. Run `npx @meltstudio/meltctl@latest login` first, then `npx @meltstudio/meltctl@latest project init` in your repo.')
     .version(packageJson.version)
     .addHelpText('beforeAll', () => {
     printBanner();
@@ -45,12 +45,18 @@ program
 const project = program.command('project').description('manage project configuration');
 project
     .command('init')
-    .description('scaffold Melt development tools into the current directory (AGENTS.md, .claude/, .cursor/, .mcp.json)')
+    .description('scaffold Melt development tools into the current directory (AGENTS.md, .claude/, .cursor/, .opencode/, .mcp.json)')
     .option('--force', 'overwrite existing files if already initialized')
     .option('--claude', 'generate Claude Code configuration')
     .option('--cursor', 'generate Cursor configuration')
+    .option('--opencode', 'generate OpenCode configuration')
     .action(options => {
-    return initCommand({ force: options.force, claude: options.claude, cursor: options.cursor });
+    return initCommand({
+        force: options.force,
+        claude: options.claude,
+        cursor: options.cursor,
+        opencode: options.opencode,
+    });
 });
 project
     .command('templates')

package/package.json

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