@holdyourvoice/hyv 2.9.11 → 2.9.12

package/README.md

@@ -13,6 +13,18 @@ npx @holdyourvoice/hyv scan draft.md
 
 ## install
 
+**Recommended** (installs node automatically if missing):
+
+```bash
+# mac / linux
+curl -fsSL https://holdyourvoice.com/install.sh | bash
+
+# windows (powershell)
+irm https://holdyourvoice.com/install.ps1 | iex
+```
+
+Already have node 18+?
+
 ```bash
 npm i -g @holdyourvoice/hyv
 ```

package/dist/index.js

@@ -5385,7 +5385,7 @@ var init_free_paid = __esm({
       "Rich profile-aware rewrite prompts (hyv rewrite)",
       "Hybrid server analysis (hyv scan --server, MCP hyv_analyze)",
       "Multiple profiles + team voices (Team plan)",
-      "Dashboard at holdyourvoice.com/app"
+      "Dashboard at holdyourvoice.com/dashboard"
     ];
     FREE_WEB_TOOLS = [
       { name: "All free tools", url: "https://holdyourvoice.com/tools" },
@@ -5406,7 +5406,7 @@ var init_free_paid = __esm({
     ];
     COMMUNITY_URL = "https://holdyourvoice.com/community";
     PRICING_URL = "https://holdyourvoice.com/#pricing";
-    DASHBOARD_BILLING_URL = "https://holdyourvoice.com/app/billing";
+    DASHBOARD_BILLING_URL = "https://holdyourvoice.com/dashboard?tab=billing";
   }
 });
 
