@kaynooo/cli-doctor 0.8.0 → 0.10.0

package/dist/cli.js

@@ -2,16 +2,37 @@
 // @bun
 
 // src/cli.ts
-import process15 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,22 +295,34 @@ 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 STATUS_WORDS = {
   passed: ["passed", "success", "succeeded", "ok"],
   failed: ["failed", "failure", "error", "errored"],
-  running: ["running", "in_progress", "started"],
+  running: ["running", "in_progress", "started", "holding"],
   queued: ["queued", "waiting", "pending", "created", "blocked", "scheduled"],
   skipped: ["skipped", "cancelled", "canceled", "manual"]
 };
@@ -308,8 +341,11 @@ var ESCAPE = String.fromCharCode(27);
 function textWidth(text) {
   return Bun.stringWidth(text);
 }
-function table(rows, { cellWidth, header = false, align = [], fit, stream = process3.stdout } = {}) {
+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())
@@ -344,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) {
@@ -388,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("|")}>`;
@@ -486,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;
@@ -657,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)
@@ -677,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 {}
@@ -752,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;
@@ -773,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");
 }
@@ -794,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 {
@@ -933,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}`;
@@ -977,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")) {
@@ -1100,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 {}
@@ -1108,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)));
@@ -1135,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")) {
@@ -1161,12 +1200,59 @@ 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/doctor.ts
-import process14 from "process";
+import process17 from "process";
 
 // src/checks.ts
-import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
-import { basename, join as join4 } from "path";
+import { existsSync as existsSync3, readFileSync as readFileSync4 } from "fs";
+import { basename, join as join6 } from "path";
 
 // src/catalog.ts
 var HOOKS_REQUIRES = "@kaynooo/cli-guard";
@@ -1202,9 +1288,9 @@ var NEEDS = {
 };
 
 // src/completions.ts
-import { existsSync, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync2, rmSync } from "fs";
-import { join as join3 } from "path";
-import process10 from "process";
+import { existsSync as existsSync2, mkdirSync as mkdirSync3, readdirSync, readFileSync as readFileSync3, rmSync } from "fs";
+import { join as join5 } from "path";
+import process13 from "process";
 var MARKER = "# Generated by `cli completions fish`";
 var FISH_FILE = /\.fish$/;
 var FUNCTION = `functions -q __kaynooo_cli_complete; or function __kaynooo_cli_complete --argument-names bin --description 'what a @kaynooo/cli-* bin offers for the word being typed'
@@ -1238,8 +1324,8 @@ ${BASH_FUNCTION}
 complete -F __kaynooo_cli_complete ${bins.join(" ")}
 `;
 }
-function completionDir(home, env = process10.env) {
-  return join3(env.XDG_CACHE_HOME ?? join3(home, ".cache"), "fish", "kaynooo-cli");
+function completionDir(home, env = process13.env) {
+  return join5(env.XDG_CACHE_HOME ?? join5(home, ".cache"), "fish", "kaynooo-cli");
 }
 function installedBins(host) {
   return Object.values(TOOLS).flat().filter((bin) => host.which(bin) !== null);
@@ -1252,15 +1338,15 @@ 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, "")) && readFileSync2(join3(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, "")) && readFileSync3(join5(dir, name), "utf8").startsWith(MARKER));
   for (const name of removed)
