@kaynooo/cli-doctor 0.7.0 → 0.9.0

package/dist/cli-bin.js

@@ -2,16 +2,37 @@
 // @bun
 
 // src/cli-bin.ts
-import process13 from "process";
+import process18 from "process";
 // ../kit/src/args.ts
-import process5 from "process";
+import process7 from "process";
 import { parseArgs } from "util";
 
 // ../kit/src/format.ts
-import process3 from "process";
+import process5 from "process";
 
-// ../kit/src/style.ts
+// ../kit/src/mode.ts
 import process2 from "process";
+var MODES = new Set(["terminal", "ci", "agent", "pipe"]);
+var AGENT_VARIABLES = ["CLAUDECODE", "AI_AGENT"];
+function isSet(value) {
+  return value !== undefined && value !== "" && value !== "0" && value.toLowerCase() !== "false";
+}
+function outputMode(stream = process2.stdout, env = process2.env) {
+  const chosen = env.KIT_MODE;
+  if (chosen !== undefined && MODES.has(chosen))
+    return chosen;
+  if (AGENT_VARIABLES.some((name) => isSet(env[name])))
+    return "agent";
+  if (stream.isTTY === true)
+    return "terminal";
+  return isSet(env.CI) ? "ci" : "pipe";
+}
+function isInteractive(streams = process2) {
+  return streams.stdin?.isTTY === true && streams.stderr?.isTTY === true;
+}
+
+// ../kit/src/style.ts
+import process4 from "process";
 
 // ../../node_modules/.bun/@kaynooo+utils@2.31.2+d0769e28dc4dad16/node_modules/@kaynooo/utils/dist/chunk-mtetydvc.js
 function x(s) {
@@ -274,21 +295,38 @@ function le(i = {}) {
 }
 var t = le();
 
+// ../kit/src/user-config.ts
+import { homedir } from "os";
+import { join } from "path";
+import process3 from "process";
+function configBase(where = {}) {
+  const xdg = where.xdg ?? (where.home === undefined ? process3.env.XDG_CONFIG_HOME : undefined);
+  return xdg !== undefined && xdg !== "" ? xdg : join(where.home ?? homedir(), ".config");
+}
+function userConfigPath(bin, where = {}) {
+  return join(configBase(where), "kaynooo-cli", `${bin}.json`);
+}
+
+// ../kit/src/theme.ts
+var STYLES = new Set(["bold", "dim", "italic", "underline", "inverse", "strikethrough", "black", "red", "green", "yellow", "blue", "magenta", "cyan", "white", "gray", "grey", "blackBright", "redBright", "greenBright", "yellowBright", "blueBright", "magentaBright", "cyanBright", "whiteBright"]);
+var MAX_FILE_BYTES = 64 * 1024;
+var warned = new Set;
+
 // ../kit/src/style.ts
-function takesControlCodes(stream, env = process2.env) {
-  return stream.isTTY === true && env.NO_COLOR === undefined && env.NODE_DISABLE_COLORS === undefined && env.TERM !== "dumb";
+function takesControlCodes(stream, env = process4.env) {
+  return stream.isTTY === true && env.NO_COLOR === undefined && env.NODE_DISABLE_COLORS === undefined && env.TERM !== "dumb" && outputMode(stream, env) === "terminal";
 }
-function paint(stream, env = process2.env) {
+function paint(stream, env = process4.env) {
   return le({ stream: { isTTY: takesControlCodes(stream, env) }, env });
 }
-var STATUSES = {
-  passed: { symbol: "\u2713", words: ["passed", "success", "succeeded", "ok"], paint: (colors) => colors.green },
-  failed: { symbol: "\u2717", words: ["failed", "failure", "error", "errored"], paint: (colors) => colors.red },
-  running: { symbol: "\u25CF", words: ["running", "in_progress", "started"], paint: (colors) => colors.cyan },
-  queued: { symbol: "\u25CB", words: ["queued", "waiting", "pending", "created", "blocked", "scheduled"], paint: (colors) => colors.yellow },
-  skipped: { symbol: "-", words: ["skipped", "cancelled", "canceled", "manual"], paint: (colors) => colors.dim }
+var STATUS_WORDS = {
+  passed: ["passed", "success", "succeeded", "ok"],
+  failed: ["failed", "failure", "error", "errored"],
+  running: ["running", "in_progress", "started", "holding"],
+  queued: ["queued", "waiting", "pending", "created", "blocked", "scheduled"],
+  skipped: ["skipped", "cancelled", "canceled", "manual"]
 };
-var STATUS_OF = new Map(Object.entries(STATUSES).flatMap(([status, { words }]) => words.map((word) => [word, status])));
+var STATUS_OF = new Map(Object.entries(STATUS_WORDS).flatMap(([status, words]) => words.map((word) => [word, status])));
 
 // ../kit/src/format.ts
 function upTo(text, separator) {
@@ -303,15 +341,18 @@ var ESCAPE = String.fromCharCode(27);
 function textWidth(text) {
   return Bun.stringWidth(text);
 }
-function table(rows, { cellWidth, header = false, align = [], fit } = {}) {
+function table(rows, { cellWidth, header = false, align = [], fit, stream = process5.stdout, env = process5.env } = {}) {
   const cells = cellWidth === undefined ? rows : rows.map((row) => row.map((cell) => truncate(cell.replaceAll(LINE_BREAKS, " "), cellWidth)));
+  if (outputMode(stream, env) === "agent")
+    return cells.map((row) => row.map((cell) => Bun.stripANSI(cell).replaceAll(/[\t\r\n]+/g, " ")).join("\t")).join(`
+`);
   const widths = [];
   for (const row of cells) {
     for (const [index, cell] of row.entries())
       widths[index] = Math.max(widths[index] ?? 0, textWidth(cell));
   }
   const shown = fit === undefined ? cells : narrow(cells, widths, fit);
-  const colors = paint(process3.stdout);
+  const colors = paint(stream);
   const lines = shown.map((row) => row.map((cell, index) => {
     const width = widths[index] ?? 0;
     const gap = " ".repeat(Math.max(0, width - textWidth(cell)));
@@ -319,7 +360,8 @@ function table(rows, { cellWidth, header = false, align = [], fit } = {}) {
       return `${gap}${cell}`;
     return index === row.length - 1 ? cell : `${cell}${gap}`;
   }).join("  ").trimEnd());
-  return lines.map((line, index) => header && index === 0 ? colors.bold(line) : line).join(`
+  const rule = header && takesControlCodes(stream) && lines.length > 1 ? [colors.dim("\u2500".repeat(Math.max(...lines.map(textWidth))))] : [];
+  return lines.flatMap((line, index) => header && index === 0 ? [colors.bold(line), ...rule] : [line]).join(`
 `);
 }
 function narrow(rows, widths, limit) {
@@ -338,32 +380,35 @@ function narrow(rows, widths, limit) {
   }
   return rows.map((row) => row.map((cell, index) => textWidth(cell) > (widths[index] ?? 0) ? truncate(cell, widths[index] ?? 0) : cell));
 }
+function jsonText(value, replacer, { stream = process5.stdout, env = process5.env } = {}) {
+  return JSON.stringify(value, replacer, outputMode(stream, env) === "agent" ? undefined : 2);
+}
 function printJson(value) {
-  console.log(JSON.stringify(value, undefined, 2));
+  console.log(jsonText(value));
 }
 
 // ../kit/src/help.ts
-import process4 from "process";
+import process6 from "process";
 var OPTIONAL = /\[[^\]]+\]/g;
 var USAGE_PREFIX = /^usage:\s*/i;
 var FULL_STOP = /\.$/;
-function usageLine(usage, colors = paint(process4.stdout)) {
+function usageLine(usage, colors = paint(process6.stdout)) {
   return `${colors.bold("Usage:")} ${usage.replace(USAGE_PREFIX, "").replaceAll(OPTIONAL, (part) => colors.dim(part))}`;
 }
-function helpText(usage, options, colors = paint(process4.stdout), { examples = [], replaces, exits = [] } = {}) {
+function helpText(usage, options, colors = paint(process6.stdout), { examples = [], replaces, exits = [] } = {}) {
   return [usageLine(usage, colors), ...replacesRows(replaces, colors), "", colors.bold("Options:"), ...optionRows(options, colors), ...exitRows(exits, colors), ...exampleRows(examples, colors)].join(`
 `);
 }
-function exitRows(exits, colors = paint(process4.stdout)) {
+function exitRows(exits, colors = paint(process6.stdout)) {
   if (exits.length === 0)
     return [];
   const width = Math.max(...exits.map(([code]) => String(code).length));
   return ["", colors.bold("Exits:"), ...exits.map(([code, meaning]) => `  ${colors.cyan(String(code).padEnd(width))}  ${meaning}`)];
 }
-function replacesRows(replaces, colors = paint(process4.stdout)) {
-  return replaces === undefined ? [] : ["", `${colors.bold("Instead of:")} ${replaces}`];
+function replacesRows(replaces, colors = paint(process6.stdout)) {
+  return replaces === undefined || outputMode() === "agent" ? [] : ["", `${colors.bold("Instead of:")} ${replaces}`];
 }
-function wantsHelpJson(env = process4.env) {
+function wantsHelpJson(env = process6.env) {
   return env.KIT_HELP === "json";
 }
 function description(usage, { examples = [], replaces, exits } = {}, options) {
@@ -382,12 +427,12 @@ function description(usage, { examples = [], replaces, exits } = {}, options) {
     ...options === undefined ? {} : { options: Object.entries(options).map(([name, { short, description }]) => ({ name, ...short === undefined ? {} : { short }, ...description === undefined ? {} : { description } })) }
   };
 }
-function exampleRows(examples, colors = paint(process4.stdout)) {
-  if (examples.length === 0)
+function exampleRows(examples, colors = paint(process6.stdout)) {
+  if (examples.length === 0 || outputMode() === "agent")
     return [];
   return ["", colors.bold("Examples:"), ...examples.map((example) => typeof example === "string" ? `  ${example}` : `  ${example[0]}  ${colors.dim(`# ${example[1]}`)}`)];
 }
-function optionRows(options, colors = paint(process4.stdout)) {
+function optionRows(options, colors = paint(process6.stdout)) {
   const rows = Object.entries(options).map(([name, option]) => {
     const short = option.short === undefined ? "    " : `${colors.cyan(`-${option.short}`)}, `;
     const named = option.choices === undefined ? "<value>" : `<${option.choices.join("|")}>`;
@@ -446,6 +491,10 @@ class Exit extends Error {
     this.hint = hint;
   }
 }
+function fail(message, code = 2, hint) {
+  throw new Exit(message, code, hint);
+}
+
 class UsageError extends Exit {
   constructor(message, hint) {
     super(message, 2, hint);
@@ -476,7 +525,7 @@ var OUTPUT_OPTIONS = {
   color: { type: "string", description: "auto (on a terminal alone), always or never" },
   plain: { type: "boolean", description: "plain text, no colour or spinner: --color never" }
 };
-function applyOutput(color, plain, env = process5.env) {
+function applyOutput(color, plain, env = process7.env) {
   const when = plain === true ? "never" : color ?? "auto";
   if (when === "auto")
     return;
@@ -647,7 +696,7 @@ function nearestOption(message, options, allowNegative) {
 }
 // ../kit/src/process.ts
 import { constants } from "os";
-import process6 from "process";
+import process8 from "process";
 var KILL_GRACE_MS = 2000;
 function exitCodeOf(code, signal) {
   if (code !== null)
@@ -667,7 +716,7 @@ async function runCommand(argv, { cwd, env, stdin = "ignore", timeoutMs, signal,
       return;
     try {
       if (grouped)
-        process6.kill(-proc.pid, killing);
+        process8.kill(-proc.pid, killing);
       else
         proc.kill(killing);
     } catch {}
@@ -742,14 +791,14 @@ var RESET_STYLE = `${ESC}[0m`;
 var CLOSE_LINK = `${ESC}]8;;${ESC}\\`;
 // ../kit/src/cli.ts
 import { readFileSync, realpathSync } from "fs";
-import { dirname as dirname2, join as join2 } from "path";
-import process8 from "process";
+import { dirname as dirname2, join as join3 } from "path";
+import process10 from "process";
 
 // ../kit/src/usage.ts
 import { appendFileSync, mkdirSync } from "fs";
-import { homedir } from "os";
-import { dirname, isAbsolute, join } from "path";
-import process7 from "process";
+import { homedir as homedir2 } from "os";
+import { dirname, isAbsolute, join as join2 } from "path";
+import process9 from "process";
 
 // ../kit/src/logs.ts
 var DAY_MS = 24 * 60 * 60 * 1000;
@@ -763,14 +812,14 @@ var usageError;
 function noteUsageError(message) {
   usageError = message;
 }
-function stateHome(env = process7.env) {
+function stateHome(env = process9.env) {
   const dir = env.XDG_STATE_HOME;
-  return dir !== undefined && isAbsolute(dir) ? dir : join(homedir(), ".local", "state");
+  return dir !== undefined && isAbsolute(dir) ? dir : join2(homedir2(), ".local", "state");
 }
-function usagePath(env = process7.env) {
-  return join(stateHome(env), CLI_FOLDER, "usage.jsonl");
+function usagePath(env = process9.env) {
+  return join2(stateHome(env), CLI_FOLDER, "usage.jsonl");
 }
-function usageRecorded(env = process7.env) {
+function usageRecorded(env = process9.env) {
   const off = env.KAYNOOO_CLI_NO_USAGE;
   return env.NODE_ENV !== "test" && (off === undefined || off === "" || off === "0");
 }
@@ -784,7 +833,7 @@ function usageEntry(bin, command, argv, code, now = new Date) {
   usageError = undefined;
   return { at: now.toISOString(), bin, ...command === undefined ? {} : { command }, flags: flagNames(argv), code, ...unknown === undefined ? {} : { unknown } };
 }
-function recordUsage(entry, env = process7.env) {
+function recordUsage(entry, env = process9.env) {
   if (!usageRecorded(env))
     return;
   try {
@@ -923,8 +972,8 @@ async function help2({ path, header, summary: lazySummary, commands, defaultComm
 `);
 }
 function printError(prefix, message, hint, cause) {
-  const colors = paint(process8.stderr);
-  const styled = takesControlCodes(process8.stderr);
+  const colors = paint(process10.stderr);
+  const styled = takesControlCodes(process10.stderr);
   const head = styled ? `${colors.red.bold("error")} ${colors.dim(`${prefix}:`)}` : `error: ${prefix}:`;
   const under = (label, text, tint) => text === undefined ? "" : `
   ${styled ? tint(label) : `${label}:`} ${text}`;
@@ -967,11 +1016,11 @@ async function dispatch(level, typed, { version, redact }) {
     }
   }
   if (name === undefined && level.path.length > 1) {
-    console.error(await help2(await expand(level, [...level.path.slice(1), ...argv]), process8.stderr));
+    console.error(await help2(await expand(level, [...level.path.slice(1), ...argv]), process10.stderr));
     return 2;
   }
   if (name === undefined || name === "help" || name === "--help" || name === "-h") {
-    console.log(await help2(await expand(level, [...level.path.slice(1), ...argv]), process8.stdout));
+    console.log(await help2(await expand(level, [...level.path.slice(1), ...argv]), process10.stdout));
     return 0;
   }
   if (level.path.length === 1 && (name === "--version" || name === "-v")) {
@@ -1090,7 +1139,7 @@ async function printCandidates(found) {
 function packageVersion(entry = Bun.main) {
   for (let dir = dirname2(realpathSync(entry));; dir = dirname2(dir)) {
     try {
-      const { version } = JSON.parse(readFileSync(join2(dir, "package.json"), "utf8"));
+      const { version } = JSON.parse(readFileSync(join3(dir, "package.json"), "utf8"));
       if (typeof version === "string")
         return version;
     } catch {}
@@ -1098,7 +1147,7 @@ function packageVersion(entry = Bun.main) {
       return "0.0.0";
   }
 }
-async function runCli(cli, argv = process8.argv.slice(2)) {
+async function runCli(cli, argv = process10.argv.slice(2)) {
   const version = cli.version ?? packageVersion();
   if (argv[0] === COMPLETE)
     return printCandidates(candidates(scopeOf(cli.commands, cli.extraCommands, cli.aliases), cli.defaultCommand, argv.slice(1)));
@@ -1125,7 +1174,7 @@ function commandPath(scope, argv) {
   }
   return path.length === 0 ? undefined : path.join(" ");
 }
-async function runMain({ name, version, run, redact, usage }, argv = process8.argv.slice(2)) {
+async function runMain({ name, version, run, redact, usage }, argv = process10.argv.slice(2)) {
   if (argv[0] === COMPLETE)
     return printCandidates(leafCandidates(run, argv.slice(1)));
   if (argv.length === 1 && (argv[0] === "--version" || argv[0] === "-v")) {
@@ -1151,14 +1200,96 @@ var SECRET_WORDS = new Set(["key", "pass", "pwd", "auth", "salt", "cookie", "ses
 var {Glob } = globalThis.Bun;
 var SESSION_FILES = new Glob("*.json");
 var ACCOUNT_DIRS = new Glob("*/sessions");
+// ../kit/src/workspace-root.ts
+import { existsSync, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { homedir as homedir3 } from "os";
+import { dirname as dirname3, join as join4, resolve } from "path";
+import process11 from "process";
+function expandHome(path, home) {
+  if (path === "~")
+    return home;
+  return path.startsWith("~/") ? join4(home, path.slice(2)) : path;
+}
+function configured(env, home) {
+  const path = userConfigPath("config", { home, xdg: env.XDG_CONFIG_HOME });
+  if (!existsSync(path))
+    return;
+  try {
+    const parsed = JSON.parse(readFileSync2(path, "utf8"));
+    const folder = typeof parsed === "object" && parsed !== null ? parsed.workspace : undefined;
+    return typeof folder === "string" && folder !== "" ? folder : undefined;
+  } catch {
+    return;
+  }
+}
+function workspaceRoot({ given, env = process11.env, home = homedir3() } = {}) {
+  const fromEnv = env.KAYNOOO_WORKSPACE === "" ? undefined : env.KAYNOOO_WORKSPACE;
+  return resolve(expandHome(given ?? fromEnv ?? configured(env, home) ?? join4(home, "Workspace"), home));
+}
+function workspaceChosen({ env = process11.env, home = homedir3() } = {}) {
+  return (env.KAYNOOO_WORKSPACE ?? "") !== "" || configured(env, home) !== undefined;
+}
+function saveWorkspace(folder, { env = process11.env, home = homedir3() } = {}) {
+  const path = userConfigPath("config", { home, xdg: env.XDG_CONFIG_HOME });
+  let current = {};
+  if (existsSync(path)) {
+    try {
+      const parsed = JSON.parse(readFileSync2(path, "utf8"));
+      if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+        return false;
+      current = parsed;
+    } catch {
+      return false;
+    }
+  }
+  mkdirSync2(dirname3(path), { recursive: true });
+  writeFileSync(path, `${JSON.stringify({ ...current, workspace: folder }, undefined, 2)}
+`);
+  return true;
+}
 // src/completions.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync3, rmSync } from "fs";
-import { join as join4 } from "path";
-import process10 from "process";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readdirSync, readFileSync as readFileSync4, rmSync } from "fs";
+import { join as join6 } from "path";
+import process13 from "process";
+
+// src/checks.ts
+import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
+import { basename, join as join5 } from "path";
+
+// src/catalog.ts
+var HOOKS_REQUIRES = "@kaynooo/cli-guard";
+var ABOUT = {
+  "@kaynooo/cli-base": "run a command at a ref in a throwaway worktree, and prove a test fails before a change",
+  "@kaynooo/cli-changelog": "release notes from conventional commits, published as a Forgejo release",
+  "@kaynooo/cli-check": "the repo's check, lint and test steps, its fixers, error lines from logs and a recipe picker",
+  "@kaynooo/cli-code": "source read by spans, TODO comments and the files worth splitting",
+  "@kaynooo/cli-db": "read-only SQL against Postgres, MySQL and MariaDB, credentials never shown",
+  "@kaynooo/cli-dev": "passwords, JWTs, timestamps, UUIDs, base64 and file hashes",
+  "@kaynooo/cli-docker": "docker compose on the stack found here, service health, shells and Symfony commands",
+  "@kaynooo/cli-doctor": "this install check, and the list of every bin",
+  "@kaynooo/cli-edit": "replace text in files, writing nothing unless every match count is right",
+  "@kaynooo/cli-env": ".env files listed and edited with secrets masked, and a secrets filter for pipes",
+  "@kaynooo/cli-forgejo": "Forgejo CI runs, logs, releases and issue checklists",
+  "@kaynooo/cli-git": "repository state in one line, commits of exact paths, a branch picker",
+  "@kaynooo/cli-gitlab": "GitLab pipelines and their failed tests",
+  "@kaynooo/cli-guard": "the safety rules a Claude Code Bash call is held to",
+  "@kaynooo/cli-out": "shortens a noisy command's output, keeping the errors",
+  "@kaynooo/cli-pick": "a fuzzy selector for pipes",
+  "@kaynooo/cli-pkg": "vets npm packages before they are added, and bumps a lib in its consumers",
+  "@kaynooo/cli-probe": "a site's HTTP version, redirects, timings and TLS",
+  "@kaynooo/cli-proc": "what a process is, who listens on a port, leftover dev processes",
+  "@kaynooo/cli-stack": "a stable port per service name, and a compose release audit",
+  "@kaynooo/cli-view": "markdown, source and git diffs in the colours of the other bins",
+  "@kaynooo/cli-wait": "wait for a line, a port, a URL or a process; a machine-wide slot for heavy jobs",
+  "@kaynooo/cli-workspace": "the repositories under a root needing attention, reclaimable folders and known vulnerabilities"
+};
+var NEEDS = {
+  "@kaynooo/cli-forgejo": [{ bin: "tea", why: "ft goes through it", how: "https://gitea.com/gitea/tea/releases" }],
+  "@kaynooo/cli-gitlab": [{ bin: "glab", why: "gl goes through it", how: "https://gitlab.com/gitlab-org/cli" }],
+  "@kaynooo/cli-docker": [{ bin: "docker", why: "dc, dlog, dx and sf run docker compose", how: "https://docs.docker.com/engine/install/" }]
+};
 
 // src/checks.ts
-import { existsSync, readFileSync as readFileSync2 } from "fs";
-import { basename, join as join3 } from "path";
 var TOOLS = {
   "@kaynooo/cli-base": ["base", "proof"],
   "@kaynooo/cli-changelog": ["changelog"],
@@ -1199,7 +1330,7 @@ function readJsonText(text) {
   }
 }
 function readJson(path) {
-  return existsSync(path) ? readJsonText(readFileSync2(path, "utf8")) : undefined;
+  return existsSync2(path) ? readJsonText(readFileSync3(path, "utf8")) : undefined;
 }
 function firstLine(text) {
   const trimmed = text.trim();
@@ -1208,12 +1339,15 @@ function firstLine(text) {
   return end === -1 ? trimmed : trimmed.slice(0, end);
 }
 function installed(host, name) {
-  return readJson(join3(host.globalModules, name, "package.json"));
+  return readJson(join5(host.globalModules, name, "package.json"));
+}
+function isInstalled(host, name) {
+  return installed(host, name)?.version !== undefined;
 }
 function ownBin(host, name, bin) {
   const declared = installed(host, name)?.bin;
   const file = typeof declared === "string" ? declared : declared?.[bin];
-  return file === undefined ? undefined : join3(host.globalModules, name, file);
+  return file === undefined ? undefined : join5(host.globalModules, name, file);
 }
 async function checkTool(host, name, bins) {
   const check = name.slice(name.indexOf("/") + 1);
@@ -1228,7 +1362,7 @@ async function checkTool(host, name, bins) {
   if (latest !== "" && Bun.semver.order(version, latest) < 0)
     return { check, ok: false, detail: `${version}, ${latest} released${off.length > 0 ? `, ${off.join(", ")} not on the PATH` : ""}`, fix: `bun install -g ${name}@${latest}` };
   if (off.length > 0)
-    return { check, ok: false, detail: `${version}, ${off.join(", ")} not on the PATH`, fix: `add ${join3(host.globalModules, "..", "..", "..", "bin")} to the PATH` };
+    return { check, ok: false, detail: `${version}, ${off.join(", ")} not on the PATH`, fix: `add ${join5(host.globalModules, "..", "..", "..", "bin")} to the PATH` };
   if (latest === "")
     return { check, ok: true, detail: `${version}, the registry did not answer: ${firstLine(info.stderr) || answered || "no version"}` };
   return { check, ok: true, detail: version };
@@ -1248,10 +1382,16 @@ async function checkTea(host) {
     return { check: "tea", ok: false, detail: `${forge} did not answer: ${firstLine(version.stderr || version.stdout)}`, fix: `tea login edit ${login.name} --token <token>, or check the network` };
   return { check: "tea", ok: true, detail: `logged in to ${forge} as ${login.name}, Forgejo ${served}` };
 }
-function checkHooks(host) {
-  const settings = readJson(join3(host.home, ".claude", "settings.json")) ?? {};
+function hooksWiring(host) {
+  const settings = readJson(join5(host.home, ".claude", "settings.json")) ?? {};
   const plugin = settings.enabledPlugins?.[PLUGIN] === true;
-  const mod = (settings.env?.CLAUDE_CODE_PLUGIN_DIRS ?? "").split(":").map((dir) => dir.replace(LEADING_TILDE, host.home)).find((dir) => basename(dir) === "cli" && existsSync(join3(dir, "hooks", "hooks.json")));
+  const mod = (settings.env?.CLAUDE_CODE_PLUGIN_DIRS ?? "").split(":").map((dir) => dir.replace(LEADING_TILDE, host.home)).find((dir) => basename(dir) === "cli" && existsSync2(join5(dir, "hooks", "hooks.json")));
+  return { plugin, mod };
+}
+function checkHooks(host) {
+  const { plugin, mod } = hooksWiring(host);
+  if ((plugin || mod !== undefined) && !isInstalled(host, HOOKS_REQUIRES))
+    return { check: "hooks", ok: false, detail: `wired, but ${HOOKS_REQUIRES} is not installed, so every hook finds no guard`, fix: `bun install -g ${HOOKS_REQUIRES}` };
   if (plugin && mod !== undefined)
     return { check: "hooks", ok: false, detail: `both the ${PLUGIN} plugin and the mod in ${mod} run guard, so every call is checked twice`, fix: `claude plugin disable ${PLUGIN}` };
   if (plugin)
@@ -1276,21 +1416,39 @@ function checkCompletions(host) {
     return { check: "completions", ok: false, detail: `no fish completion in ${dir} for ${missing.join(", ")}`, fix: "cli completions fish --install" };
   return { check: "completions", ok: true, detail: dir };
 }
+function checkNeeds(host) {
+  const missing = Object.entries(NEEDS).flatMap(([name, needs]) => isInstalled(host, name) ? needs.filter((need) => need.bin !== "tea" && host.which(need.bin) === null) : []);
+  if (missing.length > 0)
+    return { check: "needs", ok: false, detail: `missing ${missing.map((need) => `${need.bin} (${need.why})`).join(", ")}`, fix: `install ${missing.map((need) => `${need.bin}: ${need.how}`).join("; ")}` };
+  return { check: "needs", ok: true, detail: "every tool the installed packages need is on the PATH" };
+}
 var toolCheck = (name) => name.slice(name.indexOf("/") + 1);
-var OTHER_CHECKS = ["tea", "hooks", "bun", "completions"];
+var OTHER_CHECKS = ["tea", "hooks", "needs", "bun", "completions", "workspace"];
+var FORGEJO = "@kaynooo/cli-forgejo";
+var WORKSPACE = "@kaynooo/cli-workspace";
+function checkWorkspace(host, env = process.env) {
+  const folder = workspaceRoot({ home: host.home, env });
+  if (existsSync2(folder))
+    return { check: "workspace", ok: true, detail: folder };
+  return { check: "workspace", ok: false, detail: `${folder} does not exist`, fix: `mkdir -p ${folder}, or set "workspace" in ~/.config/kaynooo-cli/config.json to your folder` };
+}
 var CHECK_NAMES = [...Object.keys(TOOLS).map(toolCheck), ...OTHER_CHECKS];
 async function runChecks(host, only = []) {
   const wanted = (check) => only.length === 0 || only.includes(check);
-  const entries = Object.entries(TOOLS).filter(([name]) => wanted(toolCheck(name)));
+  const entries = Object.entries(TOOLS).filter(([name]) => only.length === 0 ? isInstalled(host, name) : wanted(toolCheck(name)));
+  const { plugin, mod } = hooksWiring(host);
+  const hooks = only.length > 0 || plugin || mod !== undefined || isInstalled(host, HOOKS_REQUIRES);
   const tools = [];
   for (let at = 0;at < entries.length; at += INFO_AT_ONCE)
     tools.push(...await Promise.all(entries.slice(at, at + INFO_AT_ONCE).map(async ([name, bins]) => checkTool(host, name, bins))));
   return [
     ...tools,
-    ...wanted("tea") ? [await checkTea(host)] : [],
-    ...wanted("hooks") ? [checkHooks(host)] : [],
+    ...wanted("tea") && (only.length > 0 || isInstalled(host, FORGEJO)) ? [await checkTea(host)] : [],
+    ...wanted("hooks") && hooks ? [checkHooks(host)] : [],
+    ...wanted("needs") ? [checkNeeds(host)] : [],
     ...wanted("bun") ? [checkBun(host)] : [],
-    ...wanted("completions") ? [checkCompletions(host)] : []
+    ...wanted("completions") ? [checkCompletions(host)] : [],
+    ...wanted("workspace") && (only.length > 0 || isInstalled(host, WORKSPACE) || isInstalled(host, "@kaynooo/cli-pkg")) ? [checkWorkspace(host)] : []
   ];
 }
 
@@ -1328,8 +1486,8 @@ ${BASH_FUNCTION}
 complete -F __kaynooo_cli_complete ${bins.join(" ")}
 `;
 }
-function completionDir(home, env = process10.env) {
-  return join4(env.XDG_CACHE_HOME ?? join4(home, ".cache"), "fish", "kaynooo-cli");
+function completionDir(home, env = process13.env) {
+  return join6(env.XDG_CACHE_HOME ?? join6(home, ".cache"), "fish", "kaynooo-cli");
 }
 function installedBins(host) {
   return Object.values(TOOLS).flat().filter((bin) => host.which(bin) !== null);
@@ -1342,19 +1500,19 @@ complete -c ${bin} -f -a '(__kaynooo_cli_complete ${bin})'
 }
 async function installCompletions(host, dir) {
   const bins = installedBins(host);
-  mkdirSync2(dir, { recursive: true });
-  const removed = readdirSync(dir).filter((name) => FISH_FILE.test(name) && !bins.includes(name.replace(FISH_FILE, "")) && readFileSync3(join4(dir, name), "utf8").startsWith(MARKER));
+  mkdirSync3(dir, { recursive: true });
+  const removed = readdirSync(dir).filter((name) => FISH_FILE.test(name) && !bins.includes(name.replace(FISH_FILE, "")) && readFileSync4(join6(dir, name), "utf8").startsWith(MARKER));
   for (const name of removed)
-    rmSync(join4(dir, name));
-  await Promise.all(bins.map(async (bin) => Bun.write(join4(dir, `${bin}.fish`), completionFile(bin))));
+    rmSync(join6(dir, name));
+  await Promise.all(bins.map(async (bin) => Bun.write(join6(dir, `${bin}.fish`), completionFile(bin))));
   return { written: bins, removed: removed.map((name) => name.replace(FISH_FILE, "")) };
 }
 function missingCompletions(host, dir) {
-  return installedBins(host).filter((bin) => !existsSync2(join4(dir, `${bin}.fish`)));
+  return installedBins(host).filter((bin) => !existsSync3(join6(dir, `${bin}.fish`)));
 }
 
 // src/doctor.ts
-import process12 from "process";
+import process17 from "process";
 
 // src/fix.ts
 var INSTALL = /^bun install -g (\S+)$/;
@@ -1394,19 +1552,19 @@ async function applyFixes(host, steps, dry) {
 }
 
 // src/host.ts
-import { homedir as homedir2 } from "os";
-import { join as join5 } from "path";
-import process11 from "process";
+import { homedir as homedir4 } from "os";
+import { join as join7 } from "path";
+import process14 from "process";
 var RUN_TIMEOUT_MS = 20000;
 function hostHere() {
-  const home = homedir2();
+  const home = homedir4();
   return {
     home,
-    globalModules: join5(process11.env.BUN_INSTALL ?? join5(home, ".bun"), "install", "global", "node_modules"),
+    globalModules: join7(process14.env.BUN_INSTALL ?? join7(home, ".bun"), "install", "global", "node_modules"),
     bunVersion: Bun.version,
     which: (bin) => Bun.which(bin),
     run: async (argv, env) => {
-      const ran = await runCommand(argv, { timeoutMs: RUN_TIMEOUT_MS, ...env === undefined ? {} : { env: { ...process11.env, ...env } } });
+      const ran = await runCommand(argv, { timeoutMs: RUN_TIMEOUT_MS, ...env === undefined ? {} : { env: { ...process14.env, ...env } } });
       if (ran.timedOut)
         return { code: 1, stdout: "", stderr: `timed out after ${RUN_TIMEOUT_MS / 1000}s` };
       const of = (stream) => Buffer.concat(ran.chunks.filter((chunk) => chunk.stream === stream).map((chunk) => chunk.data)).toString();
@@ -1415,11 +1573,325 @@ function hostHere() {
   };
 }
 
+// src/install.ts
+import process16 from "process";
+
+// ../kit/src/prompt.ts
+import process15 from "process";
+var KEY_SEQUENCES = /\x1B\[[0-9;]*[A-Z~]|\x1BO[A-Z]|[\s\S]/giu;
+var CONTROL = /^[\x00-\x1F\x7F]/;
+var WORDS = /\s+/;
+var MAX_ROWS = 10;
+var KEYS = { "\x1B[A": "up", "\x1BOA": "up", "\x1B[B": "down", "\x1BOB": "down", "\r": "enter", "\n": "enter", "\x03": "cancel", "\x1B": "cancel", "\x7F": "erase", "\b": "erase" };
+function readKeys(input) {
+  return (input.match(KEY_SEQUENCES) ?? []).flatMap((sequence) => KEYS[sequence] ?? (CONTROL.test(sequence) ? [] : [{ text: sequence }]));
+}
+function flip(checked, value) {
+  const next = new Set(checked);
+  if (!next.delete(value))
+    next.add(value);
+  return next;
+}
+async function checklist(question, choices, { initial = new Set, min = 0, toggle = flip, ...settings } = {}) {
+  const list = new List(choices, 0);
+  let checked = initial;
+  let invalid;
+  const accepted = await ask(question, settings, (colors, state, rows) => state === "asking" ? [asking(colors, question, list.query, "type to filter, space toggles, enter accepts"), ...list.rows(colors, rows, (choice) => checked.has(choice.value) ? `${colors.cyan("\u25C9")} ` : `${colors.dim("\u25EF")} `), ...invalid === undefined ? [] : [`  ${colors.red(invalid)}`]] : [answer(colors, question, state, choices.filter((choice) => checked.has(choice.value)).map((choice) => choice.label).join(", ") || "none")], (key) => {
+    if (key === "cancel")
+      return key;
+    invalid = undefined;
+    if (key === "enter") {
+      invalid = checked.size < min ? `pick at least ${min}` : undefined;
+      return invalid === undefined ? "enter" : undefined;
+    }
+    const current = list.current();
+    if (typeof key === "object" && key.text === " ") {
+      if (current !== undefined)
+        checked = toggle(checked, current.value);
+      return;
+    }
+    list.press(key);
+    return;
+  });
+  return accepted ? checked : undefined;
+}
+async function input2(question, { default: fallback, mask = false, validate, ...settings } = {}) {
+  let value = "";
+  let invalid;
+  const taken = () => value === "" ? fallback ?? "" : value;
+  const shown = () => mask ? "*".repeat([...taken()].length) : taken();
+  const accepted = await ask(question, settings, (colors, state, { columns }) => {
+    if (state !== "asking")
+      return [answer(colors, question, state, shown())];
+    const characters = [...shown()];
+    const room = Math.max(columns - question.length - 5, 1);
+    const tail = characters.length > room ? `\u2026${characters.slice(1 - room).join("")}` : shown();
+    const typed = value === "" ? colors.dim(tail) : tail;
+    return [`${colors.cyan("?")} ${question} ${typed}${colors.dim("\u2588")}`, ...invalid === undefined ? [] : [`  ${colors.red(invalid)}`]];
+  }, (key) => {
+    if (key === "cancel")
+      return "cancel";
+    invalid = undefined;
+    if (key === "enter") {
+      invalid = validate?.(taken());
+      return invalid === undefined ? "enter" : undefined;
+    }
+    if (key === "erase")
+      value = [...value].slice(0, -1).join("");
+    else if (typeof key === "object")
+      value += key.text;
+    return;
+  });
+  return accepted ? taken() : undefined;
+}
+
+class List {
+  choices;
+  query = "";
+  matches;
+  cursor;
+  top = 0;
+  width;
+  constructor(choices, initial) {
+    this.choices = choices;
+    this.matches = choices;
+    this.cursor = Math.min(Math.max(initial, 0), choices.length - 1);
+    this.width = Math.max(0, ...choices.map((choice) => choice.label.length));
+  }
+  current() {
+    return this.matches[this.cursor];
+  }
+  press(key) {
+    if (key === "up" || key === "down") {
+      if (this.matches.length > 0)
+        this.cursor = (this.cursor + (key === "up" ? this.matches.length - 1 : 1)) % this.matches.length;
+      return;
+    }
+    if (key === "erase")
+      this.filter([...this.query].slice(0, -1).join(""));
+    else if (typeof key === "object")
+      this.filter(this.query + key.text);
+  }
+  filter(query) {
+    const words = query.toLowerCase().split(WORDS).filter((word) => word !== "");
+    const current = this.current();
+    this.query = query;
+    this.matches = this.choices.filter(({ label, hint }) => words.every((word) => `${label} ${hint}`.toLowerCase().includes(word)));
+    this.cursor = current === undefined ? 0 : Math.max(this.matches.indexOf(current), 0);
+    this.top = 0;
+  }
+  rows(colors, { columns, rows }, marker) {
+    if (this.matches.length === 0)
+      return [colors.dim("  no match")];
+    const height = Math.max(1, Math.min(MAX_ROWS, rows - 3, this.matches.length));
+    this.top = Math.min(Math.max(this.top, this.cursor - height + 1), this.cursor);
+    const shown = this.matches.slice(this.top, this.top + height).map((choice, index) => {
+      const here = this.top + index === this.cursor;
+      const mark = marker(choice);
+      const head = `${here ? "\u276F" : " "} ${mark}`;
+      const label = choice.label.padEnd(this.width);
+      const room = columns - 5 - (mark === "" ? 0 : 2) - this.width;
+      return `${here ? colors.cyan(head) : head}${here ? colors.cyan(label) : label}  ${colors.dim(truncate(choice.hint, Math.max(room, 0)))}`;
+    });
+    const below = this.matches.length - this.top - height;
+    return [...this.top > 0 ? [colors.dim(`  \u2026 ${this.top} more`)] : [], ...shown, ...below > 0 ? [colors.dim(`  \u2026 ${below} more`)] : []];
+  }
+}
+function asking(colors, question, typed, keys) {
+  return `${colors.cyan("?")} ${question} ${typed === "" ? colors.dim(`(${keys})`) : typed}`;
+}
+function answer(colors, question, state, picked) {
+  return state === "enter" ? `${colors.green("\u2713")} ${question} ${colors.cyan(picked)}` : `${colors.red("\u2717")} ${question} ${colors.dim("cancelled")}`;
+}
+async function ask(question, { hint, terminal = process15 }, render, press) {
+  const { stdin, stderr } = terminal;
+  if (!isInteractive(terminal))
+    fail(`cannot ask "${question}" off a terminal`, 2, hint);
+  const colors = paint(stderr);
+  let drawn = 0;
+  let outcome;
+  const draw = (state) => {
+    const frame = render(colors, state, { columns: stderr.columns || 80, rows: stderr.rows || 24 });
+    stderr.write(`${drawn > 1 ? `\x1B[${drawn - 1}A` : ""}\r\x1B[0J${frame.join(`
+`)}`);
+    drawn = frame.length;
+  };
+  try {
+    stdin.setRawMode(true);
+    stdin.resume();
+    stderr.write("\x1B[?25l");
+    draw("asking");
+    return await new Promise((resolve) => {
+      function onData(data) {
+        for (const key of readKeys(data.toString())) {
+          const pressed = press(key);
+          if (pressed !== undefined) {
+            settle(pressed);
+            return;
+          }
+        }
+        draw("asking");
+      }
+      function onEnd() {
+        settle("cancel");
+      }
+      function settle(settled) {
+        outcome = settled;
+        stdin.off("data", onData);
+        stdin.off("end", onEnd);
+        resolve(settled === "enter");
+      }
+      stdin.on("data", onData);
+      stdin.on("end", onEnd);
+    });
+  } finally {
+    draw(outcome ?? "cancel");
+    stderr.write(`
+\x1B[?25h`);
+    stdin.setRawMode(false);
+    stdin.pause();
+  }
+}
+
+// src/install.ts
+var HOOKS = "hooks";
+var PLUGIN_INSTALL = ["claude", "plugin", "install", "cli-hooks", "--marketplace", `https://${FORGE}/kaynooo/cli.git`];
+var CLI_PREFIX = /^cli-/;
+var shortName = (name) => name.slice(name.indexOf("/") + 1).replace(CLI_PREFIX, "");
+function candidates2(host) {
+  const packages = Object.entries(TOOLS).filter(([name]) => !isInstalled(host, name)).map(([name, bins]) => {
+    const needs = (NEEDS[name] ?? []).map((need) => need.bin);
+    return { id: name, names: [shortName(name), name, `cli-${shortName(name)}`, ...bins], label: shortName(name), hint: `${bins.join(" ")}: ${ABOUT[name] ?? ""}${needs.length === 0 ? "" : `, needs ${needs.join(", ")}`}`, packages: [name] };
+  });
+  const { plugin, mod } = hooksWiring(host);
+  if (plugin || mod !== undefined)
+    return packages;
+  return [...packages, { id: HOOKS, names: [HOOKS, "plugin", "cli-hooks"], label: "hooks", hint: `the Claude Code plugin running guard on every tool call, needs ${HOOKS_REQUIRES}`, packages: isInstalled(host, HOOKS_REQUIRES) ? [] : [HOOKS_REQUIRES] }];
+}
+function choose(pool, names) {
+  const chosen = new Set;
+  for (const name of names) {
+    if (name === "all") {
+      for (const each of pool)
+        chosen.add(each);
+      continue;
+    }
+    const found = pool.find((each) => each.names.includes(name));
+    if (found !== undefined)
+      chosen.add(found);
+  }
+  return [...chosen];
+}
+function plan(host, picked, force) {
+  const blocked = [];
+  const warnings = [];
+  const packages = [];
+  for (const name of new Set(picked.flatMap((each) => each.packages))) {
+    const lacking = (NEEDS[name] ?? []).filter((need) => host.which(need.bin) === null);
+    if (lacking.length > 0 && !force) {
+      for (const need of lacking)
+        blocked.push({ package: shortName(name), need: need.bin, why: need.why, how: need.how });
+      continue;
+    }
+    for (const need of lacking)
+      warnings.push({ package: shortName(name), need: need.bin, why: need.why });
+    packages.push(name);
+  }
+  const guardBlocked = blocked.some((each) => `@kaynooo/cli-${each.package}` === HOOKS_REQUIRES);
+  return { packages, plugin: picked.some((each) => each.id === HOOKS) && !guardBlocked, blocked, warnings };
+}
+function checksFor(packages, plugin) {
+  return [...packages.map((name) => name.slice(name.indexOf("/") + 1)), ...plugin ? ["hooks"] : [], "needs", "completions", ...packages.includes("@kaynooo/cli-forgejo") ? ["tea"] : []];
+}
+async function ask2(pool) {
+  if (!isInteractive())
+    badUsage("name what to install, or all: doctor --install forgejo check hooks (doctor --install --list shows the choices)");
+  const choices = pool.map((each) => ({ value: each, label: each.label, hint: each.hint }));
+  const picked = await checklist("install which?", choices, { hint: "name them instead: doctor --install forgejo check" });
+  return picked === undefined ? [] : [...picked];
+}
+async function askWorkspace(host) {
+  if (!isInteractive() || workspaceChosen({ home: host.home }))
+    return;
+  const folder = await input2("folder holding your repositories (repos, sweep and pkg bump look there)", { default: "~/Workspace" });
+  if (folder !== undefined && folder !== "" && !saveWorkspace(folder, { home: host.home }))
+    console.error(`could not write the workspace into ${userConfigPath("config", { home: host.home })}: it does not parse, fix it by hand`);
+}
+async function install(host, options, recheck) {
+  const pool = candidates2(host);
+  const { dim, green, red, yellow } = paint(process16.stdout);
+  if (options.list) {
+    for (const each of pool)
+      console.log(`${each.label.padEnd(12)} ${dim(each.hint)}`);
+    if (pool.length === 0)
+      console.log("everything is installed");
+    return 0;
+  }
+  if (pool.length === 0) {
+    console.log("everything is installed");
+    return 0;
+  }
+  const unknown = options.names.filter((name) => name !== "all" && !Object.values(candidatesAll(host)).some((each) => each.names.includes(name)));
+  if (unknown.length > 0)
+    badUsage(`nothing to install is named ${unknown.join(", ")}: doctor --install --list`);
+  const picked = options.names.length === 0 ? await ask2(pool) : choose(pool, options.names);
+  const skipped = options.names.filter((name) => name !== "all" && !pool.some((each) => each.names.includes(name)));
+  for (const name of skipped)
+    console.log(`${dim("already")}  ${name} is installed`);
+  if (picked.length === 0) {
+    if (skipped.length === 0)
+      console.log("nothing picked");
+    return 0;
+  }
+  const planned = plan(host, picked, options.force);
+  for (const each of planned.blocked)
+    console.log(`${red("blocked")}  ${each.package} needs ${each.need} (${each.why}): ${each.how}; --force installs it anyway`);
+  for (const each of planned.warnings)
+    console.log(`${yellow("warn   ")}  ${each.package}: ${each.need} is missing, ${each.why}`);
+  if (planned.packages.length === 0 && !planned.plugin)
+    return 1;
+  if (!options.dryRun && planned.packages.some((name) => name === "@kaynooo/cli-workspace" || name === "@kaynooo/cli-pkg"))
+    await askWorkspace(host);
+  const command = ["bun", "install", "-g", ...planned.packages];
+  if (planned.packages.length > 0)
+    console.log(`${options.dryRun ? dim("would  ") : green("install")}  ${command.join(" ")}`);
+  if (planned.plugin)
+    console.log(`${options.dryRun ? dim("would  ") : green("install")}  ${PLUGIN_INSTALL.join(" ")}`);
+  if (options.dryRun)
+    return planned.blocked.length > 0 ? 1 : 0;
+  if (planned.packages.length > 0) {
+    const ran = await host.run(command);
+    if (ran.code !== 0) {
+      console.error(`${red("failed")}   bun install -g: exit ${ran.code}: ${firstLine(ran.stderr || ran.stdout)}`);
+      return 1;
+    }
+  }
+  if (planned.plugin) {
+    if (host.which("claude") === null) {
+      console.log(`${dim("not run")}  claude is not on the PATH: ${PLUGIN_INSTALL.join(" ")}`);
+    } else {
+      const ran = await host.run(PLUGIN_INSTALL);
+      if (ran.code !== 0)
+        console.error(`${red("failed")}   ${PLUGIN_INSTALL.join(" ")}: exit ${ran.code}: ${firstLine(ran.stderr || ran.stdout)}`);
+    }
+  }
+  console.log(`
+after the install:`);
+  const code = await recheck(checksFor(planned.packages, planned.plugin));
+  return planned.blocked.length > 0 ? 1 : code;
+}
+function candidatesAll(host) {
+  const open = candidates2(host);
+  const done = Object.entries(TOOLS).filter(([name]) => isInstalled(host, name)).map(([name, bins]) => ({ id: name, names: [shortName(name), name, `cli-${shortName(name)}`, ...bins], label: shortName(name), hint: "", packages: [name] }));
+  return [...open, ...done];
+}
+
 // src/doctor.ts
-var USAGE = `doctor [--only <check>] [--quiet] [--fix [--dry-run]] [--json]: checks this host's @kaynooo/cli-* install, one line per check, the command that fixes a failing one beside it
+var USAGE = `doctor [--only <check>] [--quiet] [--fix | --install [<name>...|all]] [--list] [--dry-run] [--force] [--json]: checks this host's @kaynooo/cli-* install, one line per check, the command that fixes a failing one beside it, and installs the packages it picks
 
-Each @kaynooo/cli-* package installed globally with its bins on the PATH and no older than the registry's latest; tea logged in to git.kaynooo.fr and reaching it; the Claude Code hooks wired through the cli-hooks plugin or the cli mod, not both; Bun at least the version the tools ask for; fish completions for every bin.
+Each @kaynooo/cli-* package installed globally with its bins on the PATH and no older than the registry's latest; tea logged in to git.kaynooo.fr and reaching it when ft is installed; the system tools the installed packages need (glab, docker); the Claude Code hooks wired through the cli-hooks plugin or the cli mod, not both, with guard installed; Bun at least the version the tools ask for; fish completions for every bin. A package not installed is no failure, the last line counts them.
 --fix runs the printed fix: lines it may (global installs of the packages, the completions, the hooks plugin), the installs in one call, then checks again; a line that installs a system package or only describes a step is printed as not run. --dry-run shows what --fix would run.
+--install adds packages: the names given (a package such as forgejo, one of its bins such as ft, hooks for the Claude Code plugin, or all), else a checklist on a terminal. Each is checked against what it needs first: a missing required tool (tea for ft, glab for gl, docker for dc) leaves that package out unless --force, and hooks brings guard along. doctor never installs a system package. Then it checks and fixes what it installed. --list prints the choices, --dry-run what would be installed.
 --quiet prints only the failing checks, nothing when all pass. --only limits the run to the checks named, e.g. --only tea --only bun.`;
 var EXITS = [[0, "every check passes (after --fix, the ones it fixed too)"], [1, "a check fails"], [2, "a usage error"]];
 var INSTALL2 = "bun install -g ";
@@ -1428,12 +1900,15 @@ var OPTIONS = {
   only: { type: "string", multiple: true, choices: CHECK_NAMES, description: "run only this check (a package such as cli-forgejo, tea, hooks, bun or completions), repeatable" },
   quiet: { type: "boolean", short: "q", description: "print only the failing checks" },
   fix: { type: "boolean", description: "run the fix: lines doctor may run, then check again" },
-  "dry-run": { type: "boolean", description: "with --fix, show what would run without running it (alone, it implies --fix)" }
+  "dry-run": { type: "boolean", description: "with --fix or --install, show what would run without running it (alone, it implies --fix)" },
+  install: { type: "boolean", description: "install the packages named, or picked from a checklist: forgejo, ft, hooks, all" },
+  list: { type: "boolean", description: "with --install, print the choices" },
+  force: { type: "boolean", description: "with --install, install a package even though a tool it requires is missing" }
 };
 function print(results) {
   if (results.length === 0)
     return;
-  const { green, red, dim } = paint(process12.stdout);
+  const { green, red, dim } = paint(process17.stdout);
   const width = Math.max(...results.map((result) => result.check.length));
   for (const { check, ok, detail, fix } of results)
     console.log(`${ok ? green("ok  ") : red("FAIL")}  ${check.padEnd(width)}  ${detail}${fix === undefined ? "" : `  ${dim("fix:")} ${fix}`}`);
@@ -1443,14 +1918,21 @@ function print(results) {
 ${dim("fix them all:")} ${INSTALL2}${installs.join(" ")}`);
 }
 function printOutcomes(outcomes, log) {
-  const { green, red, dim } = paint(process12.stdout);
+  const { green, red, dim } = paint(process17.stdout);
   const marks = { ran: green("ran    "), failed: red("failed "), "dry-run": dim("would  "), "not run": dim("not run") };
   for (const { command, status, detail } of outcomes)
     log(`${marks[status]}  ${command}${detail === undefined ? "" : `  ${dim(detail)}`}`);
 }
 async function main(args, host = hostHere()) {
-  const { values } = parse(args, USAGE, OPTIONS, { positionals: [], exits: EXITS, replaces: "checking each bin's version, tea's login and the hooks by hand", examples: ["doctor", ["doctor --json", "the checks for a script"], ["doctor -q", "silent unless something fails"], ["doctor --fix --dry-run", "what --fix would run"]] });
+  const { values, positionals } = parse(args, USAGE, OPTIONS, { positionals: ["[name...]"], exits: EXITS, replaces: "checking each bin's version, tea's login and the hooks by hand", examples: ["doctor", ["doctor --json", "the checks for a script"], ["doctor -q", "silent unless something fails"], ["doctor --fix --dry-run", "what --fix would run"], ["doctor --install", "pick the packages to add"], ["doctor --install forgejo check hooks", "three named ones"], ["doctor --install all --dry-run", "what installing everything would run"]] });
   const only = values.only ?? [];
+  if (values.install !== true && (positionals.length > 0 || values.list === true || values.force === true))
+    badUsage("names, --list and --force go with --install");
+  if (values.install === true) {
+    if (values.fix === true || only.length > 0 || values.json === true || values.quiet === true)
+      badUsage("--install does not combine with --fix, --only, --json or --quiet");
+    return install(host, { names: positionals, list: values.list === true, dryRun: values["dry-run"] === true, force: values.force === true }, async (checks) => main(["--fix", ...checks.flatMap((check) => ["--only", check])], host));
+  }
   const dry = values["dry-run"] === true;
   const json = values.json === true;
   let results = await runChecks(host, only);
@@ -1473,6 +1955,10 @@ after the fixes:`);
     printJson(shown);
   else
     print(shown);
+  const absent = Object.keys(TOOLS).filter((name) => !isInstalled(host, name)).length;
+  if (!json && only.length === 0 && absent > 0)
+    console.log(`
+${paint(process17.stdout).dim(`${absent} packages not installed: doctor --install`)}`);
   return results.every((result) => result.ok) ? 0 : 1;
 }
 
@@ -1501,7 +1987,7 @@ var LIST_OPTIONS = {
   json: jsonOption("[{bin, package, installed, synopsis?, summary?, replaces?, examples?}]")
 };
 function print2(listed) {
-  const { cyan, dim } = paint(process13.stdout);
+  const { cyan, dim } = paint(process18.stdout);
   const width = Math.max(...listed.map((each) => each.bin.length));
   for (const each of listed) {
     const what = !each.installed ? dim(`not installed: bun install -g ${each.package}`) : `${each.summary ?? ""}${each.replaces === undefined ? "" : dim(`; instead of ${each.replaces}`)}`;
@@ -1584,7 +2070,7 @@ ${table(summary.usageErrors.map((each) => [`${each.bin}${each.command === undefi
   return 0;
 }
 if (import.meta.main) {
-  process13.exitCode = await runCli({
+  process18.exitCode = await runCli({
     name: "cli",
     about: "the bins of the @kaynooo/cli-* packages, described by their own help",
     replaces: "running each bin's --help to find the one that fits",