@windyroad/agent-plugins 0.1.1

package/bin/install.mjs

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const utils = await import(resolve(__dirname, "../lib/install-utils.mjs"));
+
+const PLUGINS = [
+  "wr-architect",
+  "wr-risk-scorer",
+  "wr-voice-tone",
+  "wr-style-guide",
+  "wr-jtbd",
+  "wr-tdd",
+  "wr-retrospective",
+  "wr-problem",
+  "wr-c4",
+  "wr-wardley",
+];
+
+const HELP = `
+Usage: npx @windyroad/agent-plugins [options]
+
+Install, update, or uninstall all Windy Road AI agent plugins and skills.
+
+Commands:
+  (default)         Install all plugins and skills
+  --update          Update marketplace and reinstall all plugins and skills
+  --uninstall       Remove all plugins and skills
+
+Options:
+  --plugin <names>  Install only specific plugins (space-separated)
+                    e.g. --plugin architect tdd risk-scorer
+  --dry-run         Show what would be done without executing
+  --help, -h        Show this help
+
+Available plugins:
+  architect, risk-scorer, voice-tone, style-guide, jtbd,
+  tdd, problem, retrospective, c4, wardley
+
+Examples:
+  npx @windyroad/agent-plugins
+  npx @windyroad/agent-plugins --plugin architect tdd risk-scorer
+  npx @windyroad/agent-plugins --update
+  npx @windyroad/agent-plugins --uninstall
+`;
+
+function parseArgs(argv) {
+  const args = argv.slice(2);
+  const flags = {
+    help: false,
+    uninstall: false,
+    update: false,
+    dryRun: false,
+    plugins: null,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    switch (args[i]) {
+      case "--help":
+      case "-h":
+        flags.help = true;
+        break;
+      case "--uninstall":
+        flags.uninstall = true;
+        break;
+      case "--update":
+        flags.update = true;
+        break;
+      case "--dry-run":
+        flags.dryRun = true;
+        break;
+      case "--plugin":
+      case "--plugins": {
+        flags.plugins = [];
+        while (i + 1 < args.length && !args[i + 1].startsWith("--")) {
+          i++;
+          // Accept both "architect" and "wr-architect"
+          const raw = args[i];
+          const name = raw.startsWith("wr-") ? raw : `wr-${raw}`;
+          if (PLUGINS.includes(name)) {
+            flags.plugins.push(name);
+          } else {
+            const available = PLUGINS.map((p) => p.replace("wr-", "")).join(", ");
+            console.error(`Unknown plugin: ${raw}\nAvailable: ${available}`);
+            process.exit(1);
+          }
+        }
+        if (flags.plugins.length === 0) {
+          const available = PLUGINS.map((p) => p.replace("wr-", "")).join(", ");
+          console.error(`--plugin requires at least one name.\nAvailable: ${available}`);
+          process.exit(1);
+        }
+        break;
+      }
+      default:
+        console.error(`Unknown option: ${args[i]}\n`);
+        console.log(HELP);
+        process.exit(1);
+    }
+  }
+
+  return flags;
+}
+
+function doInstall(plugins) {
+  console.log("\nInstalling Windy Road AI agent plugins and skills...\n");
+
+  console.log("[1/3] Adding marketplace...");
+  utils.addMarketplace();
+
+  console.log(`\n[2/3] Installing plugins (${plugins.length})...`);
+  let installed = 0;
+  for (const plugin of plugins) {
+    if (utils.installPlugin(plugin)) installed++;
+  }
+  console.log(`  ${installed}/${plugins.length} plugins installed.`);
+
+  console.log("\n[3/3] Installing skills...");
+  utils.installSkills();
+
+  console.log(`
+Done! Restart Claude Code to activate all plugins.
+
+Installed:
+  - ${installed} plugins (agents + hooks)
+  - Skills (type /wr: to see them in autocomplete)
+
+To update:    npx @windyroad/agent-plugins --update
+To uninstall: npx @windyroad/agent-plugins --uninstall
+`);
+}
+
+function doUpdate(plugins) {
+  console.log("\nUpdating Windy Road AI agent plugins and skills...\n");
+
+  console.log("[1/3] Updating marketplace...");
+  utils.run(
+    `claude plugin marketplace update ${utils.MARKETPLACE_NAME}`,
+    `Marketplace: ${utils.MARKETPLACE_NAME}`
+  );
+
+  console.log(`\n[2/3] Updating plugins (${plugins.length})...`);
+  let updated = 0;
+  for (const plugin of plugins) {
+    if (utils.updatePlugin(plugin)) updated++;
+  }
+  console.log(`  ${updated}/${plugins.length} plugins updated.`);
+
+  console.log("\n[3/3] Updating skills...");
+  utils.updateSkills();
+
+  console.log("\nDone! Restart Claude Code to apply updates.\n");
+}
+
+function doUninstall(plugins) {
+  console.log("\nUninstalling Windy Road plugins...\n");
+
+  for (const plugin of plugins) {
+    utils.uninstallPlugin(plugin);
+  }
+
+  utils.removeSkills();
+
+  console.log("\nDone. Restart Claude Code to apply changes.\n");
+}
+
+const flags = parseArgs(process.argv);
+
+if (flags.help) {
+  console.log(HELP);
+  process.exit(0);
+}
+
+if (flags.dryRun) {
+  utils.setDryRun(true);
+  console.log("[dry-run mode — no commands will be executed]\n");
+}
+
+utils.checkPrerequisites();
+
+const plugins = flags.plugins ?? PLUGINS;
+
+if (flags.uninstall) {
+  doUninstall(plugins);
+} else if (flags.update) {
+  doUpdate(plugins);
+} else {
+  doInstall(plugins);
+}