-    rmSync(join3(dir, name));
-  await Promise.all(bins.map(async (bin) => Bun.write(join3(dir, `${bin}.fish`), completionFile(bin))));
+    rmSync(join5(dir, name));
+  await Promise.all(bins.map(async (bin) => Bun.write(join5(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) => !existsSync(join3(dir, `${bin}.fish`)));
+  return installedBins(host).filter((bin) => !existsSync2(join5(dir, `${bin}.fish`)));
 }
 
 // src/checks.ts
@@ -1304,7 +1390,7 @@ function readJsonText(text) {
   }
 }
 function readJson(path) {
-  return existsSync2(path) ? readJsonText(readFileSync3(path, "utf8")) : undefined;
+  return existsSync3(path) ? readJsonText(readFileSync4(path, "utf8")) : undefined;
 }
 function firstLine(text) {
   const trimmed = text.trim();
@@ -1313,7 +1399,7 @@ function firstLine(text) {
   return end === -1 ? trimmed : trimmed.slice(0, end);
 }
 function installed(host, name) {
-  return readJson(join4(host.globalModules, name, "package.json"));
+  return readJson(join6(host.globalModules, name, "package.json"));
 }
 function isInstalled(host, name) {
   return installed(host, name)?.version !== undefined;
@@ -1321,7 +1407,7 @@ function isInstalled(host, name) {
 function ownBin(host, name, bin) {
   const declared = installed(host, name)?.bin;
   const file = typeof declared === "string" ? declared : declared?.[bin];
-  return file === undefined ? undefined : join4(host.globalModules, name, file);
+  return file === undefined ? undefined : join6(host.globalModules, name, file);
 }
 async function checkTool(host, name, bins) {
   const check = name.slice(name.indexOf("/") + 1);
@@ -1336,7 +1422,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 ${join4(host.globalModules, "..", "..", "..", "bin")} to the PATH` };
+    return { check, ok: false, detail: `${version}, ${off.join(", ")} not on the PATH`, fix: `add ${join6(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 };
@@ -1357,9 +1443,9 @@ async function checkTea(host) {
   return { check: "tea", ok: true, detail: `logged in to ${forge} as ${login.name}, Forgejo ${served}` };
 }
 function hooksWiring(host) {
-  const settings = readJson(join4(host.home, ".claude", "settings.json")) ?? {};
+  const settings = readJson(join6(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" && existsSync2(join4(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" && existsSync3(join6(dir, "hooks", "hooks.json")));
   return { plugin, mod };
 }
 function checkHooks(host) {
@@ -1397,8 +1483,15 @@ function checkNeeds(host) {
   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", "needs", "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 (existsSync3(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);
@@ -1414,7 +1507,8 @@ async function runChecks(host, only = []) {
     ...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)] : []
   ];
 }
 
@@ -1456,19 +1550,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();
@@ -1478,10 +1572,10 @@ function hostHere() {
 }
 
 // src/install.ts
-import process13 from "process";
+import process16 from "process";
 
 // ../kit/src/prompt.ts
-import process12 from "process";
+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+/;
@@ -1519,6 +1613,52 @@ async function checklist(question, choices, { initial = new Set, min = 0, toggle
   });
   return accepted ? checked : undefined;
 }
+async function confirm(question, { default: fallback, ...settings } = {}) {
+  let answered = fallback;
+  const choices = { true: "Y/n", false: "y/N", undefined: "y/n" }[String(fallback)];
+  const accepted = await ask(question, settings, (colors, state) => [state === "asking" ? asking(colors, question, "", choices) : answer(colors, question, state, answered ? "yes" : "no")], (key) => {
+    if (key === "cancel")
+      return "cancel";
+    if (key === "enter")
+      return answered === undefined ? undefined : "enter";
+    const letter = typeof key === "object" ? key.text.toLowerCase() : "";
+    if (letter !== "y" && letter !== "n")
+      return;
+    answered = letter === "y";
+    return "enter";
+  });
+  return accepted ? answered : 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 = "";
@@ -1577,9 +1717,9 @@ function asking(colors, question, typed, keys) {
 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 = process12 }, render, press) {
+async function ask(question, { hint, terminal = process15 }, render, press) {
   const { stdin, stderr } = terminal;
-  if (stdin.isTTY !== true || stderr.isTTY !== true)
+  if (!isInteractive(terminal))
     fail(`cannot ask "${question}" off a terminal`, 2, hint);
   const colors = paint(stderr);
   let drawn = 0;
@@ -1629,18 +1769,19 @@ async function ask(question, { hint, terminal = process12 }, render, press) {
 
 // src/install.ts
 var HOOKS = "hooks";
+var PLUGIN_UNINSTALL = ["claude", "plugin", "uninstall", "cli-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 packages = Object.entries(TOOLS).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] };
+    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], installed: isInstalled(host, name) };
   });
   const { plugin, mod } = hooksWiring(host);
-  if (plugin || mod !== undefined)
+  if (mod !== undefined && !plugin)
     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] }];
+  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], installed: plugin }];
 }
 function choose(pool, names) {
   const chosen = new Set;
@@ -1677,16 +1818,33 @@ function plan(host, picked, force) {
 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 (process13.stdin.isTTY !== true || process13.stderr.isTTY !== true)
+async function ask2(all) {
+  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];
+  const choices = all.map((each) => ({ value: each, label: each.label, hint: `${each.installed ? "installed, " : ""}${each.hint}` }));
+  const picked = await checklist("installed packages", choices, { initial: new Set(all.filter((each) => each.installed)), hint: "check to install, uncheck to remove: doctor --install forgejo check names them" });
+  if (picked === undefined)
+    return;
+  const remove = all.filter((each) => !picked.has(each) && each.installed);
+  if (remove.length > 0 && await confirm(`remove ${remove.map((each) => each.label).join(", ")}?`, { default: false }) !== true)
+    return { add: all.filter((each) => picked.has(each) && !each.installed), remove: [] };
+  return { add: all.filter((each) => picked.has(each) && !each.installed), remove };
+}
+function removal(all, remove) {
+  const keepsGuard = all.some((each) => each.id === HOOKS && each.installed && !remove.includes(each));
+  return { packages: [...new Set(remove.flatMap((each) => each.id === HOOKS ? [] : each.packages))].filter((name) => !(keepsGuard && name === HOOKS_REQUIRES)), plugin: remove.some((each) => each.id === HOOKS) };
 }
-async function install(host, options, recheck) {
-  const pool = candidates2(host);
-  const { dim, green, red, yellow } = paint(process13.stdout);
+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, choosing = ask2) {
+  const all = candidates2(host);
+  const pool = all.filter((each) => !each.installed);
+  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)}`);
@@ -1694,20 +1852,23 @@ async function install(host, options, recheck) {
       console.log("everything is installed");
     return 0;
   }
-  if (pool.length === 0) {
+  if (pool.length === 0 && options.names.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)));
+  const unknown = options.names.filter((name) => name !== "all" && !all.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 chosen = options.names.length === 0 ? await choosing(all) : { add: choose(pool, options.names), remove: [] };
+  const picked = chosen?.add ?? [];
   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) {
+  const removing = removal(all, chosen?.remove ?? []);
+  const removes = removing.packages.length > 0 || removing.plugin;
+  if (picked.length === 0 && !removes) {
     if (skipped.length === 0)
-      console.log("nothing picked");
+      console.log("nothing changed");
     return 0;
   }
   const planned = plan(host, picked, options.force);
@@ -1715,13 +1876,20 @@ async function install(host, options, recheck) {
     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)
+  if (planned.packages.length === 0 && !planned.plugin && !removes)
     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(" ")}`);
