@dosu/cli 0.29.1 → 0.31.0

package/bin/dosu.js

@@ -4577,7 +4577,7 @@ var init_dist4 = __esm(() => {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.29.1", INSTALL_CHANNEL = "npm";
+var VERSION = "0.31.0", INSTALL_CHANNEL = "npm";
 
 // src/debug/logger.ts
 import {
@@ -4711,7 +4711,7 @@ var init_logger = __esm(() => {
 });
 
 // src/client/contract.ts
-var CLI_CONTRACT_HASH = "8d9ba113842a";
+var CLI_CONTRACT_HASH = "f5c0727a7884";
 
 // src/client/trpc.ts
 var exports_trpc = {};
@@ -6961,6 +6961,10 @@ var init_installation_server = __esm(() => {
 function dim(msg) {
   return import_picocolors7.default.dim(msg);
 }
+function browserFallbackHint(url) {
+  return dim(`If your browser doesn't open automatically, visit:
+${url}`);
+}
 function info(msg) {
   return import_picocolors7.default.cyan(msg);
 }
@@ -7722,6 +7726,7 @@ async function openGitHubInstallFlow(onInstalled, opts) {
     middleURL.searchParams.set("callback", callbackURL);
     log.info(`Opening your browser to GitHub.
 ` + "Add repositories or install the Dosu GitHub App, and we'll pick up automatically.");
+    log.message(browserFallbackHint(middleURL.toString()));
     try {
       const open2 = await Promise.resolve().then(() => (init_open(), exports_open));
       await open2.default(middleURL.toString());
@@ -8328,7 +8333,7 @@ var require_cjs = __commonJS((exports) => {
 var require_lib = __commonJS((exports, module) => {
   var __filename = "/home/runner/work/dosu-cli/dosu-cli/node_modules/write-file-atomic/lib/index.js";
   module.exports = writeFile;
-  module.exports.sync = writeFileSync5;
+  module.exports.sync = writeFileSync6;
   module.exports._getTmpname = getTmpname;
   module.exports._cleanupOnExit = cleanupOnExit;
   var fs7 = __require("fs");
@@ -8461,7 +8466,7 @@ var require_lib = __commonJS((exports, module) => {
     }
     return promise;
   }
-  function writeFileSync5(filename, data, options) {
+  function writeFileSync6(filename, data, options) {
     if (typeof options === "string") {
       options = { encoding: options };
     } else if (!options) {
@@ -8538,7 +8543,7 @@ var require_lib = __commonJS((exports, module) => {
 
 // src/mcp/config-helpers.ts
 import { existsSync as existsSync6, mkdirSync as mkdirSync5, readFileSync as readFileSync7 } from "node:fs";
-import { dirname as dirname2 } from "node:path";
+import { dirname as dirname3 } from "node:path";
 function mcpURL(deploymentID) {
   return `${getBackendURL()}/v1/mcp/deployments/${deploymentID}`;
 }
@@ -8616,7 +8621,7 @@ function saveJSONConfig(path3, cfg) {
   writeSecureFile(path3, JSON.stringify(cfg, null, 2));
 }
 function writeSecureFile(path3, content) {
-  const dir = dirname2(path3);
+  const dir = dirname3(path3);
   if (!existsSync6(dir)) {
     mkdirSync5(dir, { recursive: true, mode: 448 });
   }
@@ -8658,6 +8663,57 @@ var init_config_helpers = __esm(() => {
   writeFileAtomic = import_write_file_atomic.default;
 });
 
+// src/hooks/runtime.ts
+var exports_runtime = {};
+__export(exports_runtime, {
+  resolveHookCommandPrefix: () => resolveHookCommandPrefix,
+  materializedRuntimePath: () => materializedRuntimePath,
+  dosuOnPath: () => dosuOnPath
+});
+import { spawnSync } from "node:child_process";
+import { copyFileSync, existsSync as existsSync7, mkdirSync as mkdirSync6 } from "node:fs";
+import { dirname as dirname4, join as join6 } from "node:path";
+function dosuOnPath() {
+  const cmd = process.platform === "win32" ? "where" : "which";
+  try {
+    return spawnSync(cmd, ["dosu"], { stdio: "ignore" }).status === 0;
+  } catch {
+    return false;
+  }
+}
+function materializedRuntimePath() {
+  return join6(getConfigDir(), "bin", "dosu.js");
+}
+function currentBundlePath() {
+  const entry = process.argv[1];
+  if (!entry || !/\.(c|m)?js$/.test(entry) || !existsSync7(entry))
+    return null;
+  return entry;
+}
+function resolveHookCommandPrefix() {
+  if (dosuOnPath())
+    return "dosu";
+  const bundle = currentBundlePath();
+  if (!bundle) {
+    logger.warn("hooks", "dosu not on PATH and no bundle to materialize; using bare 'dosu'");
+    return "dosu";
+  }
+  const target = materializedRuntimePath();
+  try {
+    mkdirSync6(dirname4(target), { recursive: true, mode: 448 });
+    copyFileSync(bundle, target);
+  } catch (err) {
+    logger.warn("hooks", `failed to materialize runtime: ${err instanceof Error ? err.message : String(err)}`);
+    return "dosu";
+  }
+  logger.info("hooks", `materialized hook runtime at ${target}`);
+  return `node "${target}"`;
+}
+var init_runtime = __esm(() => {
+  init_config();
+  init_logger();
+});
+
 // src/hooks/claude-code.ts
 var exports_claude_code = {};
 __export(exports_claude_code, {
@@ -8669,13 +8725,13 @@ __export(exports_claude_code, {
   claudeLocalSettingsPath: () => claudeLocalSettingsPath,
   DEFAULT_HOOK_EVENTS: () => DEFAULT_HOOK_EVENTS
 });
-import { existsSync as existsSync7, readFileSync as readFileSync8 } from "node:fs";
-import { join as join6 } from "node:path";
+import { existsSync as existsSync8, readFileSync as readFileSync8 } from "node:fs";
+import { join as join7 } from "node:path";
 function claudeLocalSettingsPath(dir) {
-  return join6(dir, ".claude", "settings.local.json");
+  return join7(dir, ".claude", "settings.local.json");
 }
-function hookCommand(subcommand) {
-  return `dosu hooks ${subcommand}`;
+function hookCommand(subcommand, prefix = resolveHookCommandPrefix()) {
+  return `${prefix} hooks ${subcommand}`;
 }
 function dosuGroup(event) {
   const entry = {
@@ -8690,6 +8746,9 @@ function isDosuHookCommand(command) {
     return false;
   if (/@dosu\/cli/.test(command))
     return true;
+  if (/^([^\s]*[/\\])?node(\.exe)?\s+("[^"]*dosu\.(c|m)?js"|[^\s]*dosu\.(c|m)?js)\s/.test(command.trimStart())) {
+    return true;
+  }
   return /^([^\s]*\/)?dosu\s/.test(command.trimStart());
 }
 function isDosuGroup(group) {
@@ -8701,7 +8760,7 @@ function isDosuGroup(group) {
   return hooks.some((h2) => !!h2 && typeof h2 === "object" && (h2[MARKER] === true || typeof h2.command === "string" && isDosuHookCommand(h2.command)));
 }
 function readSettingsOrThrow(path3) {
-  if (!existsSync7(path3))
+  if (!existsSync8(path3))
     return {};
   const raw = readFileSync8(path3, "utf-8").trim();
   if (!raw)
@@ -8763,7 +8822,7 @@ function removeClaudeHooks(configPath) {
   return { removed };
 }
 function inspectClaudeHooks(configPath) {
-  if (!existsSync7(configPath))
+  if (!existsSync8(configPath))
     return { fileExists: false, parseError: false, events: [] };
   let cfg;
   try {
@@ -8778,6 +8837,7 @@ function inspectClaudeHooks(configPath) {
 var DEFAULT_HOOK_EVENTS, MARKER = "__dosu", EVENT_SUBCOMMAND;
 var init_claude_code = __esm(() => {
   init_config_helpers();
+  init_runtime();
   DEFAULT_HOOK_EVENTS = ["UserPromptSubmit", "PostToolUse", "Stop"];
   EVENT_SUBCOMMAND = {
     UserPromptSubmit: "user-prompt-submit",
@@ -8795,13 +8855,13 @@ __export(exports_codex, {
   codexHooksPath: () => codexHooksPath,
   codexHookCommand: () => codexHookCommand
 });
-import { existsSync as existsSync8, readFileSync as readFileSync9 } from "node:fs";
-import { join as join7 } from "node:path";
+import { existsSync as existsSync9, readFileSync as readFileSync9 } from "node:fs";
+import { join as join8 } from "node:path";
 function codexHooksPath(dir) {
-  return join7(dir, ".codex", "hooks.json");
+  return join8(dir, ".codex", "hooks.json");
 }
-function codexHookCommand(subcommand) {
-  return `dosu hooks ${subcommand} --agent codex`;
+function codexHookCommand(subcommand, prefix = resolveHookCommandPrefix()) {
+  return `${prefix} hooks ${subcommand} --agent codex`;
 }
 function dosuGroup2(event) {
   return {
@@ -8816,7 +8876,7 @@ function dosuGroup2(event) {
   };
 }
 function readHooksFileOrThrow(path3) {
-  if (!existsSync8(path3))
+  if (!existsSync9(path3))
     return {};
   const raw = readFileSync9(path3, "utf-8").trim();
   if (!raw)
@@ -8851,7 +8911,7 @@ function installCodexHooks(configPath, opts = {}) {
   return { events: [...events] };
 }
 function removeCodexHooks(configPath) {
-  if (!existsSync8(configPath))
+  if (!existsSync9(configPath))
     return { removed: false };
   let config;
   try {
@@ -8880,7 +8940,7 @@ function removeCodexHooks(configPath) {
   return { removed };
 }
 function inspectCodexHooks(configPath) {
-  if (!existsSync8(configPath))
+  if (!existsSync9(configPath))
     return { fileExists: false, events: [] };
   let config;
   try {
@@ -8898,6 +8958,7 @@ var EVENT_SUBCOMMAND2, EVENT_TIMEOUT_SEC, EVENT_STATUS_MESSAGE;
 var init_codex = __esm(() => {
   init_config_helpers();
   init_claude_code();
+  init_runtime();
   EVENT_SUBCOMMAND2 = {
     UserPromptSubmit: "user-prompt-submit",
     PostToolUse: "post-tool-use",
@@ -8924,13 +8985,13 @@ __export(exports_factory, {
   factoryHooksPath: () => factoryHooksPath,
   factoryHookCommand: () => factoryHookCommand
 });
-import { existsSync as existsSync9, readFileSync as readFileSync10 } from "node:fs";
-import { join as join8 } from "node:path";
+import { existsSync as existsSync10, readFileSync as readFileSync10 } from "node:fs";
+import { join as join9 } from "node:path";
 function factoryHooksPath(dir) {
-  return join8(dir, ".factory", "hooks.json");
+  return join9(dir, ".factory", "hooks.json");
 }
-function factoryHookCommand(subcommand) {
-  return `dosu hooks ${subcommand} --agent factory`;
+function factoryHookCommand(subcommand, prefix = resolveHookCommandPrefix()) {
+  return `${prefix} hooks ${subcommand} --agent factory`;
 }
 function dosuGroup3(event) {
   const group = {
@@ -8941,7 +9002,7 @@ function dosuGroup3(event) {
   return group;
 }
 function readHooksFileOrThrow2(path3) {
-  if (!existsSync9(path3))
+  if (!existsSync10(path3))
     return {};
   const raw = readFileSync10(path3, "utf-8").trim();
   if (!raw)
@@ -8976,7 +9037,7 @@ function installFactoryHooks(configPath, opts = {}) {
   return { events: [...events] };
 }
 function removeFactoryHooks(configPath) {
-  if (!existsSync9(configPath))
+  if (!existsSync10(configPath))
     return { removed: false };
   let config;
   try {
@@ -9005,7 +9066,7 @@ function removeFactoryHooks(configPath) {
   return { removed };
 }
 function inspectFactoryHooks(configPath) {
-  if (!existsSync9(configPath))
+  if (!existsSync10(configPath))
     return { fileExists: false, events: [] };
   let config;
   try {
@@ -9023,6 +9084,7 @@ var EVENT_SUBCOMMAND3;
 var init_factory = __esm(() => {
   init_config_helpers();
   init_claude_code();
+  init_runtime();
   EVENT_SUBCOMMAND3 = {
     UserPromptSubmit: "user-prompt-submit",
     PostToolUse: "post-tool-use",
@@ -10118,15 +10180,15 @@ var init_insights2 = __esm(() => {
 });
 
 // src/version/skill-update-check.ts
-import { existsSync as existsSync10, mkdirSync as mkdirSync6, readFileSync as readFileSync12, writeFileSync as writeFileSync5 } from "node:fs";
-import { join as join9 } from "node:path";
+import { existsSync as existsSync12, mkdirSync as mkdirSync7, readFileSync as readFileSync12, writeFileSync as writeFileSync6 } from "node:fs";
+import { join as join10 } from "node:path";
 function getCachePath2() {
-  return join9(getConfigDir(), CACHE_FILENAME2);
+  return join10(getConfigDir(), CACHE_FILENAME2);
 }
 function readSkillCache() {
   try {
     const path3 = getCachePath2();
-    if (!existsSync10(path3))
+    if (!existsSync12(path3))
       return null;
     const data = JSON.parse(readFileSync12(path3, "utf-8"));
     if (typeof data.lastCheck === "number" && typeof data.latestSha === "string" && typeof data.installedSha === "string") {
@@ -10140,10 +10202,10 @@ function readSkillCache() {
 function writeSkillCache(cache) {
   try {
     const dir = getConfigDir();
-    if (!existsSync10(dir)) {
-      mkdirSync6(dir, { recursive: true, mode: 448 });
+    if (!existsSync12(dir)) {
+      mkdirSync7(dir, { recursive: true, mode: 448 });
     }
-    writeFileSync5(getCachePath2(), JSON.stringify(cache), { mode: 384 });
+    writeFileSync6(getCachePath2(), JSON.stringify(cache), { mode: 384 });
   } catch {}
 }
 async function fetchLatestSha() {
@@ -10168,19 +10230,6 @@ async function fetchLatestSha() {
     clearTimeout(timeout);
   }
 }
-async function refreshInstalledSha() {
-  const sha = await fetchLatestSha();
-  if (!sha) {
-    logger.debug("skill-update-check", "Failed to fetch latest SHA during refresh");
-    return;
-  }
-  writeSkillCache({
-    lastCheck: Date.now(),
-    latestSha: sha,
-    installedSha: sha
-  });
-  logger.debug("skill-update-check", `Refreshed installedSha=${sha}`);
-}
 function displayNotice() {
   const msg = `
 ${import_picocolors12.default.yellow("  Dosu skill update available")}
@@ -10278,16 +10327,12 @@ Failed to remove skill.`));
   });
   cmd.command("update").description("Update the Dosu skill to the latest version").action(async () => {
     console.log(`Updating ${SKILL_NAME} skill...`);
-    try {
-      execSync2(`npx skills update ${SKILL_NAME} -g`, {
-        stdio: "inherit"
-      });
-    } catch {
+    const result = await installSkill();
+    if (!result.success) {
       console.error(import_picocolors13.default.red(`
 Failed to update skill.`));
       process.exit(1);
     }
-    await refreshInstalledSha();
     console.log(import_picocolors13.default.green(`
 ✓ Skill "${SKILL_NAME}" updated.`));
   });
@@ -10317,21 +10362,21 @@ var init_skill = __esm(() => {
 var MCP_PROVIDER_SLUG = "dosu_mcp";
 
 // src/mcp/detect.ts
-import { existsSync as existsSync11 } from "node:fs";
+import { existsSync as existsSync13 } from "node:fs";
 import { homedir, platform as platform2 } from "node:os";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 function isInstalled(paths) {
-  return paths.some((p2) => existsSync11(expandHome(p2)));
+  return paths.some((p2) => existsSync13(expandHome(p2)));
 }
 function expandHome(path3) {
   if (!path3.startsWith("~"))
     return path3;
-  return join10(homedir(), path3.slice(1));
+  return join11(homedir(), path3.slice(1));
 }
 function appSupportDir() {
   switch (platform2()) {
     case "darwin": {
-      return join10(homedir(), "Library", "Application Support");
+      return join11(homedir(), "Library", "Application Support");
     }
     case "win32": {
       return process.env.APPDATA ?? "";
@@ -10340,7 +10385,7 @@ function appSupportDir() {
       const xdg = process.env.XDG_CONFIG_HOME;
       if (xdg)
         return xdg;
-      return join10(homedir(), ".config");
+      return join11(homedir(), ".config");
     }
   }
 }
@@ -10421,7 +10466,7 @@ var init_antigravity = __esm(() => {
 });
 
 // src/mcp/providers/claude.ts
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 var ClaudeProvider = () => createJSONProvider({
   providerName: "Claude Code",
   providerID: "claude",
@@ -10430,22 +10475,22 @@ var ClaudeProvider = () => createJSONProvider({
   paths: ["~/.claude"],
   globalPath: "~/.claude.json",
   topKey: "mcpServers",
-  localConfigPath: (cwd) => join11(cwd, ".mcp.json")
+  localConfigPath: (cwd) => join12(cwd, ".mcp.json")
 });
 var init_claude = __esm(() => {
   init_base();
 });
 
 // src/mcp/providers/claude-desktop.ts
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 var ClaudeDesktopProvider = () => ({
   name: () => "Claude Desktop",
   id: () => "claude-desktop",
   supportsLocal: () => false,
   priority: () => 2,
-  detectPaths: () => [join12(appSupportDir(), "Claude")],
-  isInstalled: () => isInstalled([join12(appSupportDir(), "Claude")]),
-  globalConfigPath: () => join12(appSupportDir(), "Claude", "claude_desktop_config.json"),
+  detectPaths: () => [join13(appSupportDir(), "Claude")],
+  isInstalled: () => isInstalled([join13(appSupportDir(), "Claude")]),
+  globalConfigPath: () => join13(appSupportDir(), "Claude", "claude_desktop_config.json"),
   isConfigured: () => false,
   install() {
     throw new Error("this tool only supports local (stdio) servers and cannot be configured for remote MCP");
@@ -10459,14 +10504,14 @@ var init_claude_desktop = __esm(() => {
 });
 
 // src/mcp/providers/cline.ts
-import { join as join13 } from "node:path";
-var extensionDir = () => join13(appSupportDir(), "Code", "User", "globalStorage", "saoudrizwan.claude-dev"), ClineProvider = () => createJSONProvider({
+import { join as join14 } from "node:path";
+var extensionDir = () => join14(appSupportDir(), "Code", "User", "globalStorage", "saoudrizwan.claude-dev"), ClineProvider = () => createJSONProvider({
   providerName: "Cline",
   providerID: "cline",
   local: false,
   priorityValue: 11,
   paths: [extensionDir()],
-  globalPath: join13(extensionDir(), "settings", "cline_mcp_settings.json"),
+  globalPath: join14(extensionDir(), "settings", "cline_mcp_settings.json"),
   topKey: "mcpServers",
   buildServer: (cfg) => ({
     url: mcpURL(cfg.deployment_id),
@@ -10482,7 +10527,7 @@ var init_cline = __esm(() => {
 });
 
 // src/mcp/providers/cline-cli.ts
-import { join as join14 } from "node:path";
+import { join as join15 } from "node:path";
 function clineDir() {
   return process.env.CLINE_DIR ?? expandHome("~/.cline");
 }
@@ -10492,7 +10537,7 @@ var ClineCliProvider = () => createJSONProvider({
   local: false,
   priorityValue: 12,
   paths: [clineDir()],
-  globalPath: join14(clineDir(), "data", "settings", "cline_mcp_settings.json"),
+  globalPath: join15(clineDir(), "data", "settings", "cline_mcp_settings.json"),
   topKey: "mcpServers",
   buildServer: (cfg) => ({
     url: mcpURL(cfg.deployment_id),
@@ -10508,18 +10553,18 @@ var init_cline_cli = __esm(() => {
 });
 
 // src/mcp/providers/codex.ts
-import { existsSync as existsSync12, readFileSync as readFileSync13 } from "node:fs";
-import { join as join15 } from "node:path";
+import { existsSync as existsSync14, readFileSync as readFileSync13 } from "node:fs";
+import { join as join16 } from "node:path";
 function codexHome() {
   return process.env.CODEX_HOME ?? expandHome("~/.codex");
 }
 function getConfigPath2(global) {
   if (global)
-    return join15(codexHome(), "config.toml");
-  return join15(process.cwd(), ".codex", "config.toml");
+    return join16(codexHome(), "config.toml");
+  return join16(process.cwd(), ".codex", "config.toml");
 }
 function readTOML(path3) {
-  if (!existsSync12(path3))
+  if (!existsSync14(path3))
     return "";
   return readFileSync13(path3, "utf-8");
 }
@@ -10579,9 +10624,9 @@ var CodexProvider = () => ({
   priority: () => 8,
   detectPaths: () => ["~/.codex"],
   isInstalled: () => isInstalled(["~/.codex"]),
-  globalConfigPath: () => join15(codexHome(), "config.toml"),
+  globalConfigPath: () => join16(codexHome(), "config.toml"),
   isConfigured: () => {
-    const content = readTOML(join15(codexHome(), "config.toml"));
+    const content = readTOML(join16(codexHome(), "config.toml"));
     return content.includes("[mcp_servers.dosu]");
   },
   install(cfg, global) {
@@ -10603,10 +10648,10 @@ var init_codex2 = __esm(() => {
 });
 
 // src/mcp/providers/copilot.ts
-import { join as join16 } from "node:path";
+import { join as join17 } from "node:path";
 function globalPath() {
   if (process.env.XDG_CONFIG_HOME) {
-    return join16(process.env.XDG_CONFIG_HOME, "mcp-config.json");
+    return join17(process.env.XDG_CONFIG_HOME, "mcp-config.json");
   }
   return expandHome("~/.copilot/mcp-config.json");
 }
@@ -10637,7 +10682,7 @@ var CopilotProvider = () => ({
       };
       installJSONServer(globalPath(), "mcpServers", server);
     } else {
-      const configPath = join16(process.cwd(), ".vscode", "mcp.json");
+      const configPath = join17(process.cwd(), ".vscode", "mcp.json");
       const server = {
         type: "http",
         url,
@@ -10650,7 +10695,7 @@ var CopilotProvider = () => ({
     if (global) {
       removeJSONServer(globalPath(), "mcpServers");
     } else {
-      const configPath = join16(process.cwd(), ".vscode", "mcp.json");
+      const configPath = join17(process.cwd(), ".vscode", "mcp.json");
       removeJSONServer(configPath, "servers");
     }
   }
@@ -10662,7 +10707,7 @@ var init_copilot = __esm(() => {
 });
 
 // src/mcp/providers/cursor.ts
-import { join as join17 } from "node:path";
+import { join as join18 } from "node:path";
 var CursorProvider = () => createJSONProvider({
   providerName: "Cursor",
   providerID: "cursor",
@@ -10675,7 +10720,7 @@ var CursorProvider = () => createJSONProvider({
     url: mcpURL(cfg.deployment_id),
     headers: mcpHeaders(cfg.api_key)
   }),
-  localConfigPath: (cwd) => join17(cwd, ".cursor", "mcp.json")
+  localConfigPath: (cwd) => join18(cwd, ".cursor", "mcp.json")
 });
 var init_cursor = __esm(() => {
   init_config_helpers();
@@ -10683,7 +10728,7 @@ var init_cursor = __esm(() => {
 });
 
 // src/mcp/providers/factory.ts
-import { join as join18 } from "node:path";
+import { join as join19 } from "node:path";
 var FactoryProvider = () => createJSONProvider({
   providerName: "Factory",
   providerID: "factory",
@@ -10692,14 +10737,14 @@ var FactoryProvider = () => createJSONProvider({
   paths: ["~/.factory"],
   globalPath: "~/.factory/mcp.json",
   topKey: "mcpServers",
-  localConfigPath: (cwd) => join18(cwd, ".factory", "mcp.json")
+  localConfigPath: (cwd) => join19(cwd, ".factory", "mcp.json")
 });
 var init_factory2 = __esm(() => {
   init_base();
 });
 
 // src/mcp/providers/gemini.ts
-import { join as join19 } from "node:path";
+import { join as join20 } from "node:path";
 var GeminiProvider = () => createJSONProvider({
   providerName: "Gemini CLI",
   providerID: "gemini",
@@ -10708,7 +10753,7 @@ var GeminiProvider = () => createJSONProvider({
   paths: ["~/.gemini"],
   globalPath: "~/.gemini/settings.json",
   topKey: "mcpServers",
-  localConfigPath: (cwd) => join19(cwd, ".gemini", "settings.json")
+  localConfigPath: (cwd) => join20(cwd, ".gemini", "settings.json")
 });
 var init_gemini = __esm(() => {
   init_base();
@@ -10758,14 +10803,14 @@ var init_manual = __esm(() => {
 });
 
 // src/mcp/providers/mcporter.ts
-import { existsSync as existsSync13 } from "node:fs";
-import { join as join20 } from "node:path";
+import { existsSync as existsSync15 } from "node:fs";
+import { join as join21 } from "node:path";
 function resolveGlobalConfigPath() {
   const jsonPath = expandHome("~/.mcporter/mcporter.json");
-  if (existsSync13(jsonPath))
+  if (existsSync15(jsonPath))
     return jsonPath;
   const jsoncPath = expandHome("~/.mcporter/mcporter.jsonc");
-  if (existsSync13(jsoncPath))
+  if (existsSync15(jsoncPath))
     return jsoncPath;
   return jsonPath;
 }
@@ -10786,7 +10831,7 @@ var MCPorterProvider = () => ({
   globalConfigPath: () => resolveGlobalConfigPath(),
   isConfigured: () => isJSONKeyConfigured(resolveGlobalConfigPath(), "mcpServers"),
   install(cfg, global) {
-    const configPath = global ? resolveGlobalConfigPath() : join20(process.cwd(), "config", "mcporter.json");
+    const configPath = global ? resolveGlobalConfigPath() : join21(process.cwd(), "config", "mcporter.json");
     const server = {
       type: "http",
       url: mcpEndpoint4(cfg),
@@ -10795,7 +10840,7 @@ var MCPorterProvider = () => ({
     installJSONServer(configPath, "mcpServers", server);
   },
   remove(global) {
-    const configPath = global ? resolveGlobalConfigPath() : join20(process.cwd(), "config", "mcporter.json");
+    const configPath = global ? resolveGlobalConfigPath() : join21(process.cwd(), "config", "mcporter.json");
     removeJSONServer(configPath, "mcpServers");
   }
 });
@@ -10806,7 +10851,7 @@ var init_mcporter = __esm(() => {
 });
 
 // src/mcp/providers/opencode.ts
-import { join as join21 } from "node:path";
+import { join as join22 } from "node:path";
 var OpenCodeProvider = () => createJSONProvider({
   providerName: "OpenCode",
   providerID: "opencode",
@@ -10821,7 +10866,7 @@ var OpenCodeProvider = () => createJSONProvider({
     enabled: true,
     headers: mcpHeaders(cfg.api_key)
   }),
-  localConfigPath: (cwd) => join21(cwd, "opencode.json")
+  localConfigPath: (cwd) => join22(cwd, "opencode.json")
 });
 var init_opencode = __esm(() => {
   init_config_helpers();
@@ -10829,16 +10874,16 @@ var init_opencode = __esm(() => {
 });
 
 // src/mcp/providers/vscode.ts
-import { join as join22 } from "node:path";
+import { join as join23 } from "node:path";
 var VSCodeProvider = () => createJSONProvider({
   providerName: "VS Code",
   providerID: "vscode",
   local: true,
   priorityValue: 6,
-  paths: [join22(appSupportDir(), "Code")],
-  globalPath: join22(appSupportDir(), "Code", "User", "mcp.json"),
+  paths: [join23(appSupportDir(), "Code")],
+  globalPath: join23(appSupportDir(), "Code", "User", "mcp.json"),
   topKey: "servers",
-  localConfigPath: (cwd) => join22(cwd, ".vscode", "mcp.json")
+  localConfigPath: (cwd) => join23(cwd, ".vscode", "mcp.json")
 });
 var init_vscode = __esm(() => {
   init_detect();
@@ -10847,14 +10892,14 @@ var init_vscode = __esm(() => {
 
 // src/mcp/providers/windsurf.ts
 import { homedir as homedir2 } from "node:os";
-import { join as join23 } from "node:path";
+import { join as join24 } from "node:path";
 var WindsurfProvider = () => createJSONProvider({
   providerName: "Windsurf",
   providerID: "windsurf",
   local: false,
   priorityValue: 9,
-  paths: [join23(homedir2(), ".codeium", "windsurf")],
-  globalPath: join23(homedir2(), ".codeium", "windsurf", "mcp_config.json"),
+  paths: [join24(homedir2(), ".codeium", "windsurf")],
+  globalPath: join24(homedir2(), ".codeium", "windsurf", "mcp_config.json"),
   topKey: "mcpServers"
 });
 var init_windsurf = __esm(() => {
@@ -10863,12 +10908,12 @@ var init_windsurf = __esm(() => {
 
 // src/mcp/providers/zed.ts
 import { platform as platform3 } from "node:os";
-import { join as join24 } from "node:path";
+import { join as join25 } from "node:path";
 function zedConfigDir() {
   const os2 = platform3();
   if (os2 === "darwin" || os2 === "win32")
-    return join24(appSupportDir(), "Zed");
-  return join24(appSupportDir(), "zed");
+    return join25(appSupportDir(), "Zed");
+  return join25(appSupportDir(), "zed");
 }
 var ZedProvider = () => createJSONProvider({
   providerName: "Zed",
@@ -10876,7 +10921,7 @@ var ZedProvider = () => createJSONProvider({
   local: true,
   priorityValue: 10,
   paths: [zedConfigDir()],
-  globalPath: join24(zedConfigDir(), "settings.json"),
+  globalPath: join25(zedConfigDir(), "settings.json"),
   topKey: "context_servers",
   buildServer: (cfg) => ({
     source: "custom",
@@ -10884,7 +10929,7 @@ var ZedProvider = () => createJSONProvider({
     url: mcpURL(cfg.deployment_id),
     headers: mcpHeaders(cfg.api_key)
   }),
-  localConfigPath: (cwd) => join24(cwd, ".zed", "settings.json")
+  localConfigPath: (cwd) => join25(cwd, ".zed", "settings.json")
 });
 var init_zed = __esm(() => {
   init_config_helpers();
@@ -11027,6 +11072,74 @@ var init_analytics = __esm(() => {
   init_logger();
 });
 
+// src/setup/audit-handoff.ts
+import { spawnSync as spawnSync2 } from "node:child_process";
+function buildAuditHandoffPrompt(dosuCmd = dosuInvocation()) {
+  return [
+    "Audit this repository to see what docs Dosu can generate for it.",
+    "1. Run the codebase audit from the Dosu skill. It writes findings to .dosu/audit.json.",
+    "2. Show me the findings and which docs you recommend Dosu generate.",
+    `3. Once I confirm, run \`${dosuCmd} audit --tasks <comma-separated task ids> --json\` to kick off generation. Dosu opens a PR and the CLI notifies me when it's ready.`
+  ].join(`
+`);
+}
+function binOnPath(bin) {
+  const cmd = process.platform === "win32" ? "where" : "which";
+  try {
+    return spawnSync2(cmd, [bin], { stdio: "ignore" }).status === 0;
+  } catch {
+    return false;
+  }
+}
+function claudeCliAvailable() {
+  return binOnPath("claude");
+}
+function dosuInvocation() {
+  return binOnPath("dosu") ? "dosu" : "npx -y @dosu/cli";
+}
+function printManualAuditNudge() {
+  log.message(`See what docs Dosu can generate for this repo:
+
+${info("Ask Dosu to audit this repo and show what docs it can generate.")}
+
+Or run ${info(`${dosuInvocation()} audit`)} after your agent writes the audit.`);
+}
+async function offerAuditHandoff() {
+  if (!detectGitRepo())
+    return false;
+  if (!claudeCliAvailable()) {
+    printManualAuditNudge();
+    return false;
+  }
+  const go = await confirm({
+    message: "Kick off the codebase audit in Claude Code now?",
+    initialValue: true
+  });
+  if (isCancel(go) || !go) {
+    printManualAuditNudge();
+    return false;
+  }
+  return true;
+}
+function launchAuditAgent() {
+  logger.info("setup", "Handing off to Claude Code for the codebase audit");
+  const result = spawnSync2("claude", ["--model", AUDIT_AGENT_MODEL, buildAuditHandoffPrompt()], {
+    stdio: "inherit",
+    shell: process.platform === "win32"
+  });
+  if (result.error) {
+    logger.warn("setup", `Claude Code launch failed: ${result.error.message}`);
+    printManualAuditNudge();
+  }
+}
+var AUDIT_AGENT_MODEL = "haiku";
+var init_audit_handoff = __esm(() => {
+  init_dist8();
+  init_logger();
+  init_github_step();
+  init_styles();
+});
+
 // src/setup/github-doc-import-prompt.ts
 async function promptGitHubDocsImport({
   repositories
@@ -12004,7 +12117,7 @@ var exports_flow = {};
 __export(exports_flow, {
   startOAuthFlow: () => startOAuthFlow
 });
-async function startOAuthFlow(signal, path3 = "/cli/auth", params = {}) {
+async function startOAuthFlow(signal, path3 = "/cli/auth", params = {}, onAuthURL) {
   const { server, tokenPromise } = await startCallbackServer();
   let timeoutId;
   try {
@@ -12018,6 +12131,7 @@ async function startOAuthFlow(signal, path3 = "/cli/auth", params = {}) {
       await open2.default(authURL);
       browserOpened = true;
       logger.info("auth.flow", "Browser open command executed");
+      onAuthURL?.(authURL);
     } catch (openErr) {
       logger.warn("auth.flow", `Could not open browser automatically: ${openErr instanceof Error ? openErr.message : String(openErr)}`);
     }
@@ -12068,8 +12182,8 @@ __export(exports_flow2, {
   isStdioOnly: () => isStdioOnly
 });
 import { randomUUID } from "node:crypto";
-import { existsSync as existsSync14 } from "node:fs";
-import { join as join25 } from "node:path";
+import { existsSync as existsSync16 } from "node:fs";
+import { join as join26 } from "node:path";
 async function runSetup(opts = {}) {
   const onboardingRunID = randomUUID();
   logger.info("setup", `Setup flow started${opts.deploymentID ? ` deployment=${opts.deploymentID}` : ""}${opts.mode ? ` mode=${opts.mode}` : ""}`);
@@ -12237,12 +12351,16 @@ async function runSetup(opts = {}) {
       log.warn("Could not mark onboarding complete on the server — you can retry later by running `dosu setup` again.");
     }
   }
+  let handoffToAudit = false;
   if (mcpConfiguredThisRun) {
     showTryItOutPrompt({
       mode: cfg.mode,
       docsImported: choices.connectGitHub && githubOnboardingDone,
-      hasAgentsMd: existsSync14(join25(process.cwd(), "AGENTS.md"))
+      hasAgentsMd: existsSync16(join26(process.cwd(), "AGENTS.md"))
     });
+    if (cfg.mode !== MODE_OSS) {
+      handoffToAudit = await offerAuditHandoff();
+    }
   }
   if (mcpCompleted || skillCompleted || docsImported) {
     await trackCliOnboardingEvent(cfg, onboardingRunID, "cli_onboarding_completed", {
@@ -12256,6 +12374,9 @@ async function runSetup(opts = {}) {
   } else {
     outro("\uD83C\uDF89 Setup complete!");
   }
+  if (handoffToAudit) {
+    launchAuditAgent();
+  }
 }
 function applyDeployment(cfg, d) {
   cfg.deployment_id = d.deployment_id;
@@ -12382,8 +12503,10 @@ async function openBrowserForSetup(cfg, onboardingRunID) {
   try {
     const { startOAuthFlow: startOAuthFlow2 } = await Promise.resolve().then(() => (init_flow(), exports_flow));
     const s = spinner();
-    s.start("Waiting for authentication...");
-    const result = await startOAuthFlow2(undefined, "/cli/auth", onboardingRunID ? { onboarding_run_id: onboardingRunID } : {});
+    const result = await startOAuthFlow2(undefined, "/cli/auth", onboardingRunID ? { onboarding_run_id: onboardingRunID } : {}, (url) => {
+      log.message(browserFallbackHint(url));
+      s.start("Waiting for authentication...");
+    });
     if (!result.browserOpened) {
       s.stop("Could not open a browser");
       log.error("Run 'dosu login --no-browser' from the terminal to authenticate over SSH.");
@@ -12728,13 +12851,6 @@ function showTryItOutPrompt(opts = {}) {
   log.message(`Try it out! Paste this into your agent:
 
 ${info(prompt)}`);
-  if (opts.mode !== MODE_OSS) {
-    log.message(`See what docs Dosu can generate for this repo:
-
-${info("Ask Dosu to audit this repo and show what docs it can generate.")}
-
-Or run ${info("dosu audit")} after your agent writes the audit.`);
-  }
 }
 var init_flow2 = __esm(() => {
   init_dist8();
@@ -12744,12 +12860,13 @@ var init_flow2 = __esm(() => {
   init_logger();
   init_providers();
   init_analytics();
+  init_audit_handoff();
   init_styles();
 });
 
 // src/commands/insights.ts
-import { existsSync as existsSync15, mkdirSync as mkdirSync7, readdirSync, unlinkSync, writeFileSync as writeFileSync6 } from "node:fs";
-import { dirname as dirname3, join as join26 } from "node:path";
+import { existsSync as existsSync17, mkdirSync as mkdirSync8, readdirSync, unlinkSync, writeFileSync as writeFileSync7 } from "node:fs";
+import { dirname as dirname5, join as join27 } from "node:path";
 function shuffled(arr) {
   const copy2 = [...arr];
   for (let i2 = copy2.length - 1;i2 > 0; i2--) {
@@ -12853,17 +12970,17 @@ function makeAskFn(cfg) {
   };
 }
 function insightsDir() {
-  return join26(getConfigDir(), "insights");
+  return join27(getConfigDir(), "insights");
 }
 function reportPath(timestamp) {
   const dir = insightsDir();
   if (!timestamp)
-    return join26(dir, "latest.html");
+    return join27(dir, "latest.html");
   const iso = timestamp.toISOString().slice(0, 19).replace(/:/g, "-");
-  return join26(dir, `report-${iso}Z.html`);
+  return join27(dir, `report-${iso}Z.html`);
 }
 function pruneOldReports(dir, keepN) {
-  if (!existsSync15(dir))
+  if (!existsSync17(dir))
     return;
   let entries;
   try {
@@ -12875,7 +12992,7 @@ function pruneOldReports(dir, keepN) {
   const reports = entries.filter((f2) => REPORT_FILE_PATTERN.test(f2)).sort().reverse();
   for (const f2 of reports.slice(keepN)) {
     try {
-      unlinkSync(join26(dir, f2));
+      unlinkSync(join27(dir, f2));
     } catch (err) {
       logger.debug("insights", `failed to prune ${f2}: ${err instanceof Error ? err.message : err}`);
     }
@@ -12947,10 +13064,10 @@ function defaultRunner(cfg) {
     build: buildInsights,
     render: renderHTML,
     writeFile: (path3, content) => {
-      const dir = dirname3(path3);
-      if (!existsSync15(dir))
-        mkdirSync7(dir, { recursive: true, mode: 448 });
-      writeFileSync6(path3, content, { mode: 384 });
+      const dir = dirname5(path3);
+      if (!existsSync17(dir))
+        mkdirSync8(dir, { recursive: true, mode: 448 });
+      writeFileSync7(path3, content, { mode: 384 });
     },
     prune: pruneOldReports,
     openInBrowser: async (path3) => {
@@ -13094,8 +13211,10 @@ async function handleAuthenticate(cfg) {
   try {
     const { startOAuthFlow: startOAuthFlow2 } = await Promise.resolve().then(() => (init_flow(), exports_flow));
     const s = spinner();
-    s.start("Waiting for authentication...");
-    const result = await startOAuthFlow2(undefined, "/cli/auth");
+    const result = await startOAuthFlow2(undefined, "/cli/auth", {}, (url) => {
+      log.message(browserFallbackHint(url));
+      s.start("Waiting for authentication...");
+    });
     if (!result.browserOpened) {
       s.stop("Could not open a browser");
       log.error("Run 'dosu login --no-browser' from the terminal to authenticate over SSH.");
@@ -13147,6 +13266,7 @@ var init_tui = __esm(() => {
   init_insights3();
   init_config();
   init_flow2();
+  init_styles();
   import_picocolors26 = __toESM(require_picocolors(), 1);
 });
 
@@ -13889,8 +14009,8 @@ init_trpc();
 init_logger();
 init_github_step();
 var import_picocolors9 = __toESM(require_picocolors(), 1);
-import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
-import { join as join4 } from "node:path";
+import { existsSync as existsSync4, readFileSync as readFileSync4, rmSync, writeFileSync as writeFileSync4 } from "node:fs";
+import { dirname, join as join4 } from "node:path";
 
 // src/version/pending-tasks-check.ts
 init_config();
@@ -14174,6 +14294,33 @@ function loadFindings(findingsPath) {
   }
   return parsed;
 }
+function cleanupFindings(findingsPath, cwd = process.cwd()) {
+  const gitignorePath = join4(cwd, ".gitignore");
+  try {
+    const content = existsSync4(gitignorePath) ? readFileSync4(gitignorePath, "utf-8") : "";
+    const hasEntry = content.split(/\r?\n/).some((line) => /^\.dosu\/?$/.test(line.trim()));
+    if (!hasEntry) {
+      const sep = content === "" || content.endsWith(`
+`) ? "" : `
+`;
+      writeFileSync4(gitignorePath, `${content}${sep}.dosu/
+`);
+    }
+  } catch (err) {
+    logger.warn("audit", `could not update .gitignore: ${errText(err)}`);
+  }
+  const defaultDir = join4(cwd, ".dosu");
+  if (dirname(findingsPath) !== defaultDir)
+    return;
+  try {
+    rmSync(defaultDir, { recursive: true, force: true });
+  } catch (err) {
+    logger.warn("audit", `could not remove ${defaultDir}: ${errText(err)}`);
+  }
+}
+function errText(err) {
+  return err instanceof Error ? err.message : String(err);
+}
 function intersectActionable(items, capabilities) {
   const known = new Set(capabilities.map((c3) => c3.id));
   return items.filter((item) => known.has(item.task));
@@ -14182,9 +14329,21 @@ function isPreselected(item) {
   return item.can_help && item.action !== "skip";
 }
 function auditCommand() {
-  const cmd = new Command("audit").description("Generate docs from a coding-agent audit (.dosu/audit.json)").option("--data-source-id <id>", "Skip auto-match and use this data source ID").option("--findings <path>", "Path to the audit findings JSON").option("--tasks <ids>", "Comma-separated task ids to generate (non-interactive; for agent-driven use)").option("--yes", "Skip the prompt and select all suggested items").option("--json", "Output as JSON").action(async (opts) => {
+  const cmd = new Command("audit").description("Generate docs from a coding-agent audit (.dosu/audit.json)").option("--data-source-id <id>", "Skip auto-match and use this data source ID").option("--findings <path>", "Path to the audit findings JSON").option("--tasks <ids>", "Comma-separated task ids to generate (non-interactive; for agent-driven use)").option("--list-tasks", "List the doc-generation capabilities (valid task ids) and exit").option("--yes", "Skip the prompt and select all suggested items").option("--json", "Output as JSON").action(async (opts) => {
     const cfg = requireConfig3();
     const apiKey = requireAPIKey(cfg);
+    if (opts.listTasks) {
+      const resp = await backendGet("/v1/cli/tasks", apiKey);
+      const tasks = resp.tasks ?? [];
+      if (opts.json) {
+        printResult({ tasks }, opts);
+        return;
+      }
+      for (const t2 of tasks) {
+        console.log(`${t2.id}  ${import_picocolors9.default.dim(`(${t2.doc_type})`)}  ${t2.label} — ${t2.description}`);
+      }
+      return;
+    }
     const detected = detectGitRepo();
     if (!detected) {
       console.error(import_picocolors9.default.red("Not a GitHub repo. Run 'dosu audit' from a GitHub repository."));
@@ -14265,6 +14424,9 @@ function auditCommand() {
         repo: detected.slug
       });
     }
+    if (taskIds.length > 0) {
+      cleanupFindings(findingsPath);
+    }
     if (opts.json) {
       printResult({ task_ids: taskIds }, opts);
       return;
@@ -14761,13 +14923,13 @@ init_commander();
 init_config();
 init_logger();
 init_prompts();
-import { readFileSync as readFileSync11 } from "node:fs";
+import { existsSync as existsSync11, readFileSync as readFileSync11 } from "node:fs";
 import { basename } from "node:path";
 
 // src/hooks/state.ts
 init_config();
-import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync6, rmSync, writeFileSync as writeFileSync4 } from "node:fs";
-import { dirname, join as join5 } from "node:path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync6, rmSync as rmSync2, writeFileSync as writeFileSync5 } from "node:fs";
+import { dirname as dirname2, join as join5 } from "node:path";
 function getStateDir() {
   return process.env.DOSU_HOOK_STATE_DIR ?? join5(getConfigDir(), "hooks");
 }
@@ -14787,11 +14949,11 @@ function loadState(sessionId) {
 function saveState(state) {
   try {
     const file = stateFile(state.sessionId);
-    const dir = dirname(file);
+    const dir = dirname2(file);
     if (!existsSync5(dir)) {
       mkdirSync4(dir, { recursive: true, mode: 448 });
     }
-    writeFileSync4(file, JSON.stringify(state, null, 2), { mode: 384 });
+    writeFileSync5(file, JSON.stringify(state, null, 2), { mode: 384 });
   } catch {}
 }
 
@@ -15230,6 +15392,21 @@ async function collectDoctorChecks(opts) {
       });
     }
   }
+  if (hasSubmit && hasPostTool || alternativeInstalled) {
+    const { dosuOnPath: dosuOnPath2, materializedRuntimePath: materializedRuntimePath2 } = await Promise.resolve().then(() => (init_runtime(), exports_runtime));
+    const materialized = materializedRuntimePath2();
+    if (dosuOnPath2()) {
+      checks.push({ name: "runtime", status: "ok", detail: "dosu on PATH" });
+    } else if (existsSync11(materialized)) {
+      checks.push({ name: "runtime", status: "ok", detail: `materialized: ${materialized}` });
+    } else {
+      checks.push({
+        name: "runtime",
+        status: "fail",
+        detail: "dosu is not on PATH and no materialized runtime exists — re-run 'npx -y @dosu/cli hooks install <agent>'"
+      });
+    }
+  }
   const cfg = loadConfig();
   if (isAuthenticated(cfg)) {
     checks.push({ name: "auth", status: "ok", detail: "logged in" });
@@ -16173,7 +16350,7 @@ function suggestCommand() {
   return cmd;
 }
 
-// src/commands/tags.ts
+// src/commands/threads.ts
 init_commander();
 init_trpc();
 var import_picocolors23 = __toESM(require_picocolors(), 1);
@@ -16185,92 +16362,10 @@ function requireConfig13() {
   }
   return cfg;
 }
-async function getKnowledgeStoreId4(client, spaceId) {
-  const store = await client.knowledgeStore.getBySpaceId.query({
-    space_id: spaceId
-  });
-  if (!store) {
-    console.error(import_picocolors23.default.red("No knowledge store found for this deployment."));
-    process.exit(1);
-  }
-  return store.id;
-}
-function tagsCommand() {
-  const cmd = new Command("tags").description("Manage knowledge base tags");
-  cmd.command("list").description("List all tags").option("--json", "Output as JSON").action(async (opts) => {
-    const cfg = requireConfig13();
-    const client = createTypedClient(cfg);
-    const ksId = await getKnowledgeStoreId4(client, cfg.space_id);
-    const tags = await client.topic.listTopicsByKnowledgeStore.query({
-      knowledge_store_id: ksId
-    });
-    if (opts.json) {
-      printResult(tags, opts);
-      return;
-    }
-    if (!tags || tags.length === 0) {
-      console.log(import_picocolors23.default.dim("No tags found."));
-      return;
-    }
-    printTable(["ID", "Name", "Description"], tags.map((t2) => [
-      t2.topic_id.slice(0, 8),
-      t2.name,
-      t2.description ?? "—"
-    ]), { rawData: tags });
-  });
-  cmd.command("remove").description("Remove a tag from a page").argument("<tag-id>", "Tag ID").argument("<page-id>", "Page ID").option("--json", "Output as JSON").action(async (tagId, pageId, opts) => {
-    const cfg = requireConfig13();
-    const client = createTypedClient(cfg);
-    await client.topic.removeFromPage.mutate({ topic_id: tagId, page_id: pageId });
-    if (opts.json) {
-      printResult({ success: true, tag_id: tagId, page_id: pageId }, opts);
-      return;
-    }
-    console.log(import_picocolors23.default.green("Tag removed from page."));
-  });
-  cmd.command("pages").description("List pages with a specific tag").argument("<tag-id>", "Tag ID").option("--search <query>", "Search within tagged pages").option("--limit <n>", "Maximum results", "10").option("--json", "Output as JSON").action(async (tagId, opts) => {
-    const cfg = requireConfig13();
-    const client = createTypedClient(cfg);
-    const ksId = await getKnowledgeStoreId4(client, cfg.space_id);
-    const result = await client.topic.getPagesByTopicId.query({
-      knowledge_store_id: ksId,
-      topic_id: tagId,
-      searchTerm: opts.search,
-      limit: Number.parseInt(opts.limit ?? "10", 10)
-    });
-    const pages = result.data;
-    if (opts.json) {
-      printResult(pages, opts);
-      return;
-    }
-    if (!pages || pages.length === 0) {
-      console.log(import_picocolors23.default.dim("No pages found with this tag."));
-      return;
-    }
-    printTable(["ID", "Title"], pages.map((p2) => [
-      p2.id.slice(0, 8),
-      p2.title ?? "(untitled)"
-    ]), { rawData: pages });
-  });
-  return cmd;
-}
-
-// src/commands/threads.ts
-init_commander();
-init_trpc();
-var import_picocolors24 = __toESM(require_picocolors(), 1);
-function requireConfig14() {
-  const cfg = requireLoginConfig();
-  if (!cfg.space_id) {
-    console.error(import_picocolors24.default.red("Missing space config. Run 'dosu setup' to reconfigure."));
-    process.exit(1);
-  }
-  return cfg;
-}
 function threadsCommand() {
   const cmd = new Command("threads").description("List and manage conversation threads");
   cmd.command("list").description("List threads").option("--status <status>", "Filter by status: pending, resolved, archived").option("--search <query>", "Search threads").option("--limit <n>", "Maximum results (default: 20)", "20").option("--json", "Output as JSON").action(async (opts) => {
-    const cfg = requireConfig14();
+    const cfg = requireConfig13();
     const client = createTypedClient(cfg);
     const input = {
       __testing_scope__: undefined,
@@ -16309,7 +16404,7 @@ function threadsCommand() {
       return;
     }
     if (!threads || threads.length === 0) {
-      console.log(import_picocolors24.default.dim("No threads found."));
+      console.log(import_picocolors23.default.dim("No threads found."));
       return;
     }
     printTable(["ID", "Title", "Status", "Created"], threads.map((t2) => [
@@ -16320,7 +16415,7 @@ function threadsCommand() {
     ]), { rawData: threads });
   });
   cmd.command("get").description("View a thread and its messages").argument("<id>", "Thread ID").option("--limit <n>", "Number of messages to show (default: 20)", "20").option("--json", "Output as JSON").action(async (id, opts) => {
-    const cfg = requireConfig14();
+    const cfg = requireConfig13();
     const client = createTypedClient(cfg);
     const [thread, messagesData] = await Promise.all([
       client.thread.get.query(id),
@@ -16334,10 +16429,10 @@ function threadsCommand() {
       return;
     }
     if (!thread) {
-      console.log(import_picocolors24.default.dim("Thread not found."));
+      console.log(import_picocolors23.default.dim("Thread not found."));
       return;
     }
-    console.log(import_picocolors24.default.bold(thread.generated_title ?? "(untitled thread)"));
+    console.log(import_picocolors23.default.bold(thread.generated_title ?? "(untitled thread)"));
     printInfo([
       ["ID", thread.id],
       ["Created", formatDate(thread.created_at)],
@@ -16348,13 +16443,13 @@ function threadsCommand() {
     if (messages && messages.length > 0) {
       const allMessages = messages.flatMap((group) => group.messages);
       console.log(`
-${import_picocolors24.default.bold("Messages")} (${allMessages.length})`);
-      console.log(import_picocolors24.default.dim("─".repeat(60)));
+${import_picocolors23.default.bold("Messages")} (${allMessages.length})`);
+      console.log(import_picocolors23.default.dim("─".repeat(60)));
       for (const msg of allMessages) {
         const role = msg.author_role ?? "unknown";
         const date = formatDate(msg.created_at);
         console.log(`
-${import_picocolors24.default.bold(role)} ${import_picocolors24.default.dim(date)}`);
+${import_picocolors23.default.bold(role)} ${import_picocolors23.default.dim(date)}`);
         if (msg.body) {
           console.log(truncate(msg.body, 500));
         }
@@ -16362,14 +16457,86 @@ ${import_picocolors24.default.bold(role)} ${import_picocolors24.default.dim(date
     }
   });
   cmd.command("archive").description("Archive a thread").argument("<id>", "Thread ID").option("--json", "Output as JSON").action(async (id, opts) => {
-    const cfg = requireConfig14();
+    const cfg = requireConfig13();
     const client = createTypedClient(cfg);
     await client.thread.archive.mutate({ threadId: id, archived: true });
     if (opts.json) {
       printResult({ success: true, id }, opts);
       return;
     }
-    console.log(import_picocolors24.default.green(`Thread ${id.slice(0, 8)} archived.`));
+    console.log(import_picocolors23.default.green(`Thread ${id.slice(0, 8)} archived.`));
+  });
+  return cmd;
+}
+
+// src/commands/topics.ts
+init_commander();
+init_trpc();
+var import_picocolors24 = __toESM(require_picocolors(), 1);
+function requireConfig14() {
+  const cfg = requireLoginConfig();
+  if (!cfg.space_id) {
+    console.error(import_picocolors24.default.red("Missing space config. Run 'dosu setup' to reconfigure."));
+    process.exit(1);
+  }
+  return cfg;
+}
+async function getKnowledgeStoreId4(client, spaceId) {
+  const store = await client.knowledgeStore.getBySpaceId.query({
+    space_id: spaceId
+  });
+  if (!store) {
+    console.error(import_picocolors24.default.red("No knowledge store found for this deployment."));
+    process.exit(1);
+  }
+  return store.id;
+}
+function topicsCommand() {
+  const cmd = new Command("topics").alias("tags").description("Browse Topics in your knowledge base");
+  cmd.command("list").description("List all topics").option("--json", "Output as JSON").action(async (opts) => {
+    const cfg = requireConfig14();
+    const client = createTypedClient(cfg);
+    const ksId = await getKnowledgeStoreId4(client, cfg.space_id);
+    const topics = await client.topic.listTopicsByKnowledgeStore.query({
+      knowledge_store_id: ksId
+    });
+    if (opts.json) {
+      printResult(topics, opts);
+      return;
+    }
+    if (!topics || topics.length === 0) {
+      console.log(import_picocolors24.default.dim("No topics found."));
+      return;
+    }
+    printTable(["ID", "Name", "Description"], topics.map((t2) => [
+      t2.topic_id.slice(0, 8),
+      t2.name,
+      t2.description ?? "—"
+    ]), { rawData: topics });
+  });
+  cmd.command("pages").description("List pages with a specific topic").argument("<topic-id>", "Topic ID").option("--search <query>", "Search within the topic's pages").option("--limit <n>", "Maximum results", "10").option("--json", "Output as JSON").action(async (topicId, opts) => {
+    const cfg = requireConfig14();
+    const client = createTypedClient(cfg);
+    const ksId = await getKnowledgeStoreId4(client, cfg.space_id);
+    const result = await client.topic.getPagesByTopicId.query({
+      knowledge_store_id: ksId,
+      topic_id: topicId,
+      searchTerm: opts.search,
+      limit: Number.parseInt(opts.limit ?? "10", 10)
+    });
+    const pages = result.data;
+    if (opts.json) {
+      printResult(pages, opts);
+      return;
+    }
+    if (!pages || pages.length === 0) {
+      console.log(import_picocolors24.default.dim("No pages found with this topic."));
+      return;
+    }
+    printTable(["ID", "Title"], pages.map((p2) => [
+      p2.id.slice(0, 8),
+      p2.title ?? "(untitled)"
+    ]), { rawData: pages });
   });
   return cmd;
 }
@@ -16378,14 +16545,15 @@ ${import_picocolors24.default.bold(role)} ${import_picocolors24.default.dim(date
 init_config();
 init_logger();
 init_providers();
+init_styles();
 init_skill_update_check();
 
 // src/version/update-check.ts
 init_config();
 init_logger();
 var import_picocolors25 = __toESM(require_picocolors(), 1);
-import { existsSync as existsSync16, mkdirSync as mkdirSync8, readFileSync as readFileSync15, writeFileSync as writeFileSync7 } from "node:fs";
-import { join as join27 } from "node:path";
+import { existsSync as existsSync18, mkdirSync as mkdirSync9, readFileSync as readFileSync15, writeFileSync as writeFileSync8 } from "node:fs";
+import { join as join28 } from "node:path";
 var CACHE_FILENAME3 = "update-check.json";
 var CHECK_INTERVAL_MS3 = 24 * 60 * 60 * 1000;
 var FETCH_TIMEOUT_MS3 = 5000;
@@ -16408,12 +16576,12 @@ function isNewerVersion(latest, current) {
   return false;
 }
 function getCachePath3() {
-  return join27(getConfigDir(), CACHE_FILENAME3);
+  return join28(getConfigDir(), CACHE_FILENAME3);
 }
 function readCache() {
   try {
     const path3 = getCachePath3();
-    if (!existsSync16(path3))
+    if (!existsSync18(path3))
       return null;
     const data = JSON.parse(readFileSync15(path3, "utf-8"));
     if (typeof data.lastCheck === "number" && typeof data.latestVersion === "string") {
@@ -16427,10 +16595,10 @@ function readCache() {
 function writeCache(cache) {
   try {
     const dir = getConfigDir();
-    if (!existsSync16(dir)) {
-      mkdirSync8(dir, { recursive: true, mode: 448 });
+    if (!existsSync18(dir)) {
+      mkdirSync9(dir, { recursive: true, mode: 448 });
     }
-    writeFileSync7(getCachePath3(), JSON.stringify(cache), { mode: 384 });
+    writeFileSync8(getCachePath3(), JSON.stringify(cache), { mode: 384 });
   } catch {}
 }
 async function fetchLatestVersion() {
@@ -16558,7 +16726,9 @@ function createProgram() {
       const { startOAuthFlow: startOAuthFlow2 } = await Promise.resolve().then(() => (init_flow(), exports_flow));
       let result;
       try {
-        result = await startOAuthFlow2();
+        result = await startOAuthFlow2(undefined, undefined, undefined, (url) => {
+          console.log(browserFallbackHint(url));
+        });
       } catch (err) {
         if (err instanceof OAuthCallbackError2) {
           console.error(err.userMessage);
@@ -16701,7 +16871,7 @@ Use 'dosu mcp add <agent>' to add Dosu MCP to a tool.`);
   program2.addCommand(reviewCommand());
   program2.addCommand(sourcesCommand());
   program2.addCommand(suggestCommand());
-  program2.addCommand(tagsCommand());
+  program2.addCommand(topicsCommand());
   program2.addCommand(threadsCommand());
   program2.addCommand(skillCommand());
   program2.command("setup").description("Set up Dosu MCP for your AI tools").option("--deployment <id>", "Skip to tool configuration for a specific MCP").option("--mode <mode>", "Force OSS or Cloud mode, skipping the interactive prompt (oss|cloud)").option("--agent", "Run non-interactive setup designed for coding agents (requires --tool)").option("--tool <id>", "Configure a single AI tool by id (claude, cursor, codex, …). Required with --agent.").option("--login-ticket <ticket>", "Resume an --agent setup by redeeming a ticket from a previous run").action(async (opts) => {