peerband 0.1.0 → 0.1.1

package/README.md

@@ -17,6 +17,18 @@ Your MCP client can list agents, read their status and bounded recent output, an
 
 ## Install
 
+Recommended (Node.js 22.13+, Herdr 0.9.3+):
+
+```sh
+npm install -g peerband && peerband login
+```
+
+`peerband login` opens your browser so you can approve this machine, then checks for Herdr and offers to add the PeerBand plugin to it (`Add the PeerBand plugin to Herdr now? [Y/n]`). After that, `peerband relay` opens the PeerBand Relay tab. If Herdr is not installed yet, login tells you how to finish later (install Herdr from https://herdr.dev, then `peerband herdr install` and `peerband relay`). Use `peerband login --herdr-plugin install` to add the plugin without being asked, or `--herdr-plugin skip` to leave Herdr alone.
+
+### One-step install script (alternative)
+
+The script checks Node, runs `npm install -g peerband`, then runs `peerband login --herdr-plugin install`.
+
 macOS and Linux:
 
 ```sh
@@ -29,25 +41,15 @@ Windows PowerShell:
 irm https://peerband.com/install.ps1 | iex
 ```
 
-Or with npm directly:
-
-```sh
-npm install -g peerband
-```
-
-The installers check Node, install the CLI, run `peerband login` (which opens your browser), and set up the Herdr plugin when Herdr is present.
-
-Headless machine or CI with no browser? Pass a one-time grant from the PeerBand dashboard instead: `curl -fsSL https://peerband.com/install.sh | sh -s -- --grant GRANT --name "my-server"`, or on Windows `$env:PEERBAND_GRANT = 'GRANT'; irm https://peerband.com/install.ps1 | iex`.
+### Headless machines and CI
 
-> PeerBand is not published to npm yet. To try a build, run `npm pack` in this repository and install with `PEERBAND_PACKAGE=/path/to/peerband-0.1.0.tgz` (a tarball path or git URL) set when running the installer.
+No browser available? Pass a one-time grant from the PeerBand dashboard instead: `peerband login --grant GRANT` (or set `PEERBAND_GRANT`). With the scripts: `curl -fsSL https://peerband.com/install.sh | sh -s -- --grant GRANT --name "my-server"`, or on Windows `$env:PEERBAND_GRANT = 'GRANT'; irm https://peerband.com/install.ps1 | iex`.
 
 ## Quickstart
 
-1. Install the CLI (above).
-2. `peerband login` opens your browser. Sign in to PeerBand and confirm the code shown in your terminal.
-3. `peerband herdr install` to add the plugin to Herdr.
-4. `peerband relay` to open the PeerBand Relay tab, then press Space to connect.
-5. Add the MCP server URL that `peerband relay` and `peerband status` print (`https://mcp.peerband.com/mcp`) to your MCP client: a custom connector in ChatGPT or Claude, or `claude mcp add --transport http peerband https://mcp.peerband.com/mcp` in Claude Code. Sign in and approve access when the client asks.
+1. `npm install -g peerband && peerband login`. Confirm the code shown in your terminal when your browser opens, and answer Y to adding the Herdr plugin.
+2. `peerband relay` to open the PeerBand Relay tab, then press Space to connect. (If you skipped the plugin: `peerband herdr install` first.)
+3. Add the MCP server URL that `peerband relay` and `peerband status` print (`https://mcp.peerband.com/mcp`) to your MCP client: a custom connector in ChatGPT or Claude, or `claude mcp add --transport http peerband https://mcp.peerband.com/mcp` in Claude Code. Sign in and approve access when the client asks.
 
 ## Logging in
 
@@ -82,7 +84,7 @@ The plugin adds a persistent tab titled `PeerBand Relay [On]` or `[Off]` that sh
 
 | Command | What it does |
 | --- | --- |
-| `peerband login` | Sign in through your browser. Flags: `--no-browser`, `--name NAME`, `--server URL`; headless/CI: `--grant GRANT` |
+| `peerband login` | Sign in through your browser, then offer to add the Herdr plugin. Flags: `--no-browser`, `--name NAME`, `--server URL`, `--herdr-plugin ask\|install\|skip`; headless/CI: `--grant GRANT` |
 | `peerband logout` | Stop a running relay and delete the local credential. Does not revoke it on the server |
 | `peerband status` | Show login, relay and Herdr state. `--json` for machine-readable output |
 | `peerband connect` | Run the connector in the foreground. Flags: `--runtime herdr\|mock`, `--enable-writes`, `--config PATH`, `--server URL` |

package/dist/peerband.mjs

@@ -14338,6 +14338,84 @@ function openBrowser(url, platform = process.platform) {
   });
 }
 