+  const uninstall = ["bun", "remove", "-g", ...removing.packages];
+  if (removing.packages.length > 0)
+    console.log(`${options.dryRun ? dim("would  ") : green("remove ")}  ${uninstall.join(" ")}`);
+  if (removing.plugin)
+    console.log(`${options.dryRun ? dim("would  ") : green("remove ")}  ${PLUGIN_UNINSTALL.join(" ")}`);
   if (options.dryRun)
     return planned.blocked.length > 0 ? 1 : 0;
   if (planned.packages.length > 0) {
@@ -1740,16 +1908,23 @@ async function install(host, options, recheck) {
         console.error(`${red("failed")}   ${PLUGIN_INSTALL.join(" ")}: exit ${ran.code}: ${firstLine(ran.stderr || ran.stdout)}`);
     }
   }
+  if (removing.packages.length > 0) {
+    const ran = await host.run(uninstall);
+    if (ran.code !== 0) {
+      console.error(`${red("failed")}   bun remove -g: exit ${ran.code}: ${firstLine(ran.stderr || ran.stdout)}`);
+      return 1;
+    }
+  }
+  if (removing.plugin && host.which("claude") !== null) {
+    const ran = await host.run(PLUGIN_UNINSTALL);
+    if (ran.code !== 0)
+      console.error(`${red("failed")}   ${PLUGIN_UNINSTALL.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 | --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
@@ -1766,14 +1941,14 @@ var OPTIONS = {
   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 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" },
+  install: { type: "boolean", description: "install the packages named, or managed from a checklist, installed ones checked and unchecking removing them: 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(process14.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}`}`);
@@ -1783,13 +1958,13 @@ function print(results) {
 ${dim("fix them all:")} ${INSTALL2}${installs.join(" ")}`);
 }
 function printOutcomes(outcomes, log) {
-  const { green, red, dim } = paint(process14.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, 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 { 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", "check to install, uncheck to remove"], ["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");
@@ -1823,9 +1998,9 @@ after the fixes:`);
   const absent = Object.keys(TOOLS).filter((name) => !isInstalled(host, name)).length;
   if (!json && only.length === 0 && absent > 0)
     console.log(`
-${paint(process14.stdout).dim(`${absent} packages not installed: doctor --install`)}`);
+${paint(process17.stdout).dim(`${absent} packages not installed: doctor --install`)}`);
   return results.every((result) => result.ok) ? 0 : 1;
 }
 
 // src/cli.ts
-process15.exitCode = await runMain({ name: "doctor", run: async (args) => main(args) });
+process18.exitCode = await runMain({ name: "doctor", run: async (args) => main(args) });