@@ -5710,7 +5710,7 @@ async function authenticateWithBrowser() {
   return authData;
 }
 async function openAuthenticatedDashboard(opts = {}) {
-  const nextPath = opts.next || "/app/billing";
+  const nextPath = opts.next || "/dashboard?tab=billing";
   try {
     const response = await authenticatedRequest(cliApiUrl("/cli/auth/web-handoff"), {
       method: "POST",
@@ -5725,7 +5725,7 @@ async function openAuthenticatedDashboard(opts = {}) {
     }
   } catch {
   }
-  const billingUrl = nextPath === "/app/billing" ? DASHBOARD_BILLING_URL : assertSafeOpenUrl(`https://holdyourvoice.com${nextPath}`);
+  const billingUrl = nextPath === "/dashboard?tab=billing" || nextPath === "/app/billing" ? DASHBOARD_BILLING_URL : assertSafeOpenUrl(`https://holdyourvoice.com${nextPath}`);
   await (0, import_open.default)(billingUrl);
 }
 async function refreshToken(tokenOverride) {
@@ -5883,7 +5883,7 @@ async function request2(method, path27, body) {
   if (res.status === 401)
     throw new Error("your session expired. run: hyv init to sign in again.");
   if (res.status === 403)
-    throw new Error("you don't have access to this feature. check your plan at holdyourvoice.com/app/billing");
+    throw new Error("you don't have access to this feature. check your plan at holdyourvoice.com/dashboard?tab=billing");
   if (!res.ok) {
     throw new Error(`something went wrong (${res.status}). try again or contact support.`);
   }
@@ -11956,7 +11956,7 @@ async function stepSignup(profileName) {
     ));
   }
   console.log(import_chalk12.default.cyan("\n  opening billing in your dashboard ($1 first month)..."));
-  await withSpinner("opening billing\u2026", () => openAuthenticatedDashboard({ next: "/app/billing" }));
+  await withSpinner("opening billing\u2026", () => openAuthenticatedDashboard({ next: "/dashboard?tab=billing" }));
   await briefPause();
   markStepComplete("signup");
   console.log(import_chalk12.default.dim("\n  you're signed in \u2014 pick a plan in billing, no second login.\n"));
@@ -15624,7 +15624,7 @@ function registerInitCommand(program3) {
       } else if (options?.browser === false) {
         console.log(import_chalk4.default.red("License key required when --no-browser is set."));
         console.log("\nUsage: hyv init <license-key>");
-        console.log("\nGenerate a license key at: https://holdyourvoice.com/app");
+        console.log("\nGenerate a license key at: https://holdyourvoice.com/dashboard");
         process.exit(1);
       } else {
         authData = await authenticateWithBrowser();
@@ -16997,7 +16997,7 @@ async function showPlan() {
 async function upgradePlan() {
   console.log(import_chalk14.default.cyan("\nOpening billing in your dashboard ($1 first month)...\n"));
   try {
-    await openAuthenticatedDashboard({ next: "/app/billing" });
+    await openAuthenticatedDashboard({ next: "/dashboard?tab=billing" });
     console.log(import_chalk14.default.green("\n\u2713 Dashboard opened \u2014 you're already signed in"));
     console.log(import_chalk14.default.dim("Pick a plan in billing. No second login."));
   } catch {
@@ -17530,6 +17530,33 @@ function claudeDesktopDir() {
     return path18.join(HOME, ".config", "Claude");
   return path18.join(HOME, "Library", "Application Support", "Claude");
 }
+function windsurfRulePath() {
+  const dirs = [
+    path18.join(HOME, ".windsurf"),
+    IS_WIN ? path18.join(HOME, "AppData", "Roaming", "Windsurf") : path18.join(HOME, "Library", "Application Support", "Windsurf")
+  ];
+  for (const dir of dirs) {
+    const file = path18.join(dir, "rules", "hyv.md");
+    if (fs19.existsSync(file))
+      return file;
+  }
+  return null;
+}
+function opencodeAgentsPath() {
+  return path18.join(HOME, ".config", "opencode", "AGENTS.md");
+}
+function readOpencodeHyv() {
+  const file = path18.join(HOME, ".config", "opencode", "opencode.jsonc");
+  if (!fs19.existsSync(file))
+    return false;
+  try {
+    const raw = fs19.readFileSync(file, "utf-8").replace(/\/\*[\s\S]*?\*\//g, "").replace(/^\s*\/\/.*$/gm, "");
+    const cfg = JSON.parse(raw);
+    return Boolean(cfg.mcp?.hyv);
+  } catch {
+    return false;
+  }
+}
 function isOwnerOnlyFile(filePath) {
   try {
     if (!fs19.existsSync(filePath))
@@ -17551,7 +17578,7 @@ function readMcpHyv(configFile) {
   }
 }
 function registerDoctorCommand(program3) {
-  program3.command("doctor").description("Diagnose CLI health: engine, cache, auth, agents").option("--fix-agents", "Re-run agent config copy (idempotent)").action(async (opts) => {
+  program3.command("doctor").description("Diagnose CLI health: engine, cache, auth, agents").option("--fix-agents", "Re-run agent config copy (idempotent)").option("--verify-hosts", "Spawn MCP using each host config and report pass/fail").action(async (opts) => {
     console.log(import_chalk18.default.bold("\nhold your voice \u2014 doctor\n"));
     let issues = 0;
     let fixed = 0;
@@ -17660,14 +17687,20 @@ function registerDoctorCommand(program3) {
       console.log(import_chalk18.default.dim("    run: rm ~/.cursor/rules/hyv.md  (or hyv doctor --fix-agents)"));
       issues++;
     }
+    const agMcpFile = path18.join(HOME, ".gemini", "config", "mcp_config.json");
     const agentChecks = [
       { name: "claude desktop mcp", ok: readMcpHyv(path18.join(claudeDesktopDir(), "claude_desktop_config.json")) },
       { name: "cursor mcp", ok: readMcpHyv(path18.join(HOME, ".cursor", "mcp.json")) },
       { name: "cursor rule", ok: fs19.existsSync(cursorRule) },
+      { name: "antigravity mcp", ok: readMcpHyv(agMcpFile) },
+      { name: "opencode mcp", ok: readOpencodeHyv() },
+      { name: "opencode agents", ok: fs19.existsSync(opencodeAgentsPath()) && fs19.readFileSync(opencodeAgentsPath(), "utf-8").includes("hyv") },
+      { name: "windsurf rule", ok: Boolean(windsurfRulePath()) },
       { name: "claude code command", ok: fs19.existsSync(path18.join(HOME, ".claude", "commands", "hyv.md")) },
       { name: "claude code skill", ok: fs19.existsSync(path18.join(HOME, ".claude", "skills", "hold-your-voice", "SKILL.md")) },
       { name: "codex agents", ok: fs19.existsSync(path18.join(HOME, ".codex", "AGENTS.md")) && fs19.readFileSync(path18.join(HOME, ".codex", "AGENTS.md"), "utf-8").includes("hyv") },
-      { name: "command code skill", ok: fs19.existsSync(path18.join(HOME, ".commandcode", "skills", "hyv", "SKILL.md")) }
+      { name: "command code skill", ok: fs19.existsSync(path18.join(HOME, ".commandcode", "skills", "hyv", "SKILL.md")) },
+      { name: "chatgpt connector guide", ok: fs19.existsSync(path18.join(HOME, ".chatgpt", "hyv-mcp-connector.txt")) }
     ];
     for (const agent of agentChecks) {
       if (agent.ok) {
@@ -17718,6 +17751,31 @@ function registerDoctorCommand(program3) {
       console.log(import_chalk18.default.red(`  \u2717 mcp stdio probe failed: ${err.message}`));
       issues++;
     }
+    if (opts.verifyHosts) {
+      console.log(import_chalk18.default.dim("verifying mcp hosts (spawns subprocess per config)..."));
+      try {
+        const pkgDir = path18.resolve(__dirname, "..");
+        const { verifyAgentHosts } = require(path18.join(pkgDir, "scripts", "verify-agent-hosts.js"));
+        const hosts = await verifyAgentHosts();
+        for (const host of hosts) {
+          if (host.kind === "manual") {
+            console.log(import_chalk18.default.yellow(`  \u25CB ${host.label} \u2014 ${host.detail}`));
+            continue;
+          }
+          if (host.ok) {
+            console.log(import_chalk18.default.green(`  \u2713 ${host.label}${host.detail ? ` (${host.detail})` : ""}`));
+          } else if (host.kind === "file") {
+            console.log(import_chalk18.default.dim(`  - ${host.label} \u2014 ${host.detail || "missing"}`));
+          } else {
+            console.log(import_chalk18.default.red(`  \u2717 ${host.label} \u2014 ${host.detail || "failed"}`));
+            issues++;
+          }
+        }
+      } catch (err) {
+        console.log(import_chalk18.default.red(`  \u2717 host verification failed: ${err.message}`));
+        issues++;
+      }
+    }
     console.log("");
     if (issues === 0 && fixed === 0) {
       console.log(import_chalk18.default.green("\u2713 everything looks good!"));
@@ -18579,11 +18637,11 @@ function registerDemoCommand(program3) {
 // src/commands/open.ts
 var import_chalk29 = __toESM(require_source());
 var PAGES = {
-  dashboard: "https://holdyourvoice.com/app",
-  profiles: "https://holdyourvoice.com/app",
-  pricing: "https://holdyourvoice.com/app/billing",
-  settings: "https://holdyourvoice.com/app/settings",
-  billing: "https://holdyourvoice.com/app/billing"
+  dashboard: "https://holdyourvoice.com/dashboard",
+  profiles: "https://holdyourvoice.com/dashboard?tab=profiles",
+  pricing: "https://holdyourvoice.com/dashboard?tab=billing",
+  settings: "https://holdyourvoice.com/dashboard",
+  billing: "https://holdyourvoice.com/dashboard?tab=billing"
 };
 function registerOpenCommand(program3) {
   program3.command("open").description("Open the web dashboard in your browser").option("--page <path>", "Page: dashboard, profiles, pricing, settings", "dashboard").option("--profile <name>", "Deep-link to a specific profile").option("--no-browser", "Print URL only, don't open").action(async (options) => {
@@ -19506,8 +19564,16 @@ function printMcpSetup() {
   console.log(import_chalk32.default.dim("  Instructions: ~/.codex/AGENTS.md (merged on install)\n"));
   console.log(import_chalk32.default.bold("Command Code"));
   console.log(import_chalk32.default.dim("  Skill: ~/.commandcode/skills/hyv/SKILL.md\n"));
-  console.log(import_chalk32.default.bold("ChatGPT"));
+  console.log(import_chalk32.default.bold("ChatGPT Desktop (manual connector)"));
+  console.log(import_chalk32.default.dim("  Settings \u2192 Connectors \u2192 add connector"));
+  console.log(import_chalk32.default.dim("  Name: hold your voice  |  Command: hyv  |  Arguments: mcp"));
+  console.log(import_chalk32.default.dim("  Guide: ~/.chatgpt/hyv-mcp-connector.txt (after hyv doctor --fix-agents)"));
   console.log(import_chalk32.default.dim("  hyv mcp --setup-chatgpt\n"));
+  console.log(import_chalk32.default.bold("Antigravity"));
+  console.log(import_chalk32.default.dim("  MCP: ~/.gemini/config/mcp_config.json \u2192 mcpServers.hyv (auto via postinstall)\n"));
+  console.log(import_chalk32.default.bold("OpenCode"));
+  console.log(import_chalk32.default.dim("  MCP: ~/.config/opencode/opencode.jsonc \u2192 mcp.hyv (auto via postinstall)"));
+  console.log(import_chalk32.default.dim("  Rules: ~/.config/opencode/AGENTS.md\n"));
   console.log(import_chalk32.default.bold("Auto-configure"));
   console.log(import_chalk32.default.dim("  hyv doctor --fix-agents"));
   console.log(import_chalk32.default.dim("  HYV_AUTO_CONFIGURE_AGENTS=0 npm i -g @holdyourvoice/hyv  (skip)\n"));
@@ -19680,7 +19746,7 @@ async function exportCommand(format, opts) {
     } else {
       console.log(`
   ${c.red("\u2717")} no voice profiles found`);
-      console.log(`    ${c.dim("create one at")} ${c.cyan("https://holdyourvoice.com/app")}`);
+      console.log(`    ${c.dim("create one at")} ${c.cyan("https://holdyourvoice.com/dashboard")}`);
     }
     process.exit(1);
     return;
@@ -19780,15 +19846,24 @@ program2.command("mcp").description("Start MCP server (for Claude Desktop and ot
     return;
   }
   if (opts.setupChatgpt) {
-    console.log(import_chalk33.default.bold("\nhold your voice \u2014 chatgpt setup\n"));
-    console.log("To connect HYV to ChatGPT:");
-    console.log(import_chalk33.default.dim("  1. Go to ") + import_chalk33.default.cyan("https://chatgpt.com/#settings/Connectors"));
-    console.log(import_chalk33.default.dim("  2. Add a new connector"));
-    console.log(import_chalk33.default.dim("  3. For local MCP, use: ") + import_chalk33.default.cyan("hyv mcp"));
-    console.log(import_chalk33.default.dim("  4. ChatGPT Desktop supports stdio MCP servers"));
+    const home = require("os").homedir();
+    const guide = require("path").join(home, ".chatgpt", "hyv-mcp-connector.txt");
+    console.log(import_chalk33.default.bold("\nhold your voice \u2014 chatgpt desktop mcp setup\n"));
+    console.log("ChatGPT has no auto-config file. Add this connector once in the desktop app:\n");
+    console.log(import_chalk33.default.dim("  1. Install hyv: ") + import_chalk33.default.cyan("npm i -g @holdyourvoice/hyv@latest && hyv welcome"));
+    console.log(import_chalk33.default.dim("  2. Open ") + import_chalk33.default.cyan("https://chatgpt.com/#settings/Connectors"));
+    console.log(import_chalk33.default.dim("  3. Add connector"));
+    console.log(import_chalk33.default.dim("  4. Name: ") + import_chalk33.default.cyan("hold your voice"));
+    console.log(import_chalk33.default.dim("  5. Command: ") + import_chalk33.default.cyan("hyv"));
+    console.log(import_chalk33.default.dim("  6. Arguments: ") + import_chalk33.default.cyan("mcp"));
+    console.log(import_chalk33.default.dim("  7. Save, restart ChatGPT Desktop, ask: scan this with hold your voice"));
     console.log("");
-    console.log(import_chalk33.default.dim("Note: The remote HTTP MCP endpoint is not yet available."));
-    console.log(import_chalk33.default.dim("Use the local stdio MCP server with Claude Desktop or Claude Code instead."));
+    if (require("fs").existsSync(guide)) {
+      console.log(import_chalk33.default.dim(`Full guide written to: ${guide}`));
+    } else {
+      console.log(import_chalk33.default.dim("Run hyv doctor --fix-agents to write ~/.chatgpt/hyv-mcp-connector.txt"));
+    }
+    console.log(import_chalk33.default.dim("\nBrowser chatgpt cannot use local MCP \u2014 desktop app only."));
     return;
   }
   startMcpServer();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holdyourvoice/hyv",
-  "version": "2.9.11",
+  "version": "2.9.12",
   "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": {
@@ -59,6 +59,8 @@
     "dist/",
     "scripts/postinstall.js",
     "scripts/postinstall-lib.js",
+    "scripts/install.sh",
+    "scripts/install.ps1",
     "scripts/check-no-duplicates.js",
     "assets/",
     "skills/",

package/scripts/install.ps1

@@ -0,0 +1,89 @@
+# hold your voice — install node (if needed) + @holdyourvoice/hyv
+param(
+  [switch]$EnsureNodeOnly
+)
+
+$ErrorActionPreference = 'Stop'
+
+$HyvPkg = '@holdyourvoice/hyv@latest'
+$MinNodeMajor = 18
+
+function Write-Log([string]$Message) { Write-Host "  $Message" }
+
+function Test-NodeOk {
+  if (-not (Get-Command node -ErrorAction SilentlyContinue)) { return $false }
+  $major = [int](node -p "parseInt(process.versions.node.split('.')[0], 10)")
+  return $major -ge $MinNodeMajor
+}
+
+function Refresh-Path {
+  $machine = [Environment]::GetEnvironmentVariable('Path', 'Machine')
+  $user = [Environment]::GetEnvironmentVariable('Path', 'User')
+  if ($machine -or $user) {
+    $env:Path = @($machine, $user) -join ';'
+  }
+}
+
+function Install-Node {
+  if (Get-Command winget -ErrorAction SilentlyContinue) {
+    Write-Log 'installing node via winget...'
+    winget install OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements
+    Refresh-Path
+    return
+  }
+  if (Get-Command choco -ErrorAction SilentlyContinue) {
+    Write-Log 'installing node via chocolatey...'
+    choco install nodejs-lts -y
+    Refresh-Path
+    return
+  }
+  $lts = '22.16.0'
+  $msi = "node-v$lts-x64.msi"
+  $url = "https://nodejs.org/dist/v$lts/$msi"
+  $tmp = Join-Path $env:TEMP "hyv-node-$msi"
+  Write-Log "downloading node $lts..."
+  Invoke-WebRequest -Uri $url -OutFile $tmp -UseBasicParsing
+  Write-Log 'installing node...'
+  Start-Process msiexec.exe -ArgumentList "/i `"$tmp`" /qn" -Wait
+  Refresh-Path
+}
+
+function Ensure-Node {
+  Refresh-Path
+  if (Test-NodeOk) {
+    Write-Log "node $(node -v) found"
+    return
+  }
+  Write-Log "node $MinNodeMajor+ not found — installing automatically..."
+  Install-Node
+  Refresh-Path
+  if (-not (Test-NodeOk)) {
+    throw 'node install finished but node is still not on PATH — open a new terminal and run this script again'
+  }
+  Write-Log "node $(node -v) ready"
+}
+
+function Install-Hyv {
+  if (-not (Get-Command npm -ErrorAction SilentlyContinue)) {
+    throw 'npm not found after node install'
+  }
+  Write-Log 'installing hold your voice...'
+  npm i -g $HyvPkg
+  Refresh-Path
+  if (Get-Command hyv -ErrorAction SilentlyContinue) {
+    Write-Log 'running hyv welcome...'
+    hyv welcome
+  } else {
+    Write-Host '  ! hyv installed but not on PATH — open a new terminal and run: hyv welcome' -ForegroundColor Yellow
+  }
+}
+
+Write-Host ''
+Write-Host 'hold your voice — installer'
+Write-Host ''
+Ensure-Node
+if ($EnsureNodeOnly) { exit 0 }
+Install-Hyv
+Write-Host ''
+Write-Host '  ✓ done — hyv is ready'
+Write-Host ''

package/scripts/install.sh

@@ -0,0 +1,155 @@
+#!/usr/bin/env bash
+# hold your voice — install node (if needed) + @holdyourvoice/hyv
+set -euo pipefail
+
+HYV_PKG="@holdyourvoice/hyv@latest"
+MIN_NODE_MAJOR=18
+NODE_LTS="22.16.0"
+ENSURE_NODE_ONLY=0
+
+for arg in "$@"; do
+  case "$arg" in
+    --ensure-node-only) ENSURE_NODE_ONLY=1 ;;
+  esac
+done
+
+log() { printf '  %s\n' "$*"; }
+warn() { printf '  ! %s\n' "$*" >&2; }
+
+node_major() {
+  node -p "parseInt(process.versions.node.split('.')[0], 10)" 2>/dev/null || echo 0
+}
+
+node_ok() {
+  command -v node >/dev/null 2>&1 || return 1
+  [[ "$(node_major)" -ge "$MIN_NODE_MAJOR" ]]
+}
+
+refresh_path() {
+  export PATH="/usr/local/bin:/opt/homebrew/bin:${HOME}/.local/share/fnm:${PATH}"
+  hash -r 2>/dev/null || true
+}
+
+install_node_fnm() {
+  export FNM_DIR="${FNM_DIR:-${HOME}/.local/share/fnm}"
+  export FNM_VERSION="${FNM_VERSION:-v1.38.1}"
+  mkdir -p "$FNM_DIR"
+  if ! command -v fnm >/dev/null 2>&1; then
+    log "installing fnm (user-level node manager)..."
+    curl -fsSL https://fnm.vercel.app/install | bash -s -- --install-no-use
+  fi
+  refresh_path
+  if ! command -v fnm >/dev/null 2>&1 && [[ -x "${FNM_DIR}/fnm" ]]; then
+    export PATH="${FNM_DIR}:${PATH}"
+  fi
+  command -v fnm >/dev/null 2>&1 || return 1
+  eval "$(fnm env)"
+  fnm install "$NODE_LTS"
+  fnm default "$NODE_LTS"
+  eval "$(fnm env)"
+}
+
+install_node_mac() {
+  if command -v brew >/dev/null 2>&1; then
+    log "installing node via homebrew..."
+    brew install node
+    refresh_path
+    return 0
+  fi
+  if install_node_fnm; then
+    refresh_path
+    return 0
+  fi
+  local arch pkg
+  arch="$(uname -m)"
+  case "$arch" in
+    arm64) pkg="node-v${NODE_LTS}.pkg" ;;
+    x86_64) pkg="node-v${NODE_LTS}.pkg" ;;
+    *) warn "unsupported mac architecture: $arch"; return 1 ;;
+  esac
+  local url="https://nodejs.org/dist/v${NODE_LTS}/${pkg}"
+  local tmp="/tmp/hyv-node-v${NODE_LTS}.pkg"
+  log "downloading node ${NODE_LTS}..."
+  curl -fsSL "$url" -o "$tmp"
+  log "installing node (may ask for your password)..."
+  sudo installer -pkg "$tmp" -target /
+  refresh_path
+}
+
+install_node_linux() {
+  if install_node_fnm; then
+    refresh_path
+    return 0
+  fi
+  if command -v apt-get >/dev/null 2>&1; then
+    log "installing node via apt (nodesource)..."
+    curl -fsSL "https://deb.nodesource.com/setup_${NODE_LTS%%.*}.x" | sudo -E bash -
+    sudo apt-get install -y nodejs
+    refresh_path
+    return 0
+  fi
+  if command -v dnf >/dev/null 2>&1; then
+    log "installing node via dnf..."
+    sudo dnf install -y nodejs npm
+    refresh_path
+    return 0
+  fi
+  warn "could not auto-install node on this linux distro — install node ${MIN_NODE_MAJOR}+ manually"
+  return 1
+}
+
+install_node() {
+  case "$(uname -s)" in
+    Darwin) install_node_mac ;;
+    Linux) install_node_linux ;;
+    *)
+      warn "unsupported platform for auto node install"
+      return 1
+      ;;
+  esac
+}
+
+ensure_node() {
+  refresh_path
+  if node_ok; then
+    log "node $(node -v) found"
+    return 0
+  fi
+  log "node ${MIN_NODE_MAJOR}+ not found — installing automatically..."
+  install_node
+  refresh_path
+  if node_ok; then
+    log "node $(node -v) ready"
+    return 0
+  fi
+  warn "node install finished but node is still not on PATH — open a new terminal and run this script again"
+  return 1
+}
+
+install_hyv() {
+  if ! command -v npm >/dev/null 2>&1; then
+    warn "npm not found after node install"
+    return 1
+  fi
+  log "installing hold your voice..."
+  npm i -g "$HYV_PKG"
+  refresh_path
+  if command -v hyv >/dev/null 2>&1; then
+    log "running hyv welcome..."
+    hyv welcome
+  else
+    warn "hyv installed but not on PATH — open a new terminal and run: hyv welcome"
+  fi
+}
+
+main() {
+  printf '\nhold your voice — installer\n\n'
+  ensure_node
+  if [[ "$ENSURE_NODE_ONLY" -eq 1 ]]; then
+    exit 0
+  fi
+  install_hyv
+  printf '\n  ✓ done — hyv is ready\n\n'
+}
+
+main "$@"

package/scripts/postinstall-lib.js

@@ -83,16 +83,79 @@ function resolveHyvMcpCommand(pkgDir) {
   return { command: 'hyv', args: ['mcp'] };
 }
 
-function mergeJsonConfigFile(configFile, mutator, { backup = true } = {}) {
+/** OpenCode local MCP uses a command array: [node, entry, mcp] */
+function resolveHyvMcpCommandArray(pkgDir) {
+  const { command, args } = resolveHyvMcpCommand(pkgDir);
+  return [command, ...args];
+}
+
+function parseJsonc(text) {
+  const noBlock = text.replace(/\/\*[\s\S]*?\*\//g, '');
+  const noLine = noBlock.replace(/^\s*\/\/.*$/gm, '');
+  return JSON.parse(noLine);
+}
+
+function stringifyJsonc(config, originalText) {
+  const usesTrailingComma = /,\s*[}\]]/.test(originalText || '');
+  const space = (originalText || '').includes(': ') ? 2 : 2;
+  let out = JSON.stringify(config, null, space);
+  if (usesTrailingComma) {
+    out = out.replace(/,\n(\s*[}\]])/g, ',\n$1');
+  }
+  return out.endsWith('\n') ? out : `${out}\n`;
+}
+
+function readJsonObjectFromFile(file, parser) {
+  if (!fs.existsSync(file)) return { config: {}, original: '' };
+  const original = fs.readFileSync(file, 'utf-8');
+  if (!original.trim()) return { config: {}, original };
+  try {
+    const parsed = parser(original);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+      return { ok: false, reason: 'parse-error', error: 'expected json object' };
+    }
+    return { config: parsed, original };
+  } catch (err) {
+    return { ok: false, reason: 'parse-error', error: err.message };
+  }
+}
+
+function mergeJsoncConfigFile(configFile, mutator, { backup = true } = {}) {
   fs.mkdirSync(path.dirname(configFile), { recursive: true });
-  let config = {};
-  if (fs.existsSync(configFile)) {
+  const read = readJsonObjectFromFile(configFile, parseJsonc);
+  if (read.ok === false) return read;
+  let { config, original } = read;
+  const next = mutator(config) || config;
+  if (backup && fs.existsSync(configFile)) {
     try {
-      config = JSON.parse(fs.readFileSync(configFile, 'utf-8'));
-    } catch (err) {
-      return { ok: false, reason: 'parse-error', error: err.message };
+      fs.copyFileSync(configFile, `${configFile}.hyv.bak`);
+    } catch {
+      // non-fatal
     }
   }
+  fs.writeFileSync(configFile, original ? stringifyJsonc(next, original) : `${JSON.stringify(next, null, 2)}\n`);
+  return { ok: true };
+}
+
+function antigravityMcpConfigPath(home, isWin) {
+  return path.join(home, '.gemini', 'config', 'mcp_config.json');
+}
+
+function opencodeConfigDir(home, isWin) {
+  if (isWin) return path.join(home, '.config', 'opencode');
+  if (process.platform === 'linux') return path.join(home, '.config', 'opencode');
+  return path.join(home, '.config', 'opencode');
+}
+
+function chatgptHelperDir(home) {
+  return path.join(home, '.chatgpt');
+}
+
+function mergeJsonConfigFile(configFile, mutator, { backup = true } = {}) {
+  fs.mkdirSync(path.dirname(configFile), { recursive: true });
+  const read = readJsonObjectFromFile(configFile, (text) => JSON.parse(text));
+  if (read.ok === false) return read;
+  let { config, original } = read;
   const next = mutator(config) || config;
   if (backup && fs.existsSync(configFile)) {
     try {
@@ -101,7 +164,7 @@ function mergeJsonConfigFile(configFile, mutator, { backup = true } = {}) {
       // non-fatal
     }
   }
-  fs.writeFileSync(configFile, JSON.stringify(next, null, 2));
+  fs.writeFileSync(configFile, `${JSON.stringify(next, null, 2)}\n`);
   return { ok: true };
 }
 
@@ -274,6 +337,93 @@ function setupAgents({ pkgDir, home = require('os').homedir(), quiet = false })
     warnings.push(`command code: ${err.message}`);
   }
 
+  // Antigravity — ~/.gemini/config/mcp_config.json (absolute paths for GUI launch)
+  try {
+    const agFile = antigravityMcpConfigPath(home, isWin);
+    const mcpCmd = resolveHyvMcpCommand(pkgDir);
+    const result = mergeJsonConfigFile(agFile, (config) => {
+      if (!config.mcpServers) config.mcpServers = {};
+      if (!config.mcpServers.hyv) {
+        config.mcpServers.hyv = { command: mcpCmd.command, args: mcpCmd.args };
+        configured.push('antigravity mcp');
+      }
+      return config;
+    });
+    if (!result.ok) warnings.push(`antigravity: could not update mcp config (${result.reason})`);
+  } catch (err) {
+    warnings.push(`antigravity: ${err.message}`);
+  }
+
+  // OpenCode — ~/.config/opencode/opencode.jsonc + AGENTS.md
+  try {
+    const ocDir = opencodeConfigDir(home, isWin);
+    const ocFile = path.join(ocDir, 'opencode.jsonc');
+    const cmdArr = resolveHyvMcpCommandArray(pkgDir);
+    const ocResult = mergeJsoncConfigFile(ocFile, (config) => {
+      if (!config.mcp) config.mcp = {};
+      if (!config.mcp.hyv) {
+        config.mcp.hyv = { type: 'local', command: cmdArr, enabled: true };
+        configured.push('opencode mcp');
+      }
+      return config;
+    });
+    if (!ocResult.ok) warnings.push(`opencode: could not update opencode.jsonc (${ocResult.reason})`);
+
+    const agentsFile = path.join(ocDir, 'AGENTS.md');
+    const genericSrc = path.join(pkgDir, 'agents', 'generic.md');
+    let existing = '';
+    if (fs.existsSync(agentsFile)) existing = fs.readFileSync(agentsFile, 'utf-8');
+    const addition = fs.existsSync(genericSrc) ? fs.readFileSync(genericSrc, 'utf-8') : '';
+    if (addition && shouldUpgradeAgent(agentsFile, agentsMarker, pkgVersion)) {
+      const merged = mergeAgentsMd(existing, addition, 'hold-your-voice');
+      fs.mkdirSync(ocDir, { recursive: true });
+      fs.writeFileSync(agentsFile, merged);
+      configured.push('opencode agents');
+    } else if (!fs.existsSync(agentsFile) && addition) {
+      fs.mkdirSync(ocDir, { recursive: true });
+      fs.writeFileSync(agentsFile, `${addition.trim()}\n`);
+      configured.push('opencode agents');
+    }
+  } catch (err) {
+    warnings.push(`opencode: ${err.message}`);
+  }
+
+  // ChatGPT — connector helper (UI has no config file; write exact values for manual add)
+  try {
+    const cgDir = chatgptHelperDir(home);
+    fs.mkdirSync(cgDir, { recursive: true });
+    const mcpCmd = resolveHyvMcpCommand(pkgDir);
+    const connectorGuide = [
+      'hold your voice — chatgpt desktop mcp connector',
+      '',
+      'chatgpt has no auto-config file. add this connector once in the chatgpt desktop app:',
+      '',
+      '1. open chatgpt desktop (not the browser)',
+      '2. settings → connectors → add connector',
+      '3. name: hold your voice',
+      '4. command: hyv',
+      '5. arguments: mcp',
+      '',
+      'if the connector fails to start, use absolute paths instead:',
+      `   command: ${mcpCmd.command}`,
+      `   arguments: ${mcpCmd.args.join(' ')}`,
+      '',
+      'then restart chatgpt desktop and ask: scan this with hold your voice',
+      '',
+      'more help: hyv mcp --setup-chatgpt',
+      '',
+    ].join('\n');
+    const guideFile = path.join(cgDir, 'hyv-mcp-connector.txt');
+    fs.writeFileSync(guideFile, connectorGuide);
+    configured.push('chatgpt connector guide');
+
+    const chatgptSrc = path.join(pkgDir, 'agents', 'chatgpt.md');
+    const instrFile = path.join(cgDir, 'hyv-instructions.txt');
+    if (fs.existsSync(chatgptSrc)) installAgent(chatgptSrc, instrFile);
+  } catch (err) {
+    warnings.push(`chatgpt: ${err.message}`);
+  }
+
   // Generic reference copy
   try {
     const genericSrc = path.join(pkgDir, 'agents', 'generic.md');
@@ -300,9 +450,15 @@ module.exports = {
   hasCompletedOnboarding,
   markOnboardingComplete,
   resolveHyvMcpCommand,
+  resolveHyvMcpCommandArray,
+  parseJsonc,
   mergeJsonConfigFile,
+  mergeJsoncConfigFile,
   toCursorMdc,
   toWindsurfRule,
   setupAgents,
   claudeDesktopDir,
+  antigravityMcpConfigPath,
+  opencodeConfigDir,
+  chatgptHelperDir,
 };

package/scripts/postinstall.js

@@ -19,6 +19,7 @@ function print(msg) {
 print('');
 print('  ✓ hold your voice installed — free local scan ready');
 print('  next: hyv welcome  |  hyv scan draft.md  |  hyv mcp --setup');
+print('  no node yet? curl -fsSL https://holdyourvoice.com/install.sh | bash');
 print('');
 
 const { configured, warnings } = setupAgents({ pkgDir, quiet });