@xevy/cli 0.1.0

package/README.md

@@ -0,0 +1,71 @@
+# @xevy/cli
+
+The **`xevy`** command — one step to get Xevy working in your AI agent.
+
+```bash
+npx @xevy/cli setup
+```
+
+`xevy setup` installs the **Xevy SDLC agent skills** and the **Xevy MCP server**
+into your user-global agent config, for [Cursor, Claude Code, and 50+ other
+agents](https://github.com/vercel-labs/skills#supported-agents).
+
+## No API key — OAuth like any MCP
+
+The Xevy MCP server signs in with **OAuth**, completed inside your agent the
+first time it connects. There is no API key to find in a dashboard, paste, or
+store on disk.
+
+- **Cursor:** Settings → MCP → `xevy` → connect
+- **Claude Code:** browser sign-in on the first MCP call
+
+## What it does (and doesn't)
+
+- ✅ Installs skills globally (`~/.cursor/skills`, `~/.claude/skills`, `~/.agents/skills`, …)
+- ✅ Writes the MCP server to your agent's **global** config
+- ❌ No per-repo files, no project detection, no repo linking
+
+To link a specific repository to a Xevy project later, run the bundled
+`xevy-setup` skill from inside your agent (it uses the MCP tools over OAuth).
+
+## Install permanently
+
+```bash
+npm i -g @xevy/cli
+xevy setup
+```
+
+## Options
+
+```
+xevy setup [options]
+
+  -a, --agent <name>   Target agent (repeatable). Default: cursor, claude-code
+      --base <url>     Xevy host (default: XEVY_BASE or https://xevy.ai)
+      --skills-only    Install skills only (skip MCP)
+      --mcp-only       Configure the OAuth MCP server only (skip skills)
+      --copy           Copy skill files instead of symlinking
+  -v, --version        Print the CLI version
+  -h, --help           Show help
+```
+
+### Examples
+
+```bash
+npx @xevy/cli setup                                   # skills + MCP, global
+npx @xevy/cli setup -a cursor                         # Cursor only
+npx @xevy/cli setup --mcp-only                        # just the OAuth MCP
+XEVY_BASE=https://xevy.vyte.dev npx @xevy/cli setup   # non-default host
+```
+
+## How it works
+
+Under the hood `xevy setup` drives two well-known primitives:
+
+- [`npx skills`](https://github.com/vercel-labs/skills) — installs the skills
+- [`npx add-mcp`](https://github.com/neondatabase/add-mcp) — writes the MCP config
+
+Skills are sourced from the pinned [`@xevy/skills`](https://www.npmjs.com/package/@xevy/skills)
+dependency, so this CLI stays in step with the published skills.
+
+Docs: <https://xevy.ai/docs/mcp>

package/bin/xevy.mjs

@@ -0,0 +1,256 @@
+#!/usr/bin/env node
+/**
+ * @xevy/cli — the `xevy` command.
+ *
+ * `xevy setup` installs the Xevy SDLC agent skills and the Xevy MCP server
+ * globally, for Cursor / Claude Code / 50+ agents. The MCP server authenticates
+ * via OAuth (completed inside the agent on first connect) — there is NO API key
+ * to find, paste, or store. No repo/project detection or linking happens here.
+ *
+ * Under the hood it drives the same primitives the Xevy docs recommend:
+ *   • `npx skills add <dir>`  — copies/symlinks the skills into agent scopes
+ *   • `npx add-mcp <url>`     — writes the agent MCP config (OAuth on connect)
+ * Skills are sourced from the pinned `@xevy/skills` dependency, so this CLI
+ * stays in step with the published skills without duplicating them.
+ *
+ * Usage:
+ *   npx @xevy/cli setup            Install skills + MCP globally (OAuth)
+ *   npx @xevy/cli setup -a cursor  Only a specific agent (repeatable)
+ *   npx @xevy/cli setup --mcp-only Configure the OAuth MCP server only
+ *   npx @xevy/cli --version
+ */
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const require = createRequire(import.meta.url);
+const here = path.dirname(fileURLToPath(import.meta.url));
+const pkgRoot = path.resolve(here, "..");
+
+const DEFAULT_BASE = "https://xevy.ai";
+const DEFAULT_AGENTS = ["cursor", "claude-code"];
+const isWindows = process.platform === "win32";
+
+const PI_PACKAGE = "@mariozechner/pi-coding-agent";
+const PI_EXTENSION_DIR = path.join(os.homedir(), ".pi", "agent", "extensions");
+const MODEL_EXTENSION_FILE = "xevy-model.ts";
+
+function readCliVersion() {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(pkgRoot, "package.json"), "utf-8"));
+    return String(pkg.version || "0.0.0");
+  } catch {
+    return "0.0.0";
+  }
+}
+
+function die(msg) {
+  console.error(`✗ ${msg}`);
+  process.exit(1);
+}
+
+function usage() {
+  console.log(`Xevy CLI — install Xevy agent skills + OAuth MCP.
+
+  xevy setup [options]        Install skills + MCP globally (OAuth, no API key)
+  xevy pi [options]           Install the pi agent (if missing) + the xevy-model.ts extension
+
+Options:
+  -a, --agent <name>          Target agent (repeatable). Default: ${DEFAULT_AGENTS.join(", ")}
+      --base <url>            Xevy host (default: XEVY_BASE or ${DEFAULT_BASE})
+      --skills-only           Install skills only (skip MCP)
+      --mcp-only              Configure the OAuth MCP server only (skip skills)
+      --copy                  Copy skill files instead of symlinking
+  -v, --version              Print the CLI version
+  -h, --help                 Show this help
+
+Notes:
+  • Everything installs to your user-global scope — no per-repo files, no
+    project detection or linking.
+  • The MCP server signs in with OAuth from inside your agent on first
+    connect. There is no API key to paste.
+
+Examples:
+  npx @xevy/cli setup
+  npx @xevy/cli setup -a cursor
+  npx @xevy/cli pi
+  XEVY_BASE=https://xevy.vyte.dev npx @xevy/cli setup`);
+}
+
+function parseArgv(argv) {
+  const opts = {
+    command: "setup",
+    agents: [],
+    base: process.env.XEVY_BASE?.replace(/\/$/, "") || DEFAULT_BASE,
+    skillsOnly: false,
+    mcpOnly: false,
+    copy: false,
+  };
+
+  const args = [...argv];
+  if (args.length > 0 && !args[0].startsWith("-")) {
+    const cmd = args.shift();
+    if (cmd === "setup" || cmd === "pi") {
+      opts.command = cmd;
+    } else if (cmd === "help") {
+      opts.command = "help";
+      return opts;
+    } else {
+      die(`Unknown command: ${cmd}. Try \`xevy --help\`.`);
+    }
+  }
+
+  while (args.length > 0) {
+    const a = args.shift();
+    if (a === "-h" || a === "--help") return { ...opts, command: "help" };
+    if (a === "-v" || a === "--version") return { ...opts, command: "version" };
+    if (a === "-a" || a === "--agent") {
+      const v = args.shift();
+      if (!v) die("Missing value for --agent");
+      opts.agents.push(v);
+      continue;
+    }
+    if (a === "--base") {
+      const v = args.shift();
+      if (!v) die("Missing value for --base");
+      opts.base = v.replace(/\/$/, "");
+      continue;
+    }
+    if (a === "--skills-only") { opts.skillsOnly = true; continue; }
+    if (a === "--mcp-only") { opts.mcpOnly = true; continue; }
+    if (a === "--copy") { opts.copy = true; continue; }
+    die(`Unknown option: ${a}. Try \`xevy --help\`.`);
+  }
+
+  if (opts.skillsOnly && opts.mcpOnly) {
+    die("--skills-only and --mcp-only are mutually exclusive.");
+  }
+  if (opts.agents.length === 0) opts.agents = [...DEFAULT_AGENTS];
+  return opts;
+}
+
+function quoteArg(a) {
+  return /[\s"]/.test(a) ? `"${a.replace(/"/g, '\\"')}"` : a;
+}
+
+function run(cmd, args, { label } = {}) {
+  const title = label || [cmd, ...args].join(" ");
+  console.log(`→ ${title}`);
+  const command = isWindows && cmd === "npx" ? "npx.cmd" : cmd;
+  const finalArgs = isWindows ? args.map(quoteArg) : args;
+  const r = spawnSync(command, finalArgs, { stdio: "inherit", shell: isWindows, env: process.env });
+  if (r.error) die(r.error.message);
+  if (r.status !== 0) die(`Command failed (${r.status}): ${title}`);
+  return r;
+}
+
+/** Resolve the on-disk root of the pinned @xevy/skills dependency. */
+function resolveSkillsRoot() {
+  try {
+    return path.dirname(require.resolve("@xevy/skills/package.json"));
+  } catch {
+    die("Could not locate the bundled @xevy/skills package. Reinstall @xevy/cli and try again.");
+  }
+}
+
+function installSkills(opts) {
+  const skillsRoot = resolveSkillsRoot();
+  const args = ["--yes", "skills", "add", skillsRoot, "-g", "-y", "-s", "*"];
+  if (opts.copy) args.push("--copy");
+  for (const a of opts.agents) args.push("-a", a);
+  run("npx", args, { label: "npx skills add (Xevy skills, global)" });
+}
+
+function installMcp(opts) {
+  const mcpUrl = `${opts.base}/mcp`;
+  const args = ["--yes", "add-mcp", mcpUrl, "-n", "xevy", "-g", "-y"];
+  for (const a of opts.agents) args.push("-a", a);
+  run("npx", args, { label: `npx add-mcp ${mcpUrl} (OAuth, global)` });
+}
+
+function setup(opts) {
+  console.log("Setting up Xevy (global, OAuth — no API key)\n");
+
+  if (!opts.mcpOnly) installSkills(opts);
+  if (!opts.skillsOnly) installMcp(opts);
+
+  console.log("\n✓ Xevy setup complete.");
+  if (!opts.skillsOnly) {
+    console.log("  • Complete OAuth in your agent on first connect:");
+    console.log("      Cursor: Settings → MCP → xevy → connect");
+    console.log("      Claude Code: browser sign-in on first MCP call");
+  }
+  if (opts.base !== DEFAULT_BASE) {
+    console.log(`  • Host: ${opts.base} (set XEVY_BASE in your agent env too, then restart).`);
+  }
+  console.log(`  • Docs: ${opts.base}/docs/mcp`);
+}
+
+function hasPi() {
+  const r = spawnSync(isWindows ? "pi.cmd" : "pi", ["--version"], { stdio: "ignore", shell: isWindows });
+  return !r.error && r.status === 0;
+}
+
+function ensurePi() {
+  if (hasPi()) {
+    console.log("→ pi agent already installed");
+    return;
+  }
+  console.log(`→ pi agent not found — installing ${PI_PACKAGE} globally…`);
+  run("npm", ["install", "-g", PI_PACKAGE], { label: `npm install -g ${PI_PACKAGE}` });
+  if (!hasPi()) {
+    die("pi is still not on PATH after install. Ensure your npm global bin dir is on PATH, then re-run `xevy pi`.");
+  }
+}
+
+async function installModelExtension(opts) {
+  const url = `${opts.base}/${MODEL_EXTENSION_FILE}`;
+  console.log(`→ Downloading model extension ${url}`);
+
+  let source;
+  try {
+    const res = await fetch(url);
+    if (!res.ok) die(`Failed to download ${url} (HTTP ${res.status}).`);
+    source = await res.text();
+  } catch (error) {
+    die(`Could not fetch ${url}: ${error instanceof Error ? error.message : String(error)}`);
+  }
+
+  // Guard against a wrong --base returning the SPA HTML instead of the extension.
+  if (!source.includes("xevyModelExtension") || !source.includes("registerCommand")) {
+    die(`Downloaded ${url} does not look like the xevy-model extension (wrong --base?).`);
+  }
+
+  fs.mkdirSync(PI_EXTENSION_DIR, { recursive: true });
+  const dest = path.join(PI_EXTENSION_DIR, MODEL_EXTENSION_FILE);
+  fs.writeFileSync(dest, source, "utf-8");
+  console.log(`✓ Installed ${dest}`);
+}
+
+async function piSetup(opts) {
+  console.log("Setting up the pi agent + Xevy model extension\n");
+
+  ensurePi();
+  await installModelExtension(opts);
+
+  console.log("\n✓ pi + xevy-model.ts ready.");
+  console.log("  • In pi, run /agent-model to set or clear a per-agent model.");
+  console.log("  • If pi is already running, use /reload to load the extension.");
+  if (opts.base !== DEFAULT_BASE) {
+    console.log(`  • Source host: ${opts.base}`);
+  }
+}
+
+async function main() {
+  const opts = parseArgv(process.argv.slice(2));
+
+  if (opts.command === "help") return usage();
+  if (opts.command === "version") return console.log(readCliVersion());
+  if (opts.command === "setup") return setup(opts);
+  if (opts.command === "pi") return piSetup(opts);
+}
+
+main().catch((error) => die(error instanceof Error ? error.message : String(error)));

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@xevy/cli",
+  "version": "0.1.0",
+  "description": "Xevy CLI — one command (`xevy setup`) installs the Xevy SDLC agent skills and the OAuth MCP server globally for Cursor, Claude Code, and 50+ agents. No API key required.",
+  "type": "module",
+  "keywords": [
+    "xevy",
+    "cli",
+    "setup",
+    "mcp",
+    "oauth",
+    "agent-skills",
+    "cursor",
+    "claude-code",
+    "sdlc"
+  ],
+  "homepage": "https://xevy.ai/docs/mcp",
+  "license": "UNLICENSED",
+  "bin": {
+    "xevy": "bin/xevy.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@xevy/skills": "^0.1.18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}