buzz-agent-skill 0.1.0 → 0.2.0

package/README.md

@@ -8,7 +8,7 @@ Buzz Desktop or a source installation, so updating Buzz also updates the CLI.
 ## Install
 
 ```bash
-npx buzz-agent-skill install
+npx buzz-agent-skill@latest install
 ```
 
 This installs the skill into:
@@ -22,14 +22,28 @@ This installs the skill into:
 npx buzz-agent-skill@latest update
 ```
 
+## Uninstall
+
+```bash
+npx buzz-agent-skill@latest uninstall
+```
+
 ## Check
 
 ```bash
-npx buzz-agent-skill check
+npx buzz-agent-skill@latest check
 ```
 
-The check reports skill versions, CLI availability, and whether Buzz
-authentication variables are set. It never prints secret values.
+Commands print a concise, human-readable summary by default.
+
+Add `--json` to any command for machine-readable output:
+
+```bash
+npx buzz-agent-skill@latest install --json
+npx buzz-agent-skill@latest update --json
+npx buzz-agent-skill@latest uninstall --json
+npx buzz-agent-skill@latest check --json
+```
 
 ## CLI installation
 
@@ -44,4 +58,3 @@ For source builds:
 ```bash
 cargo build --release -p buzz-cli
 ```
-

package/bin/buzz-skill.mjs

@@ -20,9 +20,10 @@ import { fileURLToPath } from "node:url";
 const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const sourceSkill = join(packageRoot, "skill", "buzz");
 const markerName = ".buzz-skill-package.json";
+const skillHome = process.env.BUZZ_SKILL_HOME || homedir();
 const targets = [
-  { agent: "codex", path: join(homedir(), ".codex", "skills", "buzz") },
-  { agent: "claude", path: join(homedir(), ".claude", "skills", "buzz") },
+  { agent: "codex", path: join(skillHome, ".codex", "skills", "buzz") },
+  { agent: "claude", path: join(skillHome, ".claude", "skills", "buzz") },
 ];
 
 function packageVersion() {
@@ -79,6 +80,20 @@ function installTarget({ agent, path }, force) {
   return { agent, path, version: packageVersion() };
 }
 
+function uninstallTarget({ agent, path }, force) {
+  if (!existsSync(path)) {
+    return { agent, path, removed: false, reason: "not installed" };
+  }
+  if (!marker(path) && !force) {
+    throw new Error(
+      `${agent}: ${path} is not managed by buzz-agent-skill; rerun with --force to remove it`,
+    );
+  }
+
+  rmSync(path, { recursive: true, force: true });
+  return { agent, path, removed: true };
+}
+
 function findBuzz() {
   try {
     return execFileSync(
@@ -98,7 +113,7 @@ function ensureMacCliLink() {
   const bundled = "/Applications/Buzz.app/Contents/MacOS/buzz";
   if (!existsSync(bundled)) return null;
 
-  const link = join(homedir(), ".local", "bin", "buzz");
+  const link = join(skillHome, ".local", "bin", "buzz");
   mkdirSync(dirname(link), { recursive: true });
   if (existsSync(link) || lstatExists(link)) {
     if (lstatSync(link).isSymbolicLink() && readlinkSync(link) === bundled) {
@@ -159,36 +174,142 @@ function status() {
   };
 }
 
+function formatStatus(result) {
+  const lines = [
+    `Buzz Agent Skill v${result.package_version}`,
+    "",
+    `${result.cli.ok ? "✓" : "✗"} Buzz CLI${
+      result.cli.path ? `  ${result.cli.path}` : ""
+    }`,
+  ];
+
+  if (!result.cli.ok && result.cli.message) {
+    lines.push(`  ${result.cli.message}`);
+  }
+
+  lines.push("", "Agent skills");
+  for (const skill of result.skills) {
+    const ok = skill.installed && skill.managed;
+    const details = [
+      skill.installed ? "installed" : "not installed",
+      skill.managed ? "managed" : "not managed",
+      skill.version ? `v${skill.version}` : null,
+    ]
+      .filter(Boolean)
+      .join(" · ");
+    lines.push(
+      `${ok ? "✓" : "✗"} ${skill.agent.padEnd(7)} ${details}`,
+      `  ${skill.path}`,
+    );
+  }
+
+  const healthy =
+    result.cli.ok &&
+    result.skills.every((skill) => skill.installed && skill.managed);
+  lines.push("", healthy ? "Everything looks good." : "Some items need attention.");
+  return lines.join("\n");
+}
+
+function formatChange(result) {
+  const verbs = {
+    install: "Installed",
+    update: "Updated",
+    uninstall: "Uninstalled",
+  };
+  const lines = [
+    `${verbs[result.action]} Buzz Agent Skill v${result.package_version}`,
+    "",
+  ];
+
+  for (const skill of result.skills) {
+    const changed =
+      result.action === "uninstall" ? skill.removed : Boolean(skill.version);
+    const detail = changed
+      ? result.action === "uninstall"
+        ? "removed"
+        : `v${skill.version}`
+      : skill.reason;
+    lines.push(
+      `${changed ? "✓" : "–"} ${skill.agent.padEnd(7)} ${detail}`,
+      `  ${skill.path}`,
+    );
+  }
+
+  if (result.cli) {
+    lines.push(
+      "",
+      `${result.cli.ok ? "✓" : "✗"} Buzz CLI${
+        result.cli.path ? `  ${result.cli.path}` : ""
+      }`,
+    );
+    if (!result.cli.ok && result.cli.message) {
+      lines.push(`  ${result.cli.message}`);
+    }
+  }
+
+  lines.push("", "Done.");
+  return lines.join("\n");
+}
+
+function usage() {
+  return [
+    "Buzz Agent Skill",
+    "",
+    "Usage:",
+    "  buzz-skill install [--force] [--json]",
+    "  buzz-skill update [--force] [--json]",
+    "  buzz-skill uninstall [--force] [--json]",
+    "  buzz-skill check [--json]",
+    "",
+    "Options:",
+    "  --force  Replace or remove skill folders not managed by this package",
+    "  --json   Print machine-readable JSON",
+    "  --help   Show this help",
+  ].join("\n");
+}
+
 const [command = "check", ...args] = process.argv.slice(2);
 const force = args.includes("--force");
+const json = args.includes("--json");
 
 try {
   if (command === "install" || command === "update") {
-    const installed = targets.map((target) => installTarget(target, force));
-    const result = { installed, cli: cliStatus() };
-    console.log(JSON.stringify(result, null, 2));
+    const result = {
+      action: command,
+      package_version: packageVersion(),
+      skills: targets.map((target) => installTarget(target, force)),
+      cli: cliStatus(),
+    };
+    console.log(json ? JSON.stringify(result, null, 2) : formatChange(result));
     if (!result.cli.ok) process.exitCode = 1;
+  } else if (command === "uninstall") {
+    const result = {
+      action: command,
+      package_version: packageVersion(),
+      skills: targets.map((target) => uninstallTarget(target, force)),
+    };
+    console.log(json ? JSON.stringify(result, null, 2) : formatChange(result));
   } else if (command === "check") {
     const result = status();
-    console.log(JSON.stringify(result, null, 2));
+    console.log(json ? JSON.stringify(result, null, 2) : formatStatus(result));
     if (
       !result.cli.ok ||
       result.skills.some((skill) => !skill.installed || !skill.managed)
     ) {
       process.exitCode = 1;
     }
+  } else if (command === "help" || command === "--help" || command === "-h") {
+    console.log(usage());
   } else {
-    console.error(
-      "Usage: buzz-skill <install|update|check> [--force]",
-    );
+    console.error(usage());
     process.exitCode = 1;
   }
 } catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
   console.error(
-    JSON.stringify({
-      ok: false,
-      error: error instanceof Error ? error.message : String(error),
-    }),
+    json
+      ? JSON.stringify({ ok: false, command, error: message }, null, 2)
+      : `✗ ${command} failed\n\n${message}`,
   );
   process.exitCode = 1;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buzz-agent-skill",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Install and update the Buzz CLI skill for Codex and Claude Code",
   "type": "module",
   "bin": {
@@ -12,7 +12,8 @@
   ],
   "scripts": {
     "check": "node ./bin/buzz-skill.mjs check",
-    "install-skill": "node ./bin/buzz-skill.mjs install"
+    "install-skill": "node ./bin/buzz-skill.mjs install",
+    "uninstall-skill": "node ./bin/buzz-skill.mjs uninstall"
   },
   "engines": {
     "node": ">=20"