@proggarapsody/bitbottle 1.12.0 → 1.13.1

package/README.md

@@ -26,6 +26,15 @@ $ bitbottle pr create --title "fix: handle empty diff" --base main
 npm install -g @proggarapsody/bitbottle
 ```
 
+This also registers the bundled AI agent skill (`SKILL.md`) with any
+agent runtimes detected on your machine — Claude Code, Cursor, Codex,
+Gemini CLI, and 50+ others — so your agents know how to drive bitbottle
+correctly. Skip with `BITBOTTLE_SKIP_SKILL_INSTALL=1 npm install -g …`.
+Install or refresh manually:
+```bash
+npx -y skills add proggarapsody/bitbottle --global -y
+```
+
 **Go install:**
 ```bash
 go install github.com/proggarapsody/bitbottle/cmd/bitbottle@latest

package/install.js

@@ -80,4 +80,67 @@ downloadFile(url, archiveDest, (err) => {
     console.error("Extraction failed:", e.message);
     process.exit(1);
   }
+
+  // Best-effort: register the bitbottle SKILL.md with any AI agent
+  // runtimes the user has installed (Claude Code, Cursor, Codex, etc.).
+  // Uses vercel-labs/skills which knows the canonical install path for
+  // each runtime and symlinks/copies SKILL.md from the GitHub repo.
+  //
+  // This is fire-and-forget: failures (no network, no agent runtimes,
+  // sudo install on root's HOME) must NOT break the binary install.
+  installSkill();
 });
+
+function installSkill() {
+  // Opt-out via env var.
+  if (process.env.BITBOTTLE_SKIP_SKILL_INSTALL === "1") {
+    return;
+  }
+  // Skip in CI — most CI environments install bitbottle as a build
+  // dependency, not for interactive agent use. Avoids hanging the
+  // pipeline on a no-op skill registration.
+  if (process.env.CI || process.env.GITHUB_ACTIONS) {
+    return;
+  }
+  // Skip when running under sudo: postinstall runs as root, so the
+  // skill would land in /root/.claude/skills (or similar) instead of
+  // the user's home, which silently does nothing useful. Detect via
+  // SUDO_USER and bail with a hint.
+  if (process.env.SUDO_USER && process.getuid && process.getuid() === 0) {
+    console.log(
+      "Skipped agent skill registration (running under sudo). " +
+        "Re-run as your user: npx -y skills add proggarapsody/bitbottle --global -y"
+    );
+    return;
+  }
+
+  console.log("Registering bitbottle agent skill (Claude Code, Cursor, Codex, …)…");
+  const env = { ...process.env, npm_config_yes: "true" };
+  const skillsCmd = (cmd) =>
+    execSync(cmd, { stdio: "ignore", timeout: 60_000, env });
+  try {
+    // Remove first so reinstalls actually pick up new SKILL.md content.
+    // `skills add` is idempotent and skips when the skill already exists,
+    // which means a fresh `npm i -g` after a release would NOT refresh
+    // the skill — defeating the whole point of postinstall. Removing
+    // first guarantees `add` writes the latest content.
+    try {
+      skillsCmd("npx -y skills remove bitbottle -g -y");
+    } catch (_) {
+      // not installed yet; that's fine
+    }
+    skillsCmd("npx -y skills add proggarapsody/bitbottle --global -y");
+    console.log(
+      "Agent skill registered. Set BITBOTTLE_SKIP_SKILL_INSTALL=1 to disable on next install."
+    );
+  } catch (e) {
+    // Non-fatal. Common causes: offline, no agent runtimes installed,
+    // npx blocked by corporate proxy, timeout. The CLI still works.
+    console.log(
+      "Skipped agent skill registration: " +
+        (e.message || "unknown error") +
+        ". " +
+        "Install manually with: npx -y skills add proggarapsody/bitbottle --global -y"
+    );
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proggarapsody/bitbottle",
-  "version": "1.12.0",
+  "version": "1.13.1",
   "description": "Bitbucket CLI for Server/Data Center and Cloud — npm wrapper for bitbottle",
   "keywords": [
     "mcp",