@holdyourvoice/hyv 2.9.24 → 2.9.25

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable CLI changes. Also mirrored to [holdyourvoice.com/changelog](https://holdyourvoice.com/changelog) for user-facing releases.
 
+## [2.9.25] — 2026-07-04
+
+### Fixed
+- **MCP stdio pollution** — `hyv mcp` no longer prints setup banners to stdout when spawned by Cursor/Claude/ChatGPT (fixes "Unexpected token … is not valid JSON" toast spam on app open)
+- Auto-detects piped stdout (`!isTTY`) or explicit `--stdio` flag; MCP configs now use `mcp --stdio`
+- Interactive terminal runs still show setup on stderr before the JSON-RPC server starts
+
 ## [2.9.15] — 2026-06-18
 
 ### Added

package/dist/index.js

@@ -5413,7 +5413,7 @@ function printFreePaidMatrix(opts = {}) {
   First month $1 \u2192 ${PRICING_URL}`));
   console.log(import_chalk.default.dim("  hyv init  |  hyv plan --upgrade\n"));
 }
-var import_chalk, NPX_EXAMPLES, FREE_CLI_COMMANDS, PAID_FEATURES, FREE_WEB_TOOLS, COMMUNITY_URL, PRICING_URL, DASHBOARD_BILLING_URL;
+var import_chalk, NPX_EXAMPLES, FREE_CLI_COMMANDS, PAID_FEATURES, FREE_WEB_TOOLS, COMMUNITY_URL, X_URL, PRICING_URL, DASHBOARD_BILLING_URL;
 var init_free_paid = __esm({
   "src/lib/free-paid.ts"() {
     "use strict";
@@ -5460,6 +5460,7 @@ var init_free_paid = __esm({
       { name: "Blog", url: "https://holdyourvoice.com/blog" }
     ];
     COMMUNITY_URL = "https://holdyourvoice.com/community";
+    X_URL = "https://x.com/istupidpreneur";
     PRICING_URL = "https://holdyourvoice.com/#pricing";
     DASHBOARD_BILLING_URL = "https://holdyourvoice.com/dashboard?tab=billing";
   }
@@ -17766,6 +17767,18 @@ var import_child_process4 = require("child_process");
 // src/lib/cli-entry.ts
 var fs18 = __toESM(require("fs"));
 var path17 = __toESM(require("path"));
+
+// src/lib/mcp-stdio.ts
+function isMcpStdioMode(opts) {
+  if (opts?.stdio)
+    return true;
+  if (process.env.HYV_MCP_STDIO === "1" || process.env.HYV_MCP_STDIO === "true")
+    return true;
+  return !process.stdout.isTTY;
+}
+var MCP_SERVER_ARGS = ["mcp", "--stdio"];
+
+// src/lib/cli-entry.ts
 function resolveCliEntry() {
   const candidates = [
     path17.resolve(process.argv[1] || ""),
@@ -17777,9 +17790,9 @@ function resolveCliEntry() {
 function mcpServerCommand() {
   const entry = resolveCliEntry();
   if (entry) {
-    return { command: process.execPath, args: [entry, "mcp"] };
+    return { command: process.execPath, args: [entry, ...MCP_SERVER_ARGS] };
   }
-  return { command: "hyv", args: ["mcp"] };
+  return { command: "hyv", args: [...MCP_SERVER_ARGS] };
 }
 function mcpServerSnippet() {
   const { command, args: args2 } = mcpServerCommand();
@@ -17792,9 +17805,9 @@ async function testMcpStdioSubprocess() {
   if (!entry)
     return { ok: false };
   return new Promise((resolve18) => {
-    const child = (0, import_child_process4.spawn)(process.execPath, [entry, "mcp"], {
+    const child = (0, import_child_process4.spawn)(process.execPath, [entry, "mcp", "--stdio"], {
       stdio: ["pipe", "pipe", "pipe"],
-      env: { ...process.env, HYV_POSTINSTALL_QUIET: "1" }
+      env: { ...process.env, HYV_POSTINSTALL_QUIET: "1", HYV_MCP_STDIO: "1" }
     });
     let buffer = "";
     let settled = false;
@@ -19159,16 +19172,17 @@ More: hyv content ci`
   },
   share: {
     title: "Share your voice fingerprint",
-    body: `Social post template:
+    body: `Social post template (X / LinkedIn):
 
 I run my AI drafts through @holdyourvoice/hyv before they ship.
 
-Free local scan caught [N] patterns in 2 seconds \u2014 no API, offline.
+Free local scan caught 34 patterns in 2 seconds \u2014 score 0/100. no API, offline.
 
 Cursor/Claude agents can call hyv mcp tools directly.
 
 Try: npx @holdyourvoice/hyv welcome
 
+${X_URL}
 ${COMMUNITY_URL}`
   }
 };
@@ -19448,7 +19462,7 @@ function formatChatGptConnectorGuide() {
     "2. Settings \u2192 Connectors \u2192 Add connector",
     "3. Name: **hold your voice**",
     "4. Command: **hyv** (or absolute path below if connector fails)",
-    "5. Arguments: **mcp**",
+    "5. Arguments: **mcp --stdio**",
     "",
     "If the connector fails to start, use absolute paths:",
     `   command: ${mcpCmd.command}`,
@@ -20334,7 +20348,7 @@ function printMcpSetup() {
   console.log(import_chalk35.default.dim("  Skill: ~/.commandcode/skills/hyv/SKILL.md\n"));
   console.log(import_chalk35.default.bold("ChatGPT Desktop (manual connector)"));
   console.log(import_chalk35.default.dim("  Settings \u2192 Connectors \u2192 add connector"));
-  console.log(import_chalk35.default.dim("  Name: hold your voice  |  Command: hyv  |  Arguments: mcp"));
+  console.log(import_chalk35.default.dim("  Name: hold your voice  |  Command: hyv  |  Arguments: mcp --stdio"));
   console.log(import_chalk35.default.dim("  Guide: ~/.chatgpt/hyv-mcp-connector.txt (after hyv doctor --fix-agents)"));
   console.log(import_chalk35.default.dim("  hyv mcp --setup-chatgpt"));
   if (IS_WIN2) {
@@ -20638,7 +20652,7 @@ registerWelcomeCommand(program2);
 registerContentCommand(program2);
 registerUpgradeCommand(program2);
 registerShareCommand(program2);
-program2.command("mcp").description("Detect installed apps, configure MCP, and start the MCP server").option("--setup", "Show MCP setup for Claude Desktop, Cursor, Windsurf, Codex").option("--test", "Run MCP health check (tools, profile, stdio)").option("--setup-chatgpt", "Show ChatGPT connector setup instructions").option("--force", "Force re-configure MCP even if already integrated").action(async (opts) => {
+program2.command("mcp").description("Detect installed apps, configure MCP, and start the MCP server").option("--setup", "Show MCP setup for Claude Desktop, Cursor, Windsurf, Codex").option("--test", "Run MCP health check (tools, profile, stdio)").option("--setup-chatgpt", "Show ChatGPT connector setup instructions").option("--force", "Force re-configure MCP even if already integrated").option("--stdio", "Stdio MCP mode \u2014 no stdout banners (auto when stdout is piped)").action(async (opts) => {
   if (opts.setup) {
     printMcpSetup();
     return;
@@ -20675,7 +20689,7 @@ program2.command("mcp").description("Detect installed apps, configure MCP, and s
     console.log(import_chalk36.default.dim("  3. Add connector:"));
     console.log(import_chalk36.default.dim("     Name:      ") + import_chalk36.default.cyan("hold your voice"));
     console.log(import_chalk36.default.dim("     Command:   ") + import_chalk36.default.cyan("hyv") + import_chalk36.default.dim(" (full path on Windows if needed)"));
-    console.log(import_chalk36.default.dim("     Arguments: ") + import_chalk36.default.cyan("mcp"));
+    console.log(import_chalk36.default.dim("     Arguments: ") + import_chalk36.default.cyan("mcp --stdio"));
     console.log(import_chalk36.default.dim("  4. Save, restart ChatGPT Desktop"));
     console.log(import_chalk36.default.dim('  5. Test: "scan this with hold your voice"\n'));
     console.log(import_chalk36.default.dim("  If connector fails to start, use full paths from:"));
@@ -20697,20 +20711,26 @@ program2.command("mcp").description("Detect installed apps, configure MCP, and s
     console.log("");
     return;
   }
-  console.log(import_chalk36.default.bold("\nhold your voice \u2014 detecting and configuring mcp...\n"));
+  if (isMcpStdioMode(opts)) {
+    await startMcpServer();
+    return;
+  }
+  const err = (msg) => process.stderr.write(msg + "\n");
+  err(import_chalk36.default.bold("\nhold your voice \u2014 detecting and configuring mcp...\n"));
   const result = runMcpAutoIntegrate({ force: Boolean(opts.force) });
+  const reportLines = [];
+  const origLog = console.log;
+  console.log = (...args2) => {
+    reportLines.push(args2.map(String).join(" "));
+  };
   printMcpIntegrateReport(result, { force: Boolean(opts.force) });
-  console.log(import_chalk36.default.green.bold("\n\u2713 hold your voice \u2014 mcp setup complete\n"));
-  console.log(import_chalk36.default.dim("  " + import_chalk36.default.bold("To integrate HYV with all MCP-compatible apps on your machine")));
-  console.log(import_chalk36.default.dim("  (Cursor, Claude Desktop, Windsurf, Antigravity, OpenCode, ChatGPT, Codex,"));
-  console.log(import_chalk36.default.dim("   Command Code, and more) \u2014 simply run:"));
-  console.log("");
-  console.log(import_chalk36.default.cyan("    hyv mcp"));
-  console.log("");
-  console.log(import_chalk36.default.dim("  It auto-detects installed apps, configures MCP servers, and is ready"));
-  console.log(import_chalk36.default.dim("  for scanning, rewriting, and voice-profile validation in any tool.\n"));
-  console.log(import_chalk36.default.dim("\nstarting MCP server (press Ctrl+C to stop)...\n"));
-  startMcpServer();
+  console.log = origLog;
+  for (const line of reportLines)
+    err(line);
+  err(import_chalk36.default.green.bold("\n\u2713 hold your voice \u2014 mcp setup complete\n"));
+  err(import_chalk36.default.dim("  restart cursor / claude desktop if they were open during setup"));
+  err(import_chalk36.default.dim("\nstarting MCP server (press Ctrl+C to stop) \u2014 JSON-RPC on stdout...\n"));
+  await startMcpServer();
 });
 program2.command("export").description("Export voice profile for LLMs").argument("[format]", "Export format (claude, chatgpt, generic, cursor)", "claude").option("--output <file>", "Write to file instead of stdout").option("--json", "Output as JSON").action(async (format, opts) => {
   await exportCommand(format, opts);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holdyourvoice/hyv",
-  "version": "2.9.24",
+  "version": "2.9.25",
   "description": "Free local AI writing scan for cursor & claude. MCP server, 220+ pattern detection, voice profiles. npx @holdyourvoice/hyv welcome",
   "main": "dist/index.js",
   "bin": {

package/scripts/postinstall-lib.js

@@ -78,9 +78,9 @@ function markOnboardingComplete(hyvDir, pkgVersion) {
 function resolveHyvMcpCommand(pkgDir) {
   const entry = path.join(pkgDir, 'dist', 'index.js');
   if (fs.existsSync(entry)) {
-    return { command: process.execPath, args: [entry, 'mcp'] };
+    return { command: process.execPath, args: [entry, 'mcp', '--stdio'] };
   }
-  return { command: 'hyv', args: ['mcp'] };
+  return { command: 'hyv', args: ['mcp', '--stdio'] };
 }
 
 /** OpenCode local MCP uses a command array: [node, entry, mcp] */