@vovy-ai/go 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vovy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,266 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { parseArgs } from "util";
+import { ADAPTERS as ADAPTERS2 } from "@vovy-ai/host-detect";
+
+// src/commands/doctor.ts
+import { getAllSkills as getAllSkills2 } from "@vovy-ai/skills";
+
+// src/commands/install.ts
+import {
+  writeMcpConfig,
+  writeSkillFile
+} from "@vovy-ai/host-detect";
+import { getAllSkills } from "@vovy-ai/skills";
+
+// src/targets.ts
+import { ADAPTERS, getAdapter } from "@vovy-ai/host-detect";
+function resolveTargets(env, hosts) {
+  if (hosts?.length) return hosts.map(getAdapter);
+  return ADAPTERS.filter((adapter) => adapter.detect(env));
+}
+
+// src/commands/install.ts
+var VOVY_MCP_ENTRY = { id: "vovy", command: "npx", args: ["-y", "@vovy-ai/mcp-server"] };
+function runInstall(opts) {
+  const scope = opts.scope ?? "user";
+  const targets = resolveTargets(opts.env, opts.hosts);
+  const skills = getAllSkills();
+  return targets.map((adapter) => {
+    const skillResults = skills.map((skill) => ({
+      skillId: skill.id,
+      ...writeSkillFile({
+        adapter,
+        env: opts.env,
+        scope,
+        skillId: skill.id,
+        content: skill.raw,
+        dryRun: opts.dryRun
+      })
+    }));
+    const mcpResult = writeMcpConfig({
+      adapter,
+      env: opts.env,
+      scope,
+      entry: VOVY_MCP_ENTRY,
+      dryRun: opts.dryRun
+    });
+    return { adapter, skillResults, mcpResult };
+  });
+}
+
+// src/commands/doctor.ts
+function runDoctor(env, hosts, scope) {
+  const dryRunResults = runInstall({ env, hosts, scope, dryRun: true });
+  const totalSkillCount = getAllSkills2().length;
+  return dryRunResults.map(({ adapter, skillResults, mcpResult }) => {
+    const entries = skillResults.map((r) => ({
+      skillId: r.skillId,
+      path: r.path,
+      status: r.action === "unchanged" ? "ok" : r.action === "created" ? "missing" : "stale"
+    }));
+    const mcp = mcpResult ? {
+      path: mcpResult.path,
+      status: mcpResult.action === "unchanged" ? "ok" : "stale"
+    } : null;
+    return {
+      adapter,
+      entries,
+      mcp,
+      healthy: entries.length === totalSkillCount && entries.every((e) => e.status === "ok") && (mcp === null || mcp.status === "ok")
+    };
+  });
+}
+
+// src/commands/uninstall.ts
+import { existsSync, readFileSync, rmSync, writeFileSync } from "fs";
+import {
+  removeCodexMcpEntry,
+  removeJsonMcpEntry
+} from "@vovy-ai/host-detect";
+import { SKILL_MANIFEST } from "@vovy-ai/skills";
+var VOVY_ID = "vovy";
+function runUninstall(opts) {
+  const scope = opts.scope ?? "user";
+  const targets = resolveTargets(opts.env, opts.hosts);
+  const dryRun = opts.dryRun ?? false;
+  return targets.map((adapter) => {
+    const removedSkillPaths = [];
+    for (const skill of SKILL_MANIFEST) {
+      const path = adapter.skillFilePath(opts.env, scope, skill.id);
+      if (existsSync(path)) {
+        removedSkillPaths.push(path);
+        if (!dryRun) rmSync(path, { force: true });
+      }
+    }
+    let removedMcpEntry = null;
+    const mcpPath = adapter.mcpConfigPath(opts.env, scope);
+    if (mcpPath && existsSync(mcpPath)) {
+      const existing = readFileSync(mcpPath, "utf8");
+      const next = adapter.id === "codex" ? removeCodexMcpEntry(existing, VOVY_ID) : removeJsonMcpEntry(existing, VOVY_ID);
+      if (next !== null) {
+        removedMcpEntry = mcpPath;
+        if (!dryRun) writeFileSync(mcpPath, next, "utf8");
+      }
+    }
+    return { adapter, removedSkillPaths, removedMcpEntry };
+  });
+}
+
+// src/env.ts
+import { homedir } from "os";
+function realEnv() {
+  return { home: homedir(), cwd: process.cwd(), platform: process.platform };
+}
+
+// src/index.ts
+var HELP = `Vovy \u2014 free, forever, drop-in skills for vibe coding safely. Run via \`npx @vovy-ai/go\` (or \`vovy\` if installed globally).
+
+Usage:
+  npx @vovy-ai/go install [options]     Write Vovy's skills into detected (or specified) host tools
+  npx @vovy-ai/go doctor [options]      Check whether Vovy is correctly installed, without changing anything
+  npx @vovy-ai/go uninstall [options]   Remove everything Vovy's installer wrote
+
+Options:
+  --host <ids>       Comma-separated host ids to target instead of auto-detecting.
+                      Known hosts: ${ADAPTERS2.map((a) => a.id).join(", ")}
+  --scope <scope>    "user" (default, applies everywhere) or "project" (this directory only)
+  --dry-run          Show what would change without writing anything
+  --help             Show this message
+
+Vovy never runs its own AI model and never calls a Vovy-hosted server \u2014 it only writes
+markdown skill files that your existing AI coding tool reads for free with the model you
+already pay for. No account, no API key, no cost, ever.`;
+function parseCommonFlags(argv) {
+  const { values } = parseArgs({
+    args: argv,
+    options: {
+      host: { type: "string" },
+      scope: { type: "string" },
+      "dry-run": { type: "boolean", default: false },
+      help: { type: "boolean", default: false }
+    },
+    allowPositionals: true
+  });
+  const scope = values.scope;
+  if (scope && scope !== "user" && scope !== "project") {
+    throw new Error(`Invalid --scope "${scope}" \u2014 expected "user" or "project".`);
+  }
+  return {
+    hosts: values.host ? values.host.split(",").map((h) => h.trim()) : void 0,
+    scope,
+    dryRun: Boolean(values["dry-run"]),
+    help: Boolean(values.help)
+  };
+}
+function actionSymbol(action) {
+  if (action === "unchanged") return "=";
+  if (action === "created") return "+";
+  return "~";
+}
+function cmdInstall(argv) {
+  const flags = parseCommonFlags(argv);
+  if (flags.help) return console.log(HELP);
+  const env = realEnv();
+  const reports = runInstall({ env, hosts: flags.hosts, scope: flags.scope, dryRun: flags.dryRun });
+  if (reports.length === 0) {
+    console.log(
+      `No supported host tools detected on this machine.
+Use --host <${ADAPTERS2.map((a) => a.id).join("|")}> to install anyway.`
+    );
+    return;
+  }
+  const prefix = flags.dryRun ? "[dry-run] " : "";
+  for (const { adapter, skillResults, mcpResult } of reports) {
+    console.log(`
+${adapter.label}:`);
+    for (const r of skillResults) {
+      console.log(`  ${prefix}${actionSymbol(r.action)} ${r.skillId} -> ${r.path} (${r.action})`);
+    }
+    if (mcpResult) {
+      console.log(
+        `  ${prefix}${actionSymbol(mcpResult.action)} mcp server -> ${mcpResult.path} (${mcpResult.action})`
+      );
+    }
+  }
+  console.log(
+    flags.dryRun ? "\nDry run only \u2014 nothing was written. Re-run without --dry-run to apply." : "\nDone. Vovy's skills are now available in your tool(s) above."
+  );
+}
+function cmdDoctor(argv) {
+  const flags = parseCommonFlags(argv);
+  if (flags.help) return console.log(HELP);
+  const env = realEnv();
+  const reports = runDoctor(env, flags.hosts, flags.scope);
+  if (reports.length === 0) {
+    console.log("No supported host tools detected on this machine \u2014 nothing to check.");
+    return;
+  }
+  let allHealthy = true;
+  for (const { adapter, entries, mcp, healthy } of reports) {
+    allHealthy &&= healthy;
+    console.log(`
+${adapter.label}: ${healthy ? "OK" : "needs `npx @vovy-ai/go install`"}`);
+    for (const e of entries) {
+      console.log(`  [${e.status === "ok" ? "x" : " "}] ${e.skillId} (${e.status})`);
+    }
+    if (mcp) {
+      console.log(`  [${mcp.status === "ok" ? "x" : " "}] mcp server (${mcp.status})`);
+    }
+  }
+  process.exitCode = allHealthy ? 0 : 1;
+}
+function cmdUninstall(argv) {
+  const flags = parseCommonFlags(argv);
+  if (flags.help) return console.log(HELP);
+  const env = realEnv();
+  const reports = runUninstall({
+    env,
+    hosts: flags.hosts,
+    scope: flags.scope,
+    dryRun: flags.dryRun
+  });
+  if (reports.length === 0) {
+    console.log("No supported host tools detected on this machine \u2014 nothing to remove.");
+    return;
+  }
+  const prefix = flags.dryRun ? "[dry-run] " : "";
+  for (const { adapter, removedSkillPaths, removedMcpEntry } of reports) {
+    console.log(`
+${adapter.label}:`);
+    if (removedSkillPaths.length === 0 && !removedMcpEntry) {
+      console.log("  nothing to remove");
+      continue;
+    }
+    for (const p of removedSkillPaths) console.log(`  ${prefix}- removed ${p}`);
+    if (removedMcpEntry) console.log(`  ${prefix}- removed vovy entry from ${removedMcpEntry}`);
+  }
+  console.log(flags.dryRun ? "\nDry run only \u2014 nothing was removed." : "\nDone.");
+}
+async function main() {
+  const [command, ...rest] = process.argv.slice(2);
+  switch (command) {
+    case "install":
+      return cmdInstall(rest);
+    case "doctor":
+      return cmdDoctor(rest);
+    case "uninstall":
+      return cmdUninstall(rest);
+    case "--help":
+    case "-h":
+    case void 0:
+      return console.log(HELP);
+    default:
+      console.error(`Unknown command "${command}".
+`);
+      console.log(HELP);
+      process.exitCode = 1;
+  }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main().catch((error) => {
+    console.error(`vovy: ${error instanceof Error ? error.message : String(error)}`);
+    process.exitCode = 1;
+  });
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@vovy-ai/go",
+  "version": "0.1.0",
+  "description": "Free, forever, drop-in MCP server + skill pack that teaches non-technical founders to vibe code safely. npx @vovy-ai/go install",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "vovy": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@vovy-ai/host-detect": "0.1.0",
+    "@vovy-ai/skills": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts --format esm --dts --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}