package/lib/install-utils.mjs

@@ -0,0 +1,163 @@
+/**
+ * Shared install utilities for @windyroad/* packages.
+ * Used by both per-plugin installers and the meta-installer.
+ */
+
+import { execSync } from "node:child_process";
+
+const MARKETPLACE_REPO = "windyroad/agent-plugins";
+const MARKETPLACE_NAME = "windyroad";
+
+let _dryRun = false;
+
+export { MARKETPLACE_REPO, MARKETPLACE_NAME };
+
+export function setDryRun(value) {
+  _dryRun = value;
+}
+
+export function isDryRun() {
+  return _dryRun;
+}
+
+export function run(cmd, label) {
+  console.log(`  ${label}...`);
+  if (_dryRun) {
+    console.log(`    [dry-run] ${cmd}`);
+    return true;
+  }
+  try {
+    execSync(cmd, { stdio: "inherit" });
+    return true;
+  } catch {
+    console.error(`  FAILED: ${label}`);
+    return false;
+  }
+}
+
+export function checkPrerequisites() {
+  if (_dryRun) return;
+
+  try {
+    execSync("claude --version", { stdio: "pipe" });
+  } catch {
+    console.error(
+      "Error: 'claude' CLI not found. Install Claude Code first:\n  https://docs.anthropic.com/en/docs/claude-code\n"
+    );
+    process.exit(1);
+  }
+
+  try {
+    execSync("npx --version", { stdio: "pipe" });
+  } catch {
+    console.error(
+      "Error: 'npx' not found. Install Node.js first:\n  https://nodejs.org\n"
+    );
+    process.exit(1);
+  }
+}
+
+export function addMarketplace() {
+  return run(
+    `claude plugin marketplace add ${MARKETPLACE_REPO}`,
+    `Marketplace: ${MARKETPLACE_NAME}`
+  );
+}
+
+export function installPlugin(pluginName) {
+  return run(
+    `claude plugin install ${pluginName}@${MARKETPLACE_NAME}`,
+    pluginName
+  );
+}
+
+export function updatePlugin(pluginName) {
+  return run(`claude plugin update ${pluginName}`, pluginName);
+}
+
+export function uninstallPlugin(pluginName) {
+  return run(`claude plugin uninstall ${pluginName}`, `Removing ${pluginName}`);
+}
+
+export function installSkills() {
+  return run(
+    `npx -y skills add --yes --all ${MARKETPLACE_REPO}`,
+    "Skills (via skills package)"
+  );
+}
+
+export function updateSkills() {
+  return run("npx -y skills update", "Skills update");
+}
+
+export function removeSkills() {
+  return run(
+    `npx -y skills remove --yes --all ${MARKETPLACE_REPO}`,
+    "Removing skills"
+  );
+}
+
+/**
+ * Install a single package: marketplace add + plugin install + skills.
+ */
+export function installPackage(pluginName, { deps = [] } = {}) {
+  console.log(`\nInstalling @windyroad/${pluginName.replace("wr-", "")}...\n`);
+
+  addMarketplace();
+  installPlugin(pluginName);
+  installSkills();
+
+  if (deps.length > 0) {
+    console.log(`\nNote: This plugin works best with:`);
+    for (const dep of deps) {
+      console.log(`  - @windyroad/${dep.replace("wr-", "")} (npx @windyroad/${dep.replace("wr-", "")})`);
+    }
+  }
+
+  console.log(
+    `\nDone! Restart Claude Code to activate.\n`
+  );
+}
+
+/**
+ * Update a single package.
+ */
+export function updatePackage(pluginName) {
+  console.log(`\nUpdating @windyroad/${pluginName.replace("wr-", "")}...\n`);
+
+  run(
+    `claude plugin marketplace update ${MARKETPLACE_NAME}`,
+    "Updating marketplace"
+  );
+  updatePlugin(pluginName);
+  updateSkills();
+
+  console.log("\nDone! Restart Claude Code to apply updates.\n");
+}
+
+/**
+ * Uninstall a single package.
+ */
+export function uninstallPackage(pluginName) {
+  console.log(`\nUninstalling @windyroad/${pluginName.replace("wr-", "")}...\n`);
+
+  uninstallPlugin(pluginName);
+
+  console.log("\nDone. Restart Claude Code to apply changes.\n");
+  console.log("Note: Skills are shared across packages. Run");
+  console.log("  npx @windyroad/agent-plugins --uninstall");
+  console.log("to remove all skills.\n");
+}
+
+/**
+ * Parse standard flags used by all per-plugin installers.
+ */
+export function parseStandardArgs(argv) {
+  const args = argv.slice(2);
+  return {
+    help: args.includes("--help") || args.includes("-h"),
+    uninstall: args.includes("--uninstall"),
+    update: args.includes("--update"),
+    dryRun: args.includes("--dry-run"),
+  };
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@windyroad/agent-plugins",
+  "version": "0.1.1",
+  "description": "One-command installer for all Windy Road AI agent plugins and skills",
+  "bin": {
+    "windyroad-agent-plugins": "./bin/install.mjs"
+  },
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/windyroad/agent-plugins.git",
+    "directory": "packages/agent-plugins"
+  },
+  "keywords": [
+    "claude-code",
+    "claude-code-plugin",
+    "ai-agent",
+    "ai-coding",
+    "codex",
+    "copilot"
+  ],
+  "files": [
+    "bin/",
+    "lib/"
+  ]
+}