@the-librarian/cli 1.0.0-rc.3

package/README.md

@@ -0,0 +1,94 @@
+# `@the-librarian/cli` — the `librarian` installer
+
+A small cross-harness CLI that installs, updates, and tracks
+[The Librarian](https://github.com/JimJafar/the-librarian)'s integrations across
+all your harnesses and machines. Think of it as the package manager for your
+Librarian setup: one tool you keep, driving each harness's **native** install
+path rather than hand-editing five config formats.
+
+Harnesses it manages: **Claude Code, Codex, OpenCode, Hermes, Pi.**
+
+## Install
+
+Install the CLI globally, then run the interactive setup:
+
+```sh
+npm i -g @the-librarian/cli
+librarian install
+```
+
+That's it — any harness you'd install into already has Node, so there's no
+bootstrap script. `librarian install` with no args opens the interactive
+multi-select and prompts once for your MCP URL + token; pass harness ids to
+target specific ones. Re-run it any time to add a harness.
+
+## Commands
+
+```
+librarian install   [harness…]   Install into one or more harnesses
+                                  (no args → interactive multi-select; prompts
+                                  for MCP URL + token once)
+librarian uninstall [harness…]   Remove The Librarian from each harness
+librarian update    [harness…]   Update the integration to the current version
+librarian status                 Live table: harness · installed · version
+librarian doctor                 Token set? server reachable? which harness CLIs?
+librarian config                 Show or set MCP URL, token, server URL
+librarian self-update            Update the CLI itself (coming in a later release)
+librarian report                 Push this machine's state to the server
+                                  (coming in a later release)
+```
+
+Useful flags: `--mcp-url <url>`, `--token <token>` (never printed),
+`--shell <bash|zsh|fish>` to override shell detection, `-h/--help`,
+`-v/--version`. Harness ids: `claude`, `codex`, `opencode`, `hermes`, `pi`. A
+harness whose CLI isn't installed is reported `not-detected` and skipped — not
+an error.
+
+## What it writes to your environment
+
+The CLI keeps everything under `~/.librarian/`:
+
+- **`~/.librarian/env`** — a POSIX env file (`chmod 600`, owner-only) holding
+  your two secrets:
+
+  ```sh
+  export LIBRARIAN_MCP_URL="…"
+  export LIBRARIAN_AGENT_TOKEN="…"
+  ```
+
+- **`~/.librarian/machine-id`** — a UUID generated on first run, so the same
+  setup on different machines stays distinct in the dashboard.
+
+It adds **one** idempotent managed block to your shell rc (`~/.bashrc` /
+`~/.zshrc`) that sources the env file:
+
+```sh
+# >>> librarian >>>
+[ -f "$HOME/.librarian/env" ] && . "$HOME/.librarian/env"
+# <<< librarian <<<
+```
+
+Fish can't source a POSIX file, so it instead gets a native
+`~/.config/fish/conf.d/librarian.fish` with `set -gx`. Re-running any command
+replaces the block — it never duplicates. `librarian config` rewrites
+`~/.librarian/env`.
+
+## Security
+
+Your agent token is a credential. The CLI treats it like one:
+
+- It's written **only** to `~/.librarian/env`, which is `chmod 600`
+  (owner read/write only) — never to a committed or world-readable file.
+- It is **never printed** (not in `status`, `doctor`, `config`, or logs) and
+  never put in a URL — bearer tokens travel in headers, to the configured
+  server, over the configured URL, and nowhere else.
+
+If you ever need to rotate it, re-run `librarian config --token <new>` (or edit
+`~/.librarian/env` directly).
+
+> **Avoid `--token <value>` on a shared or audited machine.** A value passed on
+> the command line is visible to anyone who can run `ps` while the command runs,
+> and it lands in your shell history. Prefer entering the token at the
+> interactive prompt — `librarian install` reads it with the echo **muted**, so
+> it never appears on screen, in `ps`, or in history — or edit the `chmod 600`
+> `~/.librarian/env` file directly.

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+// `librarian` CLI bin entrypoint.
+//
+// Runs the typed runtime over the caller's argv, prints the captured
+// stdout/stderr, and translates the structured result into a process exit
+// code. The runtime is pure over `{ home }`, so tests drive it directly
+// without spawning this process.
+import { runCli } from "./runtime.js";
+const result = await runCli(process.argv.slice(2));
+if (result.stdout)
+    console.log(result.stdout);
+if (result.stderr)
+    console.error(result.stderr);
+process.exitCode = result.exitCode || 0;
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,kCAAkC;AAClC,EAAE;AACF,qEAAqE;AACrE,0EAA0E;AAC1E,wEAAwE;AACxE,iCAAiC;AAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,IAAI,MAAM,CAAC,MAAM;IAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC9C,IAAI,MAAM,CAAC,MAAM;IAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAChD,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC"}

package/dist/commands/install.d.ts

@@ -0,0 +1,22 @@
+import type { Shell } from "../env.js";
+import type { Prompter } from "../prompt.js";
+export interface InstallDeps {
+    home?: string | undefined;
+    shell?: Shell | undefined;
+    prompter: Prompter;
+}
+export interface InstallOutcome {
+    installed: string[];
+    skipped: {
+        id: string;
+        reason: string;
+    }[];
+    failed: {
+        id: string;
+        reason: string;
+    }[];
+    output: string;
+}
+/** Run the install orchestration over the (possibly empty) named harnesses. */
+export declare function runInstall(named: string[], deps: InstallDeps): Promise<InstallOutcome>;
+//# sourceMappingURL=install.d.ts.map

package/dist/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAIvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG7C,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,+EAA+E;AAC/E,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CA2D5F"}

package/dist/commands/install.js

@@ -0,0 +1,152 @@
+// `librarian install [harness…]` orchestration.
+//
+// Flow:
+//   1. Resolve config. If the MCP URL or token is unset, prompt for them
+//      (token is a SECRET prompt — never echoed) and persist via `setConfig`,
+//      which also (re)applies the managed shell block for the user's shell.
+//   2. Choose harnesses: explicit args win; otherwise an interactive
+//      multi-select over the harnesses whose native CLI is on PATH (file-based
+//      harnesses always offered). Non-interactive falls back to all available.
+//   3. For each chosen harness, run its native `install(cfg)`:
+//        - a "CLI not found" error → SKIP with a note (not a failure);
+//        - any OTHER error → attempt `uninstall()` to avoid a half-applied
+//          state (spec §9), record it failed, and continue.
+//   4. Print a summary (installed / skipped / failed) + a restart hint.
+import { deriveServerUrl, readConfig, setConfig } from "../config.js";
+import { which } from "../exec.js";
+import { HARNESS_CLI } from "../harnesses/cli.js";
+import { allHarnesses, isHarnessId } from "../harnesses/index.js";
+import { messageOf, toHarnessConfig } from "./shared.js";
+/** Run the install orchestration over the (possibly empty) named harnesses. */
+export async function runInstall(named, deps) {
+    const lines = [];
+    // 1) Resolve config in-memory, prompting for any missing secret/URL. We do
+    //    NOT persist `~/.librarian/env` or rewrite the shell rc block yet — that
+    //    is deferred until at least one harness install succeeds (S1), so a total
+    //    failure leaves no global side effect. The harness installs consume the
+    //    in-memory cfg, never the env file, so deferring is safe.
+    const { cfg, changed } = await resolveConfig(deps);
+    // 2) Choose harnesses.
+    const chosen = await chooseHarnesses(named, deps, lines);
+    if (chosen.length === 0) {
+        lines.push("No harnesses selected — nothing to do.");
+        return { installed: [], skipped: [], failed: [], output: lines.join("\n") };
+    }
+    // 3) Install each, with per-harness skip / rollback.
+    const harnessCfg = toHarnessConfig(cfg);
+    const installed = [];
+    const skipped = [];
+    const failed = [];
+    for (const harness of chosen) {
+        try {
+            await harness.install(harnessCfg);
+            installed.push(harness.id);
+        }
+        catch (error) {
+            const reason = messageOf(error);
+            if (isCliNotFound(reason)) {
+                skipped.push({ id: harness.id, reason });
+                continue;
+            }
+            // Mid-install failure → roll back so we don't leave a half-applied
+            // state (spec §9). Best-effort: a failed rollback is noted, not fatal.
+            let rollbackNote = "";
+            try {
+                await harness.uninstall();
+                rollbackNote = " (rolled back)";
+            }
+            catch (rollbackError) {
+                rollbackNote = ` (rollback also failed: ${messageOf(rollbackError)})`;
+            }
+            failed.push({ id: harness.id, reason: `${reason}${rollbackNote}` });
+        }
+    }
+    // 4) Now that at least one harness may have succeeded, persist the config
+    //    (writes `~/.librarian/env` + the managed shell block). Deferred from
+    //    step 1 so a run where EVERY harness failed leaves no global side effect
+    //    (S1). Only persist when the values actually changed — keeps re-runs
+    //    idempotent and quiet.
+    if (installed.length > 0 && changed) {
+        setConfig({ mcpUrl: cfg.mcpUrl, token: cfg.token }, { home: deps.home, shell: deps.shell });
+        lines.unshift("Saved config to ~/.librarian/env and updated the shell block.", "");
+    }
+    // 5) Summary + restart hint.
+    renderSummary(lines, { installed, skipped, failed });
+    return { installed, skipped, failed, output: lines.join("\n") };
+}
+/**
+ * Resolve the config to install with, prompting for whatever is missing.
+ * Returns the in-memory config and whether it differs from what's persisted
+ * (so the caller can defer the actual `setConfig` write until a harness
+ * install has succeeded — S1). Does NOT touch the filesystem.
+ */
+async function resolveConfig(deps) {
+    const existing = readConfig(deps.home);
+    let mcpUrl = existing?.mcpUrl ?? "";
+    let token = existing?.token ?? "";
+    if (!mcpUrl) {
+        mcpUrl = await deps.prompter.promptText("MCP URL");
+    }
+    if (!token) {
+        token = await deps.prompter.promptText("Agent token", { secret: true });
+    }
+    const changed = mcpUrl !== existing?.mcpUrl || token !== existing?.token;
+    const cfg = { mcpUrl, token, serverUrl: deriveServerUrl(mcpUrl) };
+    return { cfg, changed };
+}
+/**
+ * Resolve the harness set to install into:
+ *   - explicit args (validated) win;
+ *   - otherwise interactive multi-select over harnesses whose CLI is present
+ *     (file-based harnesses always offered).
+ */
+async function chooseHarnesses(named, deps, lines) {
+    if (named.length > 0) {
+        const valid = [];
+        for (const id of named) {
+            if (isHarnessId(id)) {
+                valid.push(allHarnesses.find((h) => h.id === id));
+            }
+            else {
+                lines.push(`Skipping unknown harness: ${id}`);
+            }
+        }
+        return valid;
+    }
+    // Default set: harnesses whose CLI is on PATH, plus file-based ones.
+    const available = [];
+    for (const harness of allHarnesses) {
+        const cli = HARNESS_CLI[harness.id];
+        if (cli === null || (await which(cli)))
+            available.push(harness);
+    }
+    if (available.length === 0) {
+        lines.push("No harness CLIs detected on PATH.");
+        return [];
+    }
+    const selectedIds = await deps.prompter.selectHarnesses(available.map((h) => ({ id: h.id, label: h.displayName })));
+    return available.filter((h) => selectedIds.includes(h.id));
+}
+function renderSummary(lines, outcome) {
+    lines.push("", "Install summary:");
+    if (outcome.installed.length > 0) {
+        lines.push(`  Installed: ${outcome.installed.join(", ")}`);
+    }
+    for (const s of outcome.skipped) {
+        lines.push(`  Skipped ${s.id}: ${s.reason}`);
+    }
+    for (const f of outcome.failed) {
+        lines.push(`  Failed ${f.id}: ${f.reason}`);
+    }
+    if (outcome.installed.length === 0 &&
+        outcome.failed.length === 0 &&
+        outcome.skipped.length === 0) {
+        lines.push("  (nothing installed)");
+    }
+    lines.push("", "Restart your shell or run `source ~/.librarian/env` to load the new environment.");
+}
+/** True iff the error message is a harness "CLI not found on PATH" signal. */
+function isCliNotFound(message) {
+    return /not found on path/i.test(message) || /cli not found/i.test(message);
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"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"}

package/dist/commands/shared.d.ts

@@ -0,0 +1,16 @@
+import type { LibrarianConfig } from "../config.js";
+import { type HarnessModule } from "../harnesses/index.js";
+import type { HarnessConfig } from "../harnesses/types.js";
+/** Adapt the persisted config into the shape harness modules consume. */
+export declare function toHarnessConfig(cfg: LibrarianConfig): HarnessConfig;
+/**
+ * Resolve named harness ids to modules, collecting any unknown ids. An empty
+ * `named` list returns every harness (the "all" default for uninstall/update).
+ */
+export declare function resolveNamed(named: string[]): {
+    harnesses: HarnessModule[];
+    unknown: string[];
+};
+/** Pull a clean message string off an unknown thrown value. */
+export declare function messageOf(error: unknown): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/commands/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,aAAa,CAEnE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG;IAC7C,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAYA;AAED,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD"}

package/dist/commands/shared.js

@@ -0,0 +1,30 @@
+// Shared helpers for the harness-touching commands.
+import { allHarnesses, isHarnessId } from "../harnesses/index.js";
+/** Adapt the persisted config into the shape harness modules consume. */
+export function toHarnessConfig(cfg) {
+    return { mcpUrl: cfg.mcpUrl, token: cfg.token, serverUrl: cfg.serverUrl };
+}
+/**
+ * Resolve named harness ids to modules, collecting any unknown ids. An empty
+ * `named` list returns every harness (the "all" default for uninstall/update).
+ */
+export function resolveNamed(named) {
+    if (named.length === 0)
+        return { harnesses: [...allHarnesses], unknown: [] };
+    const harnesses = [];
+    const unknown = [];
+    for (const id of named) {
+        if (isHarnessId(id)) {
+            harnesses.push(allHarnesses.find((h) => h.id === id));
+        }
+        else {
+            unknown.push(id);
+        }
+    }
+    return { harnesses, unknown };
+}
+/** Pull a clean message string off an unknown thrown value. */
+export function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=shared.js.map

package/dist/commands/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAGpD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAsB,MAAM,uBAAuB,CAAC;AAGtF,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,GAAoB;IAClD,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;AAC5E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAe;IAI1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC7E,MAAM,SAAS,GAAoB,EAAE,CAAC;IACtC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;YACpB,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAkB,CAAC,CAAC;QACzE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/commands/uninstall.d.ts

@@ -0,0 +1,18 @@
+import { type Shell } from "../env.js";
+import type { Prompter } from "../prompt.js";
+export interface UninstallDeps {
+    home?: string | undefined;
+    shell?: Shell | undefined;
+    prompter: Prompter;
+}
+export interface UninstallOutcome {
+    removed: string[];
+    failed: {
+        id: string;
+        reason: string;
+    }[];
+    envRemoved: boolean;
+    output: string;
+}
+export declare function runUninstall(named: string[], deps: UninstallDeps): Promise<UninstallOutcome>;
+//# sourceMappingURL=uninstall.d.ts.map

package/dist/commands/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../src/commands/uninstall.ts"],"names":[],"mappings":"AASA,OAAO,EAAiC,KAAK,KAAK,EAAE,MAAM,WAAW,CAAC;AAGtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG7C,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,gBAAgB,CAAC,CA6C3B"}

package/dist/commands/uninstall.js

@@ -0,0 +1,67 @@
+// `librarian uninstall [harness…]` orchestration.
+//
+// Each harness's `uninstall()` is no-op safe, so we just call them. After
+// removing the named (or all) harnesses, if NO harness remains installed we
+// OFFER to remove the managed shell block + `~/.librarian/env` — prompting,
+// defaulting to NO (we never tear down the user's env without consent).
+import fs from "node:fs";
+import { readConfig } from "../config.js";
+import { detectShell, removeShellBlock } from "../env.js";
+import { allHarnesses } from "../harnesses/index.js";
+import { envFilePath } from "../paths.js";
+import { messageOf, resolveNamed } from "./shared.js";
+export async function runUninstall(named, deps) {
+    const lines = [];
+    const { harnesses, unknown } = resolveNamed(named);
+    for (const id of unknown)
+        lines.push(`Skipping unknown harness: ${id}`);
+    const removed = [];
+    const failed = [];
+    for (const harness of harnesses) {
+        try {
+            await harness.uninstall();
+            removed.push(harness.id);
+        }
+        catch (error) {
+            failed.push({ id: harness.id, reason: messageOf(error) });
+        }
+    }
+    lines.push("Uninstall summary:");
+    if (removed.length > 0)
+        lines.push(`  Removed: ${removed.join(", ")}`);
+    for (const f of failed)
+        lines.push(`  Failed ${f.id}: ${f.reason}`);
+    if (removed.length === 0 && failed.length === 0)
+        lines.push("  (nothing to remove)");
+    // If nothing remains installed across ALL harnesses, offer to tear down env.
+    let envRemoved = false;
+    const stillInstalled = await anyInstalled();
+    if (!stillInstalled && readConfig(deps.home)) {
+        const answer = await deps.prompter.promptText("No harnesses remain installed. Remove the shell block + ~/.librarian/env?", { default: "no" });
+        if (isYes(answer)) {
+            const shell = deps.shell ?? detectShell();
+            removeShellBlock(shell, deps.home);
+            try {
+                fs.rmSync(envFilePath(deps.home));
+            }
+            catch {
+                // already gone
+            }
+            envRemoved = true;
+            lines.push("", "Removed the managed shell block and ~/.librarian/env.");
+        }
+        else {
+            lines.push("", "Left the shell block and ~/.librarian/env in place.");
+        }
+    }
+    return { removed, failed, envRemoved, output: lines.join("\n") };
+}
+/** True iff any harness still reports itself installed. */
+async function anyInstalled() {
+    const detections = await Promise.all(allHarnesses.map((h) => h.detect()));
+    return detections.some((d) => d.installed);
+}
+function isYes(answer) {
+    return /^y(es)?$/i.test(answer.trim());
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/commands/uninstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../src/commands/uninstall.ts"],"names":[],"mappings":"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"}

package/dist/commands/update.d.ts

@@ -0,0 +1,21 @@
+export interface UpdateDeps {
+    home?: string | undefined;
+}
+export interface UpdateOutcome {
+    updated: {
+        id: string;
+        from?: string | undefined;
+        to?: string | undefined;
+    }[];
+    skipped: {
+        id: string;
+        reason: string;
+    }[];
+    failed: {
+        id: string;
+        reason: string;
+    }[];
+    output: string;
+}
+export declare function runUpdate(named: string[], deps: UpdateDeps): Promise<UpdateOutcome>;
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,EAAE,CAAC;IAC9E,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAiEzF"}

package/dist/commands/update.js

@@ -0,0 +1,75 @@
+// `librarian update [harness…]` orchestration.
+//
+// For each target harness — the named ones, or every CURRENTLY-INSTALLED
+// harness when none are named — run its native `update(cfg)` and report the
+// version transition (old → new) where both are detectable. Update needs
+// config (it re-applies the integration), so it errors clearly if config is
+// unset. A "CLI not found" error is a SKIP, not a failure, mirroring install.
+import { readConfig } from "../config.js";
+import { allHarnesses } from "../harnesses/index.js";
+import { messageOf, resolveNamed, toHarnessConfig } from "./shared.js";
+export async function runUpdate(named, deps) {
+    const lines = [];
+    const cfg = readConfig(deps.home);
+    if (!cfg || !cfg.mcpUrl || !cfg.token) {
+        lines.push("No config set. Run `librarian config --mcp-url <url> --token <token>` first.");
+        return { updated: [], skipped: [], failed: [], output: lines.join("\n") };
+    }
+    const harnessCfg = toHarnessConfig(cfg);
+    // Targets: named (validated), else every currently-installed harness.
+    const { harnesses: namedHarnesses, unknown } = resolveNamed(named);
+    for (const id of unknown)
+        lines.push(`Skipping unknown harness: ${id}`);
+    let targets;
+    if (named.length > 0) {
+        targets = namedHarnesses;
+    }
+    else {
+        const detections = await Promise.all(allHarnesses.map((h) => h.detect()));
+        targets = allHarnesses.filter((_, i) => detections[i]?.installed);
+        if (targets.length === 0) {
+            lines.push("No harnesses are currently installed — nothing to update.");
+            return { updated: [], skipped: [], failed: [], output: lines.join("\n") };
+        }
+    }
+    const updated = [];
+    const skipped = [];
+    const failed = [];
+    for (const harness of targets) {
+        const before = (await harness.detect()).version;
+        try {
+            await harness.update(harnessCfg);
+        }
+        catch (error) {
+            const reason = messageOf(error);
+            if (/not found on path/i.test(reason) || /cli not found/i.test(reason)) {
+                skipped.push({ id: harness.id, reason });
+                continue;
+            }
+            failed.push({ id: harness.id, reason });
+            continue;
+        }
+        const after = (await harness.detect()).version;
+        updated.push({ id: harness.id, from: before, to: after });
+    }
+    lines.push("Update summary:");
+    for (const u of updated) {
+        const transition = u.from && u.to
+            ? u.from === u.to
+                ? `already at ${u.to}`
+                : `${u.from} → ${u.to}`
+            : u.to
+                ? `now ${u.to}`
+                : "updated";
+        lines.push(`  ${u.id}: ${transition}`);
+    }
+    for (const s of skipped)
+        lines.push(`  Skipped ${s.id}: ${s.reason}`);
+    for (const f of failed)
+        lines.push(`  Failed ${f.id}: ${f.reason}`);
+    if (updated.length === 0 && skipped.length === 0 && failed.length === 0) {
+        lines.push("  (nothing updated)");
+    }
+    return { updated, skipped, failed, output: lines.join("\n") };
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,40 @@
+import { type Shell } from "./env.js";
+export interface LibrarianConfig {
+    /** The MCP endpoint URL the harnesses talk to. */
+    mcpUrl: string;
+    /** The bearer token. NEVER printed; redacted on display. */
+    token: string;
+    /** The server base URL; defaults to the MCP URL's origin. */
+    serverUrl: string;
+}
+/** A display-safe view of the config — token is redacted to a boolean. */
+export interface RedactedConfig {
+    mcpUrl: string;
+    /** True iff a non-empty token is set. The value itself is never exposed. */
+    tokenSet: boolean;
+    serverUrl: string;
+}
+/** Derive the server base URL (origin) from the MCP URL; "" if unparseable. */
+export declare function deriveServerUrl(mcpUrl: string): string;
+/** Load the current config from `~/.librarian/env`, or null if unset. */
+export declare function readConfig(home?: string): LibrarianConfig | null;
+/** A display-safe view: the token is reduced to a boolean, never printed. */
+export declare function redact(config: LibrarianConfig): RedactedConfig;
+/** Render the redacted config as human-readable lines (no token value). */
+export declare function formatConfig(config: RedactedConfig): string;
+export interface SetConfigInput {
+    mcpUrl?: string | undefined;
+    token?: string | undefined;
+}
+/**
+ * Update config values and persist them to `~/.librarian/env`.
+ *
+ * Merges over whatever is already stored (so setting just the token
+ * keeps the URL). Re-applies the managed shell block so a fresh `config`
+ * on a new shell still wires up sourcing. Returns the new config.
+ */
+export declare function setConfig(input: SetConfigInput, options?: {
+    home?: string | undefined;
+    shell?: Shell | undefined;
+}): LibrarianConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,OAAO,EAA0C,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAG9E,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAQhE;AAED,6EAA6E;AAC7E,wBAAgB,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,CAM9D;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAM3D;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;CAAO,GACrE,eAAe,CAQjB"}