+// src/cli/prompt.ts
+var PromptAborted = class extends Error {
+  constructor() {
+    super("Prompt cancelled.");
+    this.name = "PromptAborted";
+  }
+};
+function askYesNo(stdin, stderr, prompt, defaultYes = true) {
+  return new Promise((resolve3, reject) => {
+    let value = "";
+    const cleanup = () => {
+      stdin.off("data", onData);
+      stdin.pause();
+    };
+    const onData = (chunk) => {
+      const text2 = typeof chunk === "string" ? chunk : chunk.toString("utf8");
+      if (text2.includes("") || text2.includes("")) {
+        cleanup();
+        return reject(new PromptAborted());
+      }
+      const end = text2.search(/[\r\n]/);
+      value += end === -1 ? text2 : text2.slice(0, end);
+      if (end === -1) return;
+      cleanup();
+      const answer = value.trim().toLowerCase();
+      resolve3(answer === "" ? defaultYes : answer === "y" || answer === "yes");
+    };
+    stderr.write(prompt);
+    stdin.resume();
+    stdin.on("data", onData);
+  });
+}
+
+// src/cli/commands/herdr-setup.ts
+var HERDR_PLUGIN_MODES = ["ask", "install", "skip"];
+async function herdrSetup(ctx, mode) {
+  const s = ctx.out.stdout;
+  const manual = `${s.dim("Next:")} peerband herdr install  ${s.dim("then")}  peerband relay`;
+  const state = await pluginInstalled(ctx);
+  if (!state.found) {
+    ctx.out.print("");
+    ctx.out.print(`${s.yellow(symbols.warn)} Herdr was not found. The PeerBand Relay tab needs Herdr 0.9.3 or newer.`);
+    ctx.out.print("  1. Install Herdr: https://herdr.dev");
+    ctx.out.print(`  2. ${s.bold("peerband herdr install")}  ${s.dim("then")}  ${s.bold("peerband relay")}`);
+    return;
+  }
+  if (state.installed) {
+    ctx.out.print(`${s.dim("Next:")} peerband relay  ${s.dim("(opens the PeerBand Relay tab in Herdr)")}`);
+    return;
+  }
+  let install = mode === "install";
+  if (mode === "ask" && ctx.stdin.isTTY && ctx.stderr.isTTY) {
+    try {
+      install = await askYesNo(ctx.stdin, ctx.stderr, "Add the PeerBand plugin to Herdr now? [Y/n] ");
+    } catch (error) {
+      if (!(error instanceof PromptAborted)) throw error;
+      ctx.out.print(manual);
+      return;
+    }
+    if (!install) {
+      ctx.out.print(s.dim("Skipped. Add it later with `peerband herdr install`, then open the relay with `peerband relay`."));
+      return;
+    }
+  }
+  if (!install) {
+    ctx.out.print(manual);
+    return;
+  }
+  try {
+    await installSpec.run({ values: {}, positionals: [] }, ctx);
+  } catch (error) {
+    const message = error.message;
+    ctx.out.warn(`${s.yellow(symbols.warn)} Could not add the PeerBand plugin to Herdr: ${message}`);
+    if (error instanceof CliError && error.hint) ctx.out.warn(`  ${error.hint}`);
+    ctx.out.print(s.dim("You are logged in. Add the plugin later with `peerband herdr install`, then run `peerband relay`."));
+  }
+}
+
 // src/cli/commands/login.ts
 async function persist(ctx, redeemed) {
   const credentials = { ...redeemed, enrolledAt: (/* @__PURE__ */ new Date()).toISOString() };
@@ -14456,22 +14534,27 @@ function mapFailure(error, serverUrl) {
 var spec3 = {
   name: "login",
   summary: "Connect this machine to your PeerBand account",
-  usage: "peerband login [--name NAME] [--no-browser] [--server URL]\n  peerband login --grant GRANT [--name NAME] [--server URL]",
-  description: "Signs this machine in through your browser. login prints a link and a short code, opens the page (unless you are on SSH, a headless machine or pass --no-browser), and waits while you confirm the code in your PeerBand account. The credential is stored in your PeerBand config directory (readable only by you). Running login again replaces the existing enrollment.\n\nOn a headless machine or in CI, use a one-time grant instead: create it in the PeerBand dashboard and pass --grant GRANT (or set PEERBAND_GRANT).",
+  usage: "peerband login [--name NAME] [--no-browser] [--server URL] [--herdr-plugin ask|install|skip]\n  peerband login --grant GRANT [--name NAME] [--server URL]",
+  description: "Signs this machine in through your browser. login prints a link and a short code, opens the page (unless you are on SSH, a headless machine or pass --no-browser), and waits while you confirm the code in your PeerBand account. The credential is stored in your PeerBand config directory (readable only by you). Running login again replaces the existing enrollment.\n\nOn a headless machine or in CI, use a one-time grant instead: create it in the PeerBand dashboard and pass --grant GRANT (or set PEERBAND_GRANT).\n\nWhen login succeeds it checks for Herdr. If the PeerBand plugin is missing it offers to add it (--herdr-plugin ask, the default; it only asks on a terminal), adds it without asking (install), or just prints the command (skip).",
   options: [
     { name: "no-browser", type: "boolean", description: "Do not open a browser; print the link and code only (SSH, containers)." },
     { name: "name", type: "string", valueName: "NAME", description: "Name shown for this machine in the dashboard. Default: this computer's hostname." },
     { name: "server", type: "string", valueName: "URL", description: "PeerBand server. Default: $PEERBAND_SERVER or https://peerband.com." },
-    { name: "grant", type: "string", valueName: "GRANT", description: "Headless/CI: enroll with a dashboard grant instead of the browser. Default: $PEERBAND_GRANT." }
+    { name: "grant", type: "string", valueName: "GRANT", description: "Headless/CI: enroll with a dashboard grant instead of the browser. Default: $PEERBAND_GRANT." },
+    { name: "herdr-plugin", type: "string", valueName: "ask|install|skip", description: "After login, add the PeerBand plugin to Herdr: ask (default; prompts on a terminal), install, or skip." }
   ],
   examples: [
     ["peerband login", "Open your browser, confirm the code, done"],
+    ["peerband login --herdr-plugin install", "Also add the PeerBand plugin to Herdr without asking (used by the install scripts)"],
     ["peerband login --no-browser", "Print the link and code; open the link on any other device"],
     ["PEERBAND_GRANT=... peerband login --name work-laptop", "Headless/CI with a dashboard grant; keeps it out of the process list"],
     ["peerband login --server http://localhost:8000", "Against a local development server"]
   ],
   notes: ["The code you confirm in the browser must match the one shown here. The secret device code and any grant are never printed or stored. Plain HTTP is only accepted for localhost."],
   async run(parsed, ctx) {
+    const rawMode = str(parsed, "herdr-plugin")?.trim().toLowerCase() ?? "ask";
+    if (!HERDR_PLUGIN_MODES.includes(rawMode)) throw new UsageError(`Invalid --herdr-plugin value "${rawMode}".`, "Use --herdr-plugin ask, install or skip.");
+    const herdrMode = rawMode;
     const serverUrl = resolveServerUrl(str(parsed, "server"), ctx.env);
     const name = str(parsed, "name")?.trim() || hostname();
     const grant = (str(parsed, "grant") ?? ctx.env.PEERBAND_GRANT)?.trim();
@@ -14483,7 +14566,7 @@ var spec3 = {
     if (previous) ctx.out.print(s.dim(`Replaced the previous login (${previous.machineName ?? previous.installationId} on ${previous.serverUrl}).`));
     const who = credentials.accountEmail ? ` (${credentials.accountEmail})` : "";
     ctx.out.print(`${s.green(symbols.ok)} Logged in as ${s.bold(credentials.machineName ?? name)}${who}`);
-    ctx.out.print(`${s.dim("Next:")} peerband herdr install  ${s.dim("then")}  peerband relay`);
+    await herdrSetup(ctx, herdrMode);
     return 0;
   }
 };
@@ -14630,16 +14713,8 @@ function herdrGroupHelp(s) {
 `;
 }
 
-// src/cli/prompt.ts
-var PromptAborted = class extends Error {
-  constructor() {
-    super("Prompt cancelled.");
-    this.name = "PromptAborted";
-  }
-};
-
 // src/cli/cli.ts
-var VERSION = true ? "0.1.0" : "0.0.0-dev";
+var VERSION = true ? "0.1.1" : "0.0.0-dev";
 function createContext(overrides = {}) {
   const env = overrides.env ?? process.env;
   const stdout = overrides.stdout ?? process.stdout;

package/herdr-plugin.toml

@@ -1,6 +1,6 @@
 id = "peerband"
 name = "PeerBand"
-version = "0.1.0"
+version = "0.1.1"
 min_herdr_version = "0.9.3"
 description = "Reach your Herdr agents from any MCP client through your PeerBand account"
 platforms = ["linux", "macos", "windows"]

package/install/install.ps1

@@ -90,7 +90,7 @@ if (-not $pbOnPath) {
 Say '  ok peerband installed' Green
 
 Say '==> Logging in' Cyan
-$loginArgs = @('login')
+$loginArgs = @('login', '--herdr-plugin', 'install')
 if ($pbName) { $loginArgs += @('--name', $pbName) }
 try {
     if ($pbGrant) { $env:PEERBAND_GRANT = $pbGrant }
@@ -102,20 +102,14 @@ try {
 }
 if ($loginCode -ne 0) { Fail "peerband login failed. Run 'peerband login' again, or on a headless machine use 'peerband login --grant GRANT' with a grant from your PeerBand dashboard." }
 
-Say '==> Installing the Herdr plugin' Cyan
+# `peerband login --herdr-plugin install` has already added the plugin to Herdr when Herdr is present.
 $pbHasHerdr = [bool](Get-Command herdr -ErrorAction SilentlyContinue)
-if ($pbHasHerdr) {
-    & $pbExe herdr install
-    if ($LASTEXITCODE -ne 0) { Fail 'peerband herdr install failed. Fix the error above and run it again.' }
-} else {
-    Say '  !! Herdr was not found. PeerBand reaches the agents you run in Herdr.' Yellow
-}
 
 Say ''
 if ($pbHasHerdr) {
     Say 'PeerBand is ready. Next:' Green
     Say '  peerband relay    open the PeerBand Relay tab in Herdr'
-    Say '  peerband status   check your connection'
+    Say '  peerband status   check your connection (and the Herdr plugin)'
 } else {
     Say 'PeerBand is installed and logged in. Next:' Green
     Say '  1. Install Herdr 0.9.3 or newer: https://herdr.dev'

package/install/install.sh

@@ -79,14 +79,14 @@ ok "peerband installed"
 step "Logging in"
 if [ -n "$grant" ]; then
   if [ -n "$name" ]; then
-    PEERBAND_GRANT=$grant "$pb" login --name "$name" || die "peerband login failed. Get a fresh grant from your PeerBand dashboard."
+    PEERBAND_GRANT=$grant "$pb" login --herdr-plugin install --name "$name" || die "peerband login failed. Get a fresh grant from your PeerBand dashboard."
   else
-    PEERBAND_GRANT=$grant "$pb" login || die "peerband login failed. Get a fresh grant from your PeerBand dashboard."
+    PEERBAND_GRANT=$grant "$pb" login --herdr-plugin install || die "peerband login failed. Get a fresh grant from your PeerBand dashboard."
   fi
 else
   # Browser sign-in. Under `curl | sh` stdin is the script itself; use the terminal instead.
-  set --
-  [ -z "$name" ] || set -- --name "$name"
+  set -- --herdr-plugin install
+  [ -z "$name" ] || set -- "$@" --name "$name"
   if (exec </dev/tty) 2>/dev/null; then
     "$pb" login "$@" </dev/tty
   else
@@ -95,10 +95,9 @@ else
 fi
 grant=''
 
-step "Installing the Herdr plugin"
+# `peerband login --herdr-plugin install` has already added the plugin to Herdr when Herdr is present.
 if command -v herdr >/dev/null 2>&1; then
-  "$pb" herdr install || die "peerband herdr install failed. Fix the error above and run it again."
-  printf '\n%sPeerBand is ready.%s Next:\n  peerband relay    open the PeerBand Relay tab in Herdr\n  peerband status   check your connection\n' "$G" "$N"
+  printf '\n%sPeerBand is ready.%s Next:\n  peerband relay    open the PeerBand Relay tab in Herdr\n  peerband status   check your connection (and the Herdr plugin)\n' "$G" "$N"
 else
   warn "Herdr was not found. PeerBand reaches the agents you run in Herdr."
   printf '\n%sPeerBand is installed and logged in.%s Next:\n  1. Install Herdr 0.9.3 or newer: https://herdr.dev\n  2. peerband herdr install   then   peerband relay\n  peerband status   check your connection\n' "$G" "$N"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peerband",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "PeerBand CLI and Herdr plugin: reach your local coding agents from any MCP client through your PeerBand account",
   "license": "Apache-2.0",
   "type": "module",