vibeview 0.8.1 → 0.9.0

package/README.md

@@ -46,6 +46,14 @@ vibeview tap @e5            # act — the response says what changed
 vibeview screenshot --out ./check.png
 ```
 
+One command makes it discoverable to your agent — it installs the bundled
+`vibeview-agent` skill where Claude Code finds it automatically and offers
+to register the MCP server:
+
+```bash
+vibeview agent-setup
+```
+
 Every command works over MCP too, for agents without shell access:
 
 ```bash
@@ -53,7 +61,7 @@ claude mcp add vibeview -- vibeview mcp
 ```
 
 Other MCP clients (Cursor, Claude Desktop, VS Code Copilot) run command
-`vibeview` with args `["mcp"]`. The package also ships a ready-made skill at
+`vibeview` with args `["mcp"]`. The package also ships the skill at
 `skills/vibeview-agent/SKILL.md` describing the whole workflow.
 
 [Agent control docs →](https://vibeview.io/docs/agent-control)
@@ -84,6 +92,7 @@ Output formats: `human`, `json`, and `junit` for any CI system. The exit code re
 | `vibeview dev` | Live development on a cloud device |
 | `vibeview build` | Build your app and upload it |
 | `vibeview dev-status` / `dev-stop` | Check on, or stop, a backgrounded dev session |
+| `vibeview agent-setup` | Make VibeView discoverable to your coding agent (skill + MCP) |
 | `vibeview mcp` | Run the MCP server so an agent can drive the device |
 | `vibeview ui-tree` | The current screen's elements, each with a ref to act on |
 | `vibeview screenshot` | Capture the screen to a PNG |

package/dist/cli.js

@@ -1205,6 +1205,104 @@ function readMetadataFile(path) {
   return parsed;
 }
 
+// src/commands/agent-setup.ts
+import { copyFileSync, existsSync as existsSync2, mkdirSync } from "fs";
+import { homedir } from "os";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { spawnSync } from "child_process";
+import { confirm } from "@inquirer/prompts";
+import chalk11 from "chalk";
+function resolveShippedSkillPath(fromDir) {
+  for (const rel of ["..", join("..", "..")]) {
+    const candidate = join(fromDir, rel, "skills", "vibeview-agent", "SKILL.md");
+    if (existsSync2(candidate)) return candidate;
+  }
+  return null;
+}
+function skillInstallDir(project, cwd, home) {
+  const base = project ? cwd : home;
+  return join(base, ".claude", "skills", "vibeview-agent");
+}
+function installSkill(shippedPath, targetDir) {
+  const target = join(targetDir, "SKILL.md");
+  const existed = existsSync2(target);
+  mkdirSync(targetDir, { recursive: true });
+  copyFileSync(shippedPath, target);
+  return existed ? "updated" : "installed";
+}
+var CLAUDE_MD_SUGGESTION = "After changing UI or app behavior, verify it on a live device with the `vibeview` CLI \u2014 the vibeview-agent skill covers the workflow.";
+function claudeCliAvailable() {
+  return spawnSync("claude", ["--version"], { stdio: "ignore" }).error === void 0;
+}
+function registerMcp() {
+  const res = spawnSync("claude", ["mcp", "add", "vibeview", "--", "vibeview", "mcp"], {
+    encoding: "utf8"
+  });
+  if (res.status === 0) {
+    console.log(chalk11.green("\u2713 MCP server registered with Claude Code (claude mcp add vibeview)"));
+    return;
+  }
+  const out = `${res.stderr ?? ""}${res.stdout ?? ""}`;
+  if (out.includes("already exists")) {
+    console.log(chalk11.dim("MCP server already registered with Claude Code \u2014 nothing to do"));
+    return;
+  }
+  console.error(chalk11.yellow(`\u26A0 could not register the MCP server: ${out.trim() || res.error}`));
+  console.error(chalk11.yellow("  register it manually: claude mcp add vibeview -- vibeview mcp"));
+}
+async function agentSetup(opts) {
+  const moduleDir = dirname(fileURLToPath(import.meta.url));
+  const shipped = resolveShippedSkillPath(moduleDir);
+  if (!shipped) {
+    console.error(
+      chalk11.red(
+        "error: could not find the packaged skill (skills/vibeview-agent/SKILL.md) \u2014 is this a complete install of the vibeview package?"
+      )
+    );
+    process.exitCode = 1;
+    return;
+  }
+  const targetDir = skillInstallDir(opts.project ?? false, process.cwd(), homedir());
+  const result = installSkill(shipped, targetDir);
+  console.log(chalk11.green(`\u2713 vibeview-agent skill ${result}: ${join(targetDir, "SKILL.md")}`));
+  console.log(
+    chalk11.dim(
+      opts.project ? "  Claude Code discovers it automatically for anyone working in this project." : "  Claude Code discovers it automatically in every project on this machine."
+    )
+  );
+  if (opts.mcp !== false) {
+    if (!claudeCliAvailable()) {
+      if (opts.mcp === true) {
+        console.error(
+          chalk11.yellow(
+            "\u26A0 claude CLI not found \u2014 install Claude Code, then run: claude mcp add vibeview -- vibeview mcp"
+          )
+        );
+      }
+    } else if (opts.mcp === true || process.stdin.isTTY && await confirm({
+      message: "Register the MCP server with Claude Code? (claude mcp add vibeview)",
+      default: true
+    })) {
+      registerMcp();
+    }
+  }
+  console.log(
+    `
+Suggested line for your project's ${chalk11.bold("CLAUDE.md")} (or ${chalk11.bold(
+      "AGENTS.md"
+    )} for other agents):
+`
+  );
+  console.log(`  ${CLAUDE_MD_SUGGESTION}
+`);
+  console.log(
+    chalk11.dim(
+      "Other agents (Cursor, Copilot, Codex, ...): point them at the skill file above, or\nadd the MCP server per client \u2014 see https://vibeview.io/docs/agent-control"
+    )
+  );
+}
+
 // src/cli.ts
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../package.json");
@@ -1353,6 +1451,9 @@ program.command("mcp").description(
   const { runMcpServer } = await import("./server-S3D724K3.js");
   await runMcpServer(opts);
 });
+program.command("agent-setup").description(
+  "Make VibeView discoverable to your coding agent: install the vibeview-agent skill (and optionally register the MCP server with Claude Code)"
+).option("--project", "Install into this project's .claude/skills/ instead of ~/.claude/skills/").option("--mcp", "Register the MCP server with Claude Code without asking").option("--no-mcp", "Skip MCP registration").action((opts) => agentSetup(opts));
 for (const cmd of AGENT_COMMANDS) {
   const positionalParams = cmd.params.filter((p) => p.cli === "positional");
   const flagParams = cmd.params.filter((p) => p.cli !== "positional");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibeview",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "VibeView CLI -- run mobile tests from CI/CD pipelines",
   "type": "module",
   "bin": {