@dosu/cli 0.18.1 → 0.19.0

package/bin/dosu.js

@@ -4548,7 +4548,7 @@ var init_dist4 = __esm(() => {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.18.1";
+var VERSION = "0.19.0";
 
 // src/debug/logger.ts
 import {
@@ -5444,6 +5444,45 @@ var init_dist6 = __esm(() => {
   J2 = `${import_picocolors7.default.gray(o)}  `;
 });
 
+// src/hooks/prompts.ts
+var exports_prompts = {};
+__export(exports_prompts, {
+  buildReadyEnvelope: () => buildReadyEnvelope,
+  STOP_PREFIX: () => STOP_PREFIX,
+  SAVE_NUDGE: () => SAVE_NUDGE,
+  LOOKUP_STARTED_NOTE: () => LOOKUP_STARTED_NOTE
+});
+function buildReadyEnvelope(context, saveRecommended = false) {
+  const trimmed = context.trim();
+  const blocks = [];
+  if (trimmed) {
+    blocks.push([
+      "Dosu knowledge context for this task:",
+      "",
+      trimmed,
+      "",
+      "How to use this:",
+      "- Use it quietly to answer faster and with fewer broad searches. Keep working normally.",
+      "- This is the known likely path, not the full boundary. Before finalizing, verify adjacent " + "public/API entrypoints and edge cases that this route map may not cover.",
+      "- Attribution: this context is your team's existing knowledge (docs, past PRs, discussions) " + "surfaced by Dosu — not the live code you're reading. For each main finding it speaks to, " + "add one brief cited note on how the team's knowledge relates: if it agrees, note it in a " + "line and cite the source; if it differs, flag it as worth confirming and reconcile before " + "finalizing; if it adds something the code alone wouldn't tell you (a rationale, a gotcha, " + "a past decision), surface it, cited.",
+      "- Surface this at each main finding the context speaks to — but skip the ones it is " + "genuinely silent on, and never invent agreement or disagreement. Keep each note brief and " + 'next to the finding; do not open with "Dosu told me…", do not add a closing praise ' + "paragraph, and do not reference any ticket or lookup id."
+    ].join(`
+`));
+  }
+  if (saveRecommended) {
+    blocks.push(SAVE_NUDGE);
+  }
+  return blocks.join(`
+
+`);
+}
+var LOOKUP_STARTED_NOTE, STOP_PREFIX, SAVE_NUDGE;
+var init_prompts = __esm(() => {
+  LOOKUP_STARTED_NOTE = "Dosu started a background knowledge lookup for this request. Keep working normally — " + "do not wait or pause for it. If Dosu context arrives during this session, fold it in " + "quietly to work faster and avoid wrong assumptions. Mention Dosu when its context " + "helps you.";
+  STOP_PREFIX = "Dosu knowledge finished after your last action. Re-check your current conclusion against " + "it, then continue or finish — do not redo work it merely confirms.";
+  SAVE_NUDGE = "Dosu has little or no existing knowledge on this topic. If you uncover something durable — " + "a non-obvious mechanism, a gotcha, or a route through the code — save it with the Dosu " + "`save_topic` tool when you finish, so future sessions start ahead. Only save genuinely " + "reusable knowledge; skip trivial or one-off details.";
+});
+
 // src/hooks/ticket-client.ts
 var exports_ticket_client = {};
 __export(exports_ticket_client, {
@@ -5494,45 +5533,6 @@ var init_ticket_client = __esm(() => {
   };
 });
 
-// src/hooks/prompts.ts
-var exports_prompts = {};
-__export(exports_prompts, {
-  buildReadyEnvelope: () => buildReadyEnvelope,
-  STOP_PREFIX: () => STOP_PREFIX,
-  SAVE_NUDGE: () => SAVE_NUDGE,
-  LOOKUP_STARTED_NOTE: () => LOOKUP_STARTED_NOTE
-});
-function buildReadyEnvelope(context, saveRecommended = false) {
-  const trimmed = context.trim();
-  const blocks = [];
-  if (trimmed) {
-    blocks.push([
-      "Dosu knowledge context for this task:",
-      "",
-      trimmed,
-      "",
-      "How to use this:",
-      "- Use it quietly to answer faster and with fewer broad searches. Keep working normally.",
-      "- This is the known likely path, not the full boundary. Before finalizing, verify adjacent " + "public/API entrypoints and edge cases that this route map may not cover.",
-      "- Attribution: this context is your team's existing knowledge (docs, past PRs, discussions) " + "surfaced by Dosu — not the live code you're reading. For each main finding it speaks to, " + "add one brief cited note on how the team's knowledge relates: if it agrees, note it in a " + "line and cite the source; if it differs, flag it as worth confirming and reconcile before " + "finalizing; if it adds something the code alone wouldn't tell you (a rationale, a gotcha, " + "a past decision), surface it, cited.",
-      "- Surface this at each main finding the context speaks to — but skip the ones it is " + "genuinely silent on, and never invent agreement or disagreement. Keep each note brief and " + 'next to the finding; do not open with "Dosu told me…", do not add a closing praise ' + "paragraph, and do not reference any ticket or lookup id."
-    ].join(`
-`));
-  }
-  if (saveRecommended) {
-    blocks.push(SAVE_NUDGE);
-  }
-  return blocks.join(`
-
-`);
-}
-var LOOKUP_STARTED_NOTE, STOP_PREFIX, SAVE_NUDGE;
-var init_prompts = __esm(() => {
-  LOOKUP_STARTED_NOTE = "Dosu started a background knowledge lookup for this request. Keep working normally — " + "do not wait or pause for it. If Dosu context arrives during this session, fold it in " + "quietly to work faster and avoid wrong assumptions. Mention Dosu when its context " + "helps you.";
-  STOP_PREFIX = "Dosu knowledge finished after your last action. Re-check your current conclusion against " + "it, then continue or finish — do not redo work it merely confirms.";
-  SAVE_NUDGE = "Dosu has little or no existing knowledge on this topic. If you uncover something durable — " + "a non-obvious mechanism, a gotcha, or a route through the code — save it with the Dosu " + "`save_topic` tool when you finish, so future sessions start ahead. Only save genuinely " + "reusable knowledge; skip trivial or one-off details.";
-});
-
 // src/agent/output.ts
 var exports_output = {};
 __export(exports_output, {
@@ -6344,6 +6344,135 @@ var init_claude_code = __esm(() => {
   };
 });
 
+// src/hooks/codex.ts
+var exports_codex = {};
+__export(exports_codex, {
+  removeCodexHooks: () => removeCodexHooks,
+  installCodexHooks: () => installCodexHooks,
+  inspectCodexHooks: () => inspectCodexHooks,
+  codexHooksPath: () => codexHooksPath,
+  codexHookCommand: () => codexHookCommand
+});
+import { existsSync as existsSync6, readFileSync as readFileSync7 } from "node:fs";
+import { join as join5 } from "node:path";
+function codexHooksPath(dir) {
+  return join5(dir, ".codex", "hooks.json");
+}
+function codexHookCommand(subcommand) {
+  return `dosu hooks ${subcommand} --agent codex`;
+}
+function dosuGroup2(event) {
+  return {
+    hooks: [
+      {
+        type: "command",
+        command: codexHookCommand(EVENT_SUBCOMMAND2[event]),
+        timeout: EVENT_TIMEOUT_SEC[event],
+        statusMessage: EVENT_STATUS_MESSAGE[event]
+      }
+    ]
+  };
+}
+function readHooksFileOrThrow(path) {
+  if (!existsSync6(path))
+    return {};
+  const raw = readFileSync7(path, "utf-8").trim();
+  if (!raw)
+    return {};
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error(`refusing to modify ${path}: file exists but is not valid JSON`);
+  }
+}
+function installCodexHooks(configPath, opts = {}) {
+  const config = readHooksFileOrThrow(configPath);
+  const events = DEFAULT_HOOK_EVENTS.filter((e2) => e2 !== "Stop" || opts.stop !== false);
+  const hooks = typeof config.hooks === "object" && config.hooks ? config.hooks : {};
+  for (const event of events) {
+    const groups = Array.isArray(hooks[event]) ? hooks[event] : [];
+    const kept = groups.filter((g2) => !isDosuGroup(g2));
+    kept.push(dosuGroup2(event));
+    hooks[event] = kept;
+  }
+  for (const event of DEFAULT_HOOK_EVENTS) {
+    if (!events.includes(event) && Array.isArray(hooks[event])) {
+      const kept = hooks[event].filter((g2) => !isDosuGroup(g2));
+      if (kept.length > 0)
+        hooks[event] = kept;
+      else
+        delete hooks[event];
+    }
+  }
+  config.hooks = hooks;
+  saveJSONConfig(configPath, config);
+  return { events: [...events] };
+}
+function removeCodexHooks(configPath) {
+  if (!existsSync6(configPath))
+    return { removed: false };
+  let config;
+  try {
+    config = readHooksFileOrThrow(configPath);
+  } catch {
+    return { removed: false };
+  }
+  const hooks = config.hooks;
+  if (typeof hooks !== "object" || !hooks)
+    return { removed: false };
+  let removed = false;
+  for (const event of Object.keys(hooks)) {
+    if (!Array.isArray(hooks[event]))
+      continue;
+    const kept = hooks[event].filter((g2) => !isDosuGroup(g2));
+    if (kept.length !== hooks[event].length) {
+      removed = true;
+      if (kept.length > 0)
+        hooks[event] = kept;
+      else
+        delete hooks[event];
+    }
+  }
+  if (removed)
+    saveJSONConfig(configPath, config);
+  return { removed };
+}
+function inspectCodexHooks(configPath) {
+  if (!existsSync6(configPath))
+    return { fileExists: false, events: [] };
+  let config;
+  try {
+    config = readHooksFileOrThrow(configPath);
+  } catch {
+    return { fileExists: true, parseError: true, events: [] };
+  }
+  const hooks = config.hooks;
+  if (typeof hooks !== "object" || !hooks)
+    return { fileExists: true, events: [] };
+  const events = Object.keys(hooks).filter((event) => Array.isArray(hooks[event]) && hooks[event].some((g2) => isDosuGroup(g2)));
+  return { fileExists: true, events };
+}
+var EVENT_SUBCOMMAND2, EVENT_TIMEOUT_SEC, EVENT_STATUS_MESSAGE;
+var init_codex = __esm(() => {
+  init_config_helpers();
+  init_claude_code();
+  EVENT_SUBCOMMAND2 = {
+    UserPromptSubmit: "user-prompt-submit",
+    PostToolUse: "post-tool-use",
+    Stop: "stop"
+  };
+  EVENT_TIMEOUT_SEC = {
+    UserPromptSubmit: 10,
+    PostToolUse: 10,
+    Stop: 30
+  };
+  EVENT_STATUS_MESSAGE = {
+    UserPromptSubmit: "Dosu knowledge lookup",
+    PostToolUse: "Dosu knowledge delivery",
+    Stop: "Dosu final knowledge check"
+  };
+});
+
 // src/insights/insights.ts
 async function buildInsights({
   client,
@@ -7432,17 +7561,17 @@ var init_insights2 = __esm(() => {
 });
 
 // src/version/skill-update-check.ts
-import { existsSync as existsSync6, mkdirSync as mkdirSync5, readFileSync as readFileSync8, writeFileSync as writeFileSync4 } from "node:fs";
-import { join as join5 } from "node:path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync5, readFileSync as readFileSync9, writeFileSync as writeFileSync4 } from "node:fs";
+import { join as join6 } from "node:path";
 function getCachePath() {
-  return join5(getConfigDir(), CACHE_FILENAME);
+  return join6(getConfigDir(), CACHE_FILENAME);
 }
 function readSkillCache() {
   try {
     const path = getCachePath();
-    if (!existsSync6(path))
+    if (!existsSync7(path))
       return null;
-    const data = JSON.parse(readFileSync8(path, "utf-8"));
+    const data = JSON.parse(readFileSync9(path, "utf-8"));
     if (typeof data.lastCheck === "number" && typeof data.latestSha === "string" && typeof data.installedSha === "string") {
       return data;
     }
@@ -7454,7 +7583,7 @@ function readSkillCache() {
 function writeSkillCache(cache) {
   try {
     const dir = getConfigDir();
-    if (!existsSync6(dir)) {
+    if (!existsSync7(dir)) {
       mkdirSync5(dir, { recursive: true, mode: 448 });
     }
     writeFileSync4(getCachePath(), JSON.stringify(cache), { mode: 384 });
@@ -7616,21 +7745,21 @@ var init_skill = __esm(() => {
 var MCP_PROVIDER_SLUG = "dosu_mcp";
 
 // src/mcp/detect.ts
-import { existsSync as existsSync7 } from "node:fs";
+import { existsSync as existsSync8 } from "node:fs";
 import { homedir, platform } from "node:os";
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 function isInstalled(paths) {
-  return paths.some((p2) => existsSync7(expandHome(p2)));
+  return paths.some((p2) => existsSync8(expandHome(p2)));
 }
 function expandHome(path) {
   if (!path.startsWith("~"))
     return path;
-  return join6(homedir(), path.slice(1));
+  return join7(homedir(), path.slice(1));
 }
 function appSupportDir() {
   switch (platform()) {
     case "darwin": {
-      return join6(homedir(), "Library", "Application Support");
+      return join7(homedir(), "Library", "Application Support");
     }
     case "win32": {
       return process.env.APPDATA ?? "";
@@ -7639,7 +7768,7 @@ function appSupportDir() {
       const xdg = process.env.XDG_CONFIG_HOME;
       if (xdg)
         return xdg;
-      return join6(homedir(), ".config");
+      return join7(homedir(), ".config");
     }
   }
 }
@@ -7720,7 +7849,7 @@ var init_antigravity = __esm(() => {
 });
 
 // src/mcp/providers/claude.ts
-import { join as join7 } from "node:path";
+import { join as join8 } from "node:path";
 var ClaudeProvider = () => createJSONProvider({
   providerName: "Claude Code",
   providerID: "claude",
@@ -7729,22 +7858,22 @@ var ClaudeProvider = () => createJSONProvider({
   paths: ["~/.claude"],
   globalPath: "~/.claude.json",
   topKey: "mcpServers",
-  localConfigPath: (cwd) => join7(cwd, ".mcp.json")
+  localConfigPath: (cwd) => join8(cwd, ".mcp.json")
 });
 var init_claude = __esm(() => {
   init_base();
 });
 
 // src/mcp/providers/claude-desktop.ts
-import { join as join8 } from "node:path";
+import { join as join9 } from "node:path";
 var ClaudeDesktopProvider = () => ({
   name: () => "Claude Desktop",
   id: () => "claude-desktop",
   supportsLocal: () => false,
   priority: () => 2,
-  detectPaths: () => [join8(appSupportDir(), "Claude")],
-  isInstalled: () => isInstalled([join8(appSupportDir(), "Claude")]),
-  globalConfigPath: () => join8(appSupportDir(), "Claude", "claude_desktop_config.json"),
+  detectPaths: () => [join9(appSupportDir(), "Claude")],
+  isInstalled: () => isInstalled([join9(appSupportDir(), "Claude")]),
+  globalConfigPath: () => join9(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");
@@ -7758,14 +7887,14 @@ var init_claude_desktop = __esm(() => {
 });
 
 // src/mcp/providers/cline.ts
-import { join as join9 } from "node:path";
-var extensionDir = () => join9(appSupportDir(), "Code", "User", "globalStorage", "saoudrizwan.claude-dev"), ClineProvider = () => createJSONProvider({
+import { join as join10 } from "node:path";
+var extensionDir = () => join10(appSupportDir(), "Code", "User", "globalStorage", "saoudrizwan.claude-dev"), ClineProvider = () => createJSONProvider({
   providerName: "Cline",
   providerID: "cline",
   local: false,
   priorityValue: 11,
   paths: [extensionDir()],
-  globalPath: join9(extensionDir(), "settings", "cline_mcp_settings.json"),
+  globalPath: join10(extensionDir(), "settings", "cline_mcp_settings.json"),
   topKey: "mcpServers",
   buildServer: (cfg) => ({
     url: mcpURL(cfg.deployment_id),
@@ -7781,7 +7910,7 @@ var init_cline = __esm(() => {
 });
 
 // src/mcp/providers/cline-cli.ts
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 function clineDir() {
   return process.env.CLINE_DIR ?? expandHome("~/.cline");
 }
@@ -7791,7 +7920,7 @@ var ClineCliProvider = () => createJSONProvider({
   local: false,
   priorityValue: 12,
   paths: [clineDir()],
-  globalPath: join10(clineDir(), "data", "settings", "cline_mcp_settings.json"),
+  globalPath: join11(clineDir(), "data", "settings", "cline_mcp_settings.json"),
   topKey: "mcpServers",
   buildServer: (cfg) => ({
     url: mcpURL(cfg.deployment_id),
@@ -7807,20 +7936,20 @@ var init_cline_cli = __esm(() => {
 });
 
 // src/mcp/providers/codex.ts
-import { existsSync as existsSync8, readFileSync as readFileSync9 } from "node:fs";
-import { join as join11 } from "node:path";
+import { existsSync as existsSync9, readFileSync as readFileSync10 } from "node:fs";
+import { join as join12 } from "node:path";
 function codexHome() {
   return process.env.CODEX_HOME ?? expandHome("~/.codex");
 }
 function getConfigPath2(global) {
   if (global)
-    return join11(codexHome(), "config.toml");
-  return join11(process.cwd(), ".codex", "config.toml");
+    return join12(codexHome(), "config.toml");
+  return join12(process.cwd(), ".codex", "config.toml");
 }
 function readTOML(path) {
-  if (!existsSync8(path))
+  if (!existsSync9(path))
     return "";
-  return readFileSync9(path, "utf-8");
+  return readFileSync10(path, "utf-8");
 }
 function writeTOML(path, content) {
   writeSecureFile(path, content);
@@ -7878,9 +8007,9 @@ var CodexProvider = () => ({
   priority: () => 8,
   detectPaths: () => ["~/.codex"],
   isInstalled: () => isInstalled(["~/.codex"]),
-  globalConfigPath: () => join11(codexHome(), "config.toml"),
+  globalConfigPath: () => join12(codexHome(), "config.toml"),
   isConfigured: () => {
-    const content = readTOML(join11(codexHome(), "config.toml"));
+    const content = readTOML(join12(codexHome(), "config.toml"));
     return content.includes("[mcp_servers.dosu]");
   },
   install(cfg, global) {
@@ -7895,17 +8024,17 @@ var CodexProvider = () => ({
       writeTOML(path, removeDosuFromTOML(content));
   }
 });
-var init_codex = __esm(() => {
+var init_codex2 = __esm(() => {
   init_config();
   init_config_helpers();
   init_detect();
 });
 
 // src/mcp/providers/copilot.ts
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 function globalPath() {
   if (process.env.XDG_CONFIG_HOME) {
-    return join12(process.env.XDG_CONFIG_HOME, "mcp-config.json");
+    return join13(process.env.XDG_CONFIG_HOME, "mcp-config.json");
   }
   return expandHome("~/.copilot/mcp-config.json");
 }
@@ -7936,7 +8065,7 @@ var CopilotProvider = () => ({
       };
       installJSONServer(globalPath(), "mcpServers", server);
     } else {
-      const configPath = join12(process.cwd(), ".vscode", "mcp.json");
+      const configPath = join13(process.cwd(), ".vscode", "mcp.json");
       const server = {
         type: "http",
         url,
@@ -7949,7 +8078,7 @@ var CopilotProvider = () => ({
     if (global) {
       removeJSONServer(globalPath(), "mcpServers");
     } else {
-      const configPath = join12(process.cwd(), ".vscode", "mcp.json");
+      const configPath = join13(process.cwd(), ".vscode", "mcp.json");
       removeJSONServer(configPath, "servers");
     }
   }
@@ -7961,7 +8090,7 @@ var init_copilot = __esm(() => {
 });
 
 // src/mcp/providers/cursor.ts
-import { join as join13 } from "node:path";
+import { join as join14 } from "node:path";
 var CursorProvider = () => createJSONProvider({
   providerName: "Cursor",
   providerID: "cursor",
@@ -7974,7 +8103,7 @@ var CursorProvider = () => createJSONProvider({
     url: mcpURL(cfg.deployment_id),
     headers: mcpHeaders(cfg.api_key)
   }),
-  localConfigPath: (cwd) => join13(cwd, ".cursor", "mcp.json")
+  localConfigPath: (cwd) => join14(cwd, ".cursor", "mcp.json")
 });
 var init_cursor = __esm(() => {
   init_config_helpers();
@@ -7982,7 +8111,7 @@ var init_cursor = __esm(() => {
 });
 
 // src/mcp/providers/gemini.ts
-import { join as join14 } from "node:path";
+import { join as join15 } from "node:path";
 var GeminiProvider = () => createJSONProvider({
   providerName: "Gemini CLI",
   providerID: "gemini",
@@ -7991,7 +8120,7 @@ var GeminiProvider = () => createJSONProvider({
   paths: ["~/.gemini"],
   globalPath: "~/.gemini/settings.json",
   topKey: "mcpServers",
-  localConfigPath: (cwd) => join14(cwd, ".gemini", "settings.json")
+  localConfigPath: (cwd) => join15(cwd, ".gemini", "settings.json")
 });
 var init_gemini = __esm(() => {
   init_base();
@@ -8041,14 +8170,14 @@ var init_manual = __esm(() => {
 });
 
 // src/mcp/providers/mcporter.ts
-import { existsSync as existsSync9 } from "node:fs";
-import { join as join15 } from "node:path";
+import { existsSync as existsSync10 } from "node:fs";
+import { join as join16 } from "node:path";
 function resolveGlobalConfigPath() {
   const jsonPath = expandHome("~/.mcporter/mcporter.json");
-  if (existsSync9(jsonPath))
+  if (existsSync10(jsonPath))
     return jsonPath;
   const jsoncPath = expandHome("~/.mcporter/mcporter.jsonc");
-  if (existsSync9(jsoncPath))
+  if (existsSync10(jsoncPath))
     return jsoncPath;
   return jsonPath;
 }
@@ -8069,7 +8198,7 @@ var MCPorterProvider = () => ({
   globalConfigPath: () => resolveGlobalConfigPath(),
   isConfigured: () => isJSONKeyConfigured(resolveGlobalConfigPath(), "mcpServers"),
   install(cfg, global) {
-    const configPath = global ? resolveGlobalConfigPath() : join15(process.cwd(), "config", "mcporter.json");
+    const configPath = global ? resolveGlobalConfigPath() : join16(process.cwd(), "config", "mcporter.json");
     const server = {
       type: "http",
       url: mcpEndpoint4(cfg),
@@ -8078,7 +8207,7 @@ var MCPorterProvider = () => ({
     installJSONServer(configPath, "mcpServers", server);
   },
   remove(global) {
-    const configPath = global ? resolveGlobalConfigPath() : join15(process.cwd(), "config", "mcporter.json");
+    const configPath = global ? resolveGlobalConfigPath() : join16(process.cwd(), "config", "mcporter.json");
     removeJSONServer(configPath, "mcpServers");
   }
 });
@@ -8089,7 +8218,7 @@ var init_mcporter = __esm(() => {
 });
 
 // src/mcp/providers/opencode.ts
-import { join as join16 } from "node:path";
+import { join as join17 } from "node:path";
 var OpenCodeProvider = () => createJSONProvider({
   providerName: "OpenCode",
   providerID: "opencode",
@@ -8104,7 +8233,7 @@ var OpenCodeProvider = () => createJSONProvider({
     enabled: true,
     headers: mcpHeaders(cfg.api_key)
   }),
-  localConfigPath: (cwd) => join16(cwd, "opencode.json")
+  localConfigPath: (cwd) => join17(cwd, "opencode.json")
 });
 var init_opencode = __esm(() => {
   init_config_helpers();
@@ -8112,16 +8241,16 @@ var init_opencode = __esm(() => {
 });
 
 // src/mcp/providers/vscode.ts
-import { join as join17 } from "node:path";
+import { join as join18 } from "node:path";
 var VSCodeProvider = () => createJSONProvider({
   providerName: "VS Code",
   providerID: "vscode",
   local: true,
   priorityValue: 6,
-  paths: [join17(appSupportDir(), "Code")],
-  globalPath: join17(appSupportDir(), "Code", "User", "mcp.json"),
+  paths: [join18(appSupportDir(), "Code")],
+  globalPath: join18(appSupportDir(), "Code", "User", "mcp.json"),
   topKey: "servers",
-  localConfigPath: (cwd) => join17(cwd, ".vscode", "mcp.json")
+  localConfigPath: (cwd) => join18(cwd, ".vscode", "mcp.json")
 });
 var init_vscode = __esm(() => {
   init_detect();
@@ -8130,14 +8259,14 @@ var init_vscode = __esm(() => {
 
 // src/mcp/providers/windsurf.ts
 import { homedir as homedir2 } from "node:os";
-import { join as join18 } from "node:path";
+import { join as join19 } from "node:path";
 var WindsurfProvider = () => createJSONProvider({
   providerName: "Windsurf",
   providerID: "windsurf",
   local: false,
   priorityValue: 9,
-  paths: [join18(homedir2(), ".codeium", "windsurf")],
-  globalPath: join18(homedir2(), ".codeium", "windsurf", "mcp_config.json"),
+  paths: [join19(homedir2(), ".codeium", "windsurf")],
+  globalPath: join19(homedir2(), ".codeium", "windsurf", "mcp_config.json"),
   topKey: "mcpServers"
 });
 var init_windsurf = __esm(() => {
@@ -8146,12 +8275,12 @@ var init_windsurf = __esm(() => {
 
 // src/mcp/providers/zed.ts
 import { platform as platform2 } from "node:os";
-import { join as join19 } from "node:path";
+import { join as join20 } from "node:path";
 function zedConfigDir() {
   const os = platform2();
   if (os === "darwin" || os === "win32")
-    return join19(appSupportDir(), "Zed");
-  return join19(appSupportDir(), "zed");
+    return join20(appSupportDir(), "Zed");
+  return join20(appSupportDir(), "zed");
 }
 var ZedProvider = () => createJSONProvider({
   providerName: "Zed",
@@ -8159,7 +8288,7 @@ var ZedProvider = () => createJSONProvider({
   local: true,
   priorityValue: 10,
   paths: [zedConfigDir()],
-  globalPath: join19(zedConfigDir(), "settings.json"),
+  globalPath: join20(zedConfigDir(), "settings.json"),
   topKey: "context_servers",
   buildServer: (cfg) => ({
     source: "custom",
@@ -8167,7 +8296,7 @@ var ZedProvider = () => createJSONProvider({
     url: mcpURL(cfg.deployment_id),
     headers: mcpHeaders(cfg.api_key)
   }),
-  localConfigPath: (cwd) => join19(cwd, ".zed", "settings.json")
+  localConfigPath: (cwd) => join20(cwd, ".zed", "settings.json")
 });
 var init_zed = __esm(() => {
   init_config_helpers();
@@ -8211,7 +8340,7 @@ var init_providers = __esm(() => {
   init_claude_desktop();
   init_cline();
   init_cline_cli();
-  init_codex();
+  init_codex2();
   init_copilot();
   init_cursor();
   init_gemini();
@@ -10760,8 +10889,8 @@ __export(exports_flow2, {
   isStdioOnly: () => isStdioOnly
 });
 import { randomUUID } from "node:crypto";
-import { existsSync as existsSync10 } from "node:fs";
-import { join as join20 } from "node:path";
+import { existsSync as existsSync11 } from "node:fs";
+import { join as join21 } 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}` : ""}`);
@@ -10933,7 +11062,7 @@ async function runSetup(opts = {}) {
     showTryItOutPrompt({
       mode: cfg.mode,
       docsImported: choices.connectGitHub && githubOnboardingDone,
-      hasAgentsMd: existsSync10(join20(process.cwd(), "AGENTS.md"))
+      hasAgentsMd: existsSync11(join21(process.cwd(), "AGENTS.md"))
     });
   }
   if (mcpCompleted || skillCompleted || docsImported) {
@@ -11427,8 +11556,8 @@ var init_flow2 = __esm(() => {
 });
 
 // src/commands/insights.ts
-import { existsSync as existsSync11, mkdirSync as mkdirSync6, readdirSync, unlinkSync, writeFileSync as writeFileSync5 } from "node:fs";
-import { dirname as dirname3, join as join21 } from "node:path";
+import { existsSync as existsSync12, mkdirSync as mkdirSync6, readdirSync, unlinkSync, writeFileSync as writeFileSync5 } from "node:fs";
+import { dirname as dirname3, join as join22 } from "node:path";
 function shuffled(arr) {
   const copy2 = [...arr];
   for (let i = copy2.length - 1;i > 0; i--) {
@@ -11532,17 +11661,17 @@ function makeAskFn(cfg) {
   };
 }
 function insightsDir() {
-  return join21(getConfigDir(), "insights");
+  return join22(getConfigDir(), "insights");
 }
 function reportPath(timestamp) {
   const dir = insightsDir();
   if (!timestamp)
-    return join21(dir, "latest.html");
+    return join22(dir, "latest.html");
   const iso = timestamp.toISOString().slice(0, 19).replace(/:/g, "-");
-  return join21(dir, `report-${iso}Z.html`);
+  return join22(dir, `report-${iso}Z.html`);
 }
 function pruneOldReports(dir, keepN) {
-  if (!existsSync11(dir))
+  if (!existsSync12(dir))
     return;
   let entries;
   try {
@@ -11554,7 +11683,7 @@ function pruneOldReports(dir, keepN) {
   const reports = entries.filter((f) => REPORT_FILE_PATTERN.test(f)).sort().reverse();
   for (const f of reports.slice(keepN)) {
     try {
-      unlinkSync(join21(dir, f));
+      unlinkSync(join22(dir, f));
     } catch (err) {
       logger.debug("insights", `failed to prune ${f}: ${err instanceof Error ? err.message : err}`);
     }
@@ -11627,7 +11756,7 @@ function defaultRunner(cfg) {
     render: renderHTML,
     writeFile: (path2, content) => {
       const dir = dirname3(path2);
-      if (!existsSync11(dir))
+      if (!existsSync12(dir))
         mkdirSync6(dir, { recursive: true, mode: 448 });
       writeFileSync5(path2, content, { mode: 384 });
     },
@@ -12292,7 +12421,7 @@ var init_flow3 = __esm(() => {
 // src/cli/cli.ts
 init_esm();
 init_client();
-import { readFileSync as readFileSync11, unlinkSync as unlinkSync2 } from "node:fs";
+import { readFileSync as readFileSync12, unlinkSync as unlinkSync2 } from "node:fs";
 
 // src/commands/analytics.ts
 init_esm();
@@ -12977,7 +13106,8 @@ ${page.body}`);
 init_esm();
 init_config();
 init_logger();
-import { readFileSync as readFileSync7 } from "node:fs";
+init_prompts();
+import { readFileSync as readFileSync8 } from "node:fs";
 import { basename } from "node:path";
 
 // src/hooks/state.ts
@@ -13016,7 +13146,8 @@ var COOLDOWN_DEFAULT_MS = 3000;
 var TTL_DEFAULT_MS = 10 * 60 * 1000;
 var STOP_WAIT_DEFAULT_MS = 8000;
 var STOP_POLL_DEFAULT_MS = 1000;
-var SUPPORTED_AGENTS = ["claude-code"];
+var SUPPORTED_AGENTS = ["claude-code", "codex"];
+var DEFAULT_AGENT = "claude-code";
 function cooldownMs() {
   const n = Number.parseInt(process.env.DOSU_HOOK_CHECK_COOLDOWN_MS ?? "", 10);
   return Number.isFinite(n) && n >= 0 ? n : COOLDOWN_DEFAULT_MS;
@@ -13049,13 +13180,17 @@ function errMsg(err) {
 function repoSlug(cwd) {
   return cwd ? basename(cwd) : undefined;
 }
-async function runUserPromptSubmit(input, now = Date.now()) {
+async function runUserPromptSubmit(input, now = Date.now(), agent = DEFAULT_AGENT) {
   const sessionId = input.session_id;
   if (!sessionId)
     return;
   const prompt = (input.prompt ?? "").trim();
   if (!prompt)
     return;
+  if (prompt.startsWith(STOP_PREFIX)) {
+    logger.debug("hooks", "submit skipped reason=own-stop-envelope");
+    return;
+  }
   const existing = loadState(sessionId);
   if (existing && existing.status === "pending" && now <= existing.expiresAt) {
     logger.debug("hooks", `submit sid=${sid8(sessionId)} reuse tid=${existing.ticketId}`);
@@ -13072,7 +13207,7 @@ async function runUserPromptSubmit(input, now = Date.now()) {
   try {
     resp = await tc.requestCreateTicket(cfg, {
       deployment_id: cfg.deployment_id,
-      agent: "claude-code",
+      agent,
       session_id: sessionId,
       turn_id: input.turn_id ?? String(now),
       prompt,
@@ -13219,7 +13354,7 @@ function runStatus(input, opts, now = Date.now()) {
   console.log(`Status: ${data.status}`);
   console.log(`Delivered: ${data.delivered ? "yes" : "no"}`);
 }
-async function runHookEntrypoint(event, raw, now = Date.now()) {
+async function runHookEntrypoint(event, raw, now = Date.now(), agent = DEFAULT_AGENT) {
   let input = {};
   try {
     input = raw.trim() ? JSON.parse(raw) : {};
@@ -13228,7 +13363,7 @@ async function runHookEntrypoint(event, raw, now = Date.now()) {
   }
   try {
     if (event === "user-prompt-submit")
-      await runUserPromptSubmit(input, now);
+      await runUserPromptSubmit(input, now, agent);
     else if (event === "post-tool-use")
       await runPostToolUse(input, now);
     else
@@ -13241,7 +13376,7 @@ async function runHookEntrypoint(event, raw, now = Date.now()) {
 }
 function readStdinRaw() {
   try {
-    return readFileSync7(0, "utf8");
+    return readFileSync8(0, "utf8");
   } catch {
     return "";
   }
@@ -13254,12 +13389,13 @@ async function emitErrorLine(step, reason, agentNextSteps) {
   emitError2({ step, reason, agent_next_steps: agentNextSteps });
 }
 async function runInstall(agent, opts) {
-  if (agent !== "claude-code") {
+  if (!SUPPORTED_AGENTS.includes(agent)) {
     process.exitCode = 2;
+    const supported = SUPPORTED_AGENTS.join(", ");
     if (opts.json) {
-      await emitErrorLine("hooks-install", "unsupported_agent", `Only 'claude-code' is supported.`);
+      await emitErrorLine("hooks-install", "unsupported_agent", `Supported agents: ${supported}.`);
     } else {
-      console.error(`Unsupported agent '${agent}'. Supported agents: claude-code.`);
+      console.error(`Unsupported agent '${agent}'. Supported agents: ${supported}.`);
     }
     return;
   }
@@ -13272,13 +13408,28 @@ async function runInstall(agent, opts) {
     }
     return;
   }
-  const { installClaudeHooks: installClaudeHooks2, claudeLocalSettingsPath: claudeLocalSettingsPath2 } = await Promise.resolve().then(() => (init_claude_code(), exports_claude_code));
-  const configPath = claudeLocalSettingsPath2(resolveDir(opts.dir));
   try {
+    if (agent === "codex") {
+      const { installCodexHooks: installCodexHooks2, codexHooksPath: codexHooksPath2 } = await Promise.resolve().then(() => (init_codex(), exports_codex));
+      const configPath2 = codexHooksPath2(resolveDir(opts.dir));
+      const { events: events2 } = installCodexHooks2(configPath2, { stop: opts.stop });
+      if (opts.json) {
+        const { emitStep: emitStep2 } = await Promise.resolve().then(() => exports_output);
+        emitStep2({ step: "hooks-install", agent, path: configPath2, events: events2 });
+      } else {
+        console.log(`✓ Installed Dosu hooks for Codex (${events2.join(", ")}).`);
+        console.log(`  → ${configPath2}`);
+        console.log("  One-time step: open Codex in this project and run /hooks to review and");
+        console.log("  trust the Dosu hooks — Codex skips untrusted hooks by design.");
+      }
+      return;
+    }
+    const { installClaudeHooks: installClaudeHooks2, claudeLocalSettingsPath: claudeLocalSettingsPath2 } = await Promise.resolve().then(() => (init_claude_code(), exports_claude_code));
+    const configPath = claudeLocalSettingsPath2(resolveDir(opts.dir));
     const { events } = installClaudeHooks2(configPath, { stop: opts.stop });
     if (opts.json) {
       const { emitStep: emitStep2 } = await Promise.resolve().then(() => exports_output);
-      emitStep2({ step: "hooks-install", path: configPath, events });
+      emitStep2({ step: "hooks-install", agent, path: configPath, events });
     } else {
       console.log(`✓ Installed Dosu hooks for Claude Code (${events.join(", ")}).`);
       console.log(`  → ${configPath}`);
@@ -13294,18 +13445,27 @@ async function runInstall(agent, opts) {
   }
 }
 async function runUninstall(agent, opts) {
-  if (agent !== "claude-code") {
+  if (!SUPPORTED_AGENTS.includes(agent)) {
     process.exitCode = 2;
+    const supported = SUPPORTED_AGENTS.join(", ");
     if (opts.json) {
-      await emitErrorLine("hooks-uninstall", "unsupported_agent", "Only 'claude-code' is supported.");
+      await emitErrorLine("hooks-uninstall", "unsupported_agent", `Supported agents: ${supported}.`);
     } else {
-      console.error(`Unsupported agent '${agent}'. Supported agents: claude-code.`);
+      console.error(`Unsupported agent '${agent}'. Supported agents: ${supported}.`);
     }
     return;
   }
-  const { removeClaudeHooks: removeClaudeHooks2, claudeLocalSettingsPath: claudeLocalSettingsPath2 } = await Promise.resolve().then(() => (init_claude_code(), exports_claude_code));
-  const configPath = claudeLocalSettingsPath2(resolveDir(opts.dir));
-  const { removed } = removeClaudeHooks2(configPath);
+  let configPath;
+  let removed;
+  if (agent === "codex") {
+    const { removeCodexHooks: removeCodexHooks2, codexHooksPath: codexHooksPath2 } = await Promise.resolve().then(() => (init_codex(), exports_codex));
+    configPath = codexHooksPath2(resolveDir(opts.dir));
+    ({ removed } = removeCodexHooks2(configPath));
+  } else {
+    const { removeClaudeHooks: removeClaudeHooks2, claudeLocalSettingsPath: claudeLocalSettingsPath2 } = await Promise.resolve().then(() => (init_claude_code(), exports_claude_code));
+    configPath = claudeLocalSettingsPath2(resolveDir(opts.dir));
+    ({ removed } = removeClaudeHooks2(configPath));
+  }
   if (opts.json) {
     const { emitStep: emitStep2 } = await Promise.resolve().then(() => exports_output);
     emitStep2({ step: "hooks-uninstall", path: configPath, removed });
@@ -13318,12 +13478,16 @@ async function runUninstall(agent, opts) {
 async function collectDoctorChecks(opts) {
   const checks = [];
   const { claudeLocalSettingsPath: claudeLocalSettingsPath2, inspectClaudeHooks: inspectClaudeHooks2 } = await Promise.resolve().then(() => (init_claude_code(), exports_claude_code));
+  const { codexHooksPath: codexHooksPath2, inspectCodexHooks: inspectCodexHooks2 } = await Promise.resolve().then(() => (init_codex(), exports_codex));
   const configPath = claudeLocalSettingsPath2(resolveDir(opts.dir));
   const inspection = inspectClaudeHooks2(configPath);
+  const codexPath = codexHooksPath2(resolveDir(opts.dir));
+  const codex = inspectCodexHooks2(codexPath);
+  const codexInstalled = codex.events.includes("UserPromptSubmit") && codex.events.includes("PostToolUse");
   if (!inspection.fileExists) {
     checks.push({
       name: "config",
-      status: "fail",
+      status: codexInstalled ? "warn" : "fail",
       detail: `not found: ${configPath} (run 'dosu hooks install claude-code')`
     });
   } else if (inspection.parseError) {
@@ -13342,10 +13506,32 @@ async function collectDoctorChecks(opts) {
   } else {
     checks.push({
       name: "hooks",
-      status: "fail",
+      status: codexInstalled ? "warn" : "fail",
       detail: "UserPromptSubmit + PostToolUse not both installed"
     });
   }
+  if (codex.fileExists) {
+    if (codex.parseError) {
+      checks.push({ name: "codex-config", status: "fail", detail: `invalid JSON: ${codexPath}` });
+    } else if (codexInstalled) {
+      checks.push({
+        name: "codex-config",
+        status: "ok",
+        detail: `installed: ${codex.events.join(", ")} (${codexPath})`
+      });
+      checks.push({
+        name: "codex-trust",
+        status: "warn",
+        detail: "if hooks aren't firing, run /hooks inside Codex to review + trust them (one-time)"
+      });
+    } else {
+      checks.push({
+        name: "codex-config",
+        status: "fail",
+        detail: "UserPromptSubmit + PostToolUse not both installed"
+      });
+    }
+  }
   const cfg = loadConfig();
   if (isAuthenticated(cfg)) {
     checks.push({ name: "auth", status: "ok", detail: "logged in" });
@@ -13400,15 +13586,15 @@ async function runDoctor(opts) {
   }
 }
 function hooksCommand() {
-  const cmd = new Command("hooks").description("Dosu knowledge-injection hooks for Claude Code");
-  cmd.command("user-prompt-submit").description("Hook entrypoint: create a knowledge ticket on prompt submit").action(async () => {
-    await runHookEntrypoint("user-prompt-submit", readStdinRaw());
+  const cmd = new Command("hooks").description("Dosu knowledge-injection hooks for coding agents (Claude Code, Codex)");
+  cmd.command("user-prompt-submit").description("Hook entrypoint: create a knowledge ticket on prompt submit").option("--agent <agent>", "Calling agent for ticket attribution", DEFAULT_AGENT).action(async (opts) => {
+    await runHookEntrypoint("user-prompt-submit", readStdinRaw(), Date.now(), opts.agent);
   });
-  cmd.command("post-tool-use").description("Hook entrypoint: poll and inject ready knowledge once").action(async () => {
-    await runHookEntrypoint("post-tool-use", readStdinRaw());
+  cmd.command("post-tool-use").description("Hook entrypoint: poll and inject ready knowledge once").option("--agent <agent>", "Calling agent for ticket attribution", DEFAULT_AGENT).action(async (opts) => {
+    await runHookEntrypoint("post-tool-use", readStdinRaw(), Date.now(), opts.agent);
   });
-  cmd.command("stop").description("Hook entrypoint: last-chance knowledge delivery when the agent stops").action(async () => {
-    await runHookEntrypoint("stop", readStdinRaw());
+  cmd.command("stop").description("Hook entrypoint: last-chance knowledge delivery when the agent stops").option("--agent <agent>", "Calling agent for ticket attribution", DEFAULT_AGENT).action(async (opts) => {
+    await runHookEntrypoint("stop", readStdinRaw(), Date.now(), opts.agent);
   });
   cmd.command("status").description("Show the active Dosu knowledge ticket for this session").option("--json", "Output JSON", false).action((opts) => {
     let input = {};
@@ -13426,16 +13612,21 @@ function hooksCommand() {
     "",
     "Examples:",
     "  $ dosu hooks install claude-code",
+    "  $ dosu hooks install codex",
     "  $ dosu hooks install claude-code --no-stop",
-    "  $ dosu hooks install claude-code --dir ./my-project"
+    "  $ dosu hooks install codex --dir ./my-project",
+    "",
+    "Codex requires a one-time trust step after install: open Codex in the",
+    "project and run /hooks to review and trust the Dosu hooks."
   ].join(`
 `)).action((agent, opts) => runInstall(agent, opts));
   cmd.command("uninstall").description("Remove Dosu hooks from a coding agent's local config (Dosu-owned entries only)").addArgument(new Argument("<agent>", "coding agent to clean up").choices(SUPPORTED_AGENTS)).option("--scope <scope>", "Config scope (local only)", "local").option("--dir <path>", "Project root (defaults to current directory)").option("--json", "Emit machine-readable JSON", false).addHelpText("after", [
     "",
     `Supported agents: ${SUPPORTED_AGENTS.join(", ")}`,
     "",
-    "Example:",
-    "  $ dosu hooks uninstall claude-code"
+    "Examples:",
+    "  $ dosu hooks uninstall claude-code",
+    "  $ dosu hooks uninstall codex"
   ].join(`
 `)).action((agent, opts) => runUninstall(agent, opts));
   cmd.command("doctor").description("Diagnose Dosu hook config, auth, deployment, and backend connectivity").option("--dir <path>", "Project root (defaults to current directory)").option("--json", "Emit machine-readable JSON", false).action((opts) => runDoctor(opts));
@@ -14271,8 +14462,8 @@ init_skill_update_check();
 init_config();
 init_logger();
 var import_picocolors24 = __toESM(require_picocolors(), 1);
-import { existsSync as existsSync12, mkdirSync as mkdirSync7, readFileSync as readFileSync10, writeFileSync as writeFileSync6 } from "node:fs";
-import { join as join22 } from "node:path";
+import { existsSync as existsSync13, mkdirSync as mkdirSync7, readFileSync as readFileSync11, writeFileSync as writeFileSync6 } from "node:fs";
+import { join as join23 } from "node:path";
 var CACHE_FILENAME2 = "update-check.json";
 var CHECK_INTERVAL_MS2 = 24 * 60 * 60 * 1000;
 var FETCH_TIMEOUT_MS2 = 5000;
@@ -14295,14 +14486,14 @@ function isNewerVersion(latest, current) {
   return false;
 }
 function getCachePath2() {
-  return join22(getConfigDir(), CACHE_FILENAME2);
+  return join23(getConfigDir(), CACHE_FILENAME2);
 }
 function readCache() {
   try {
     const path2 = getCachePath2();
-    if (!existsSync12(path2))
+    if (!existsSync13(path2))
       return null;
-    const data = JSON.parse(readFileSync10(path2, "utf-8"));
+    const data = JSON.parse(readFileSync11(path2, "utf-8"));
     if (typeof data.lastCheck === "number" && typeof data.latestVersion === "string") {
       return data;
     }
@@ -14314,7 +14505,7 @@ function readCache() {
 function writeCache(cache) {
   try {
     const dir = getConfigDir();
-    if (!existsSync12(dir)) {
+    if (!existsSync13(dir)) {
       mkdirSync7(dir, { recursive: true, mode: 448 });
     }
     writeFileSync6(getCachePath2(), JSON.stringify(cache), { mode: 384 });
@@ -14604,7 +14795,7 @@ Use 'dosu mcp add <agent>' to add Dosu MCP to a tool.`);
     if (opts.tail !== undefined) {
       const n = typeof opts.tail === "string" ? parseInt(opts.tail, 10) || 50 : 50;
       try {
-        const content = readFileSync11(logPath, "utf-8");
+        const content = readFileSync12(logPath, "utf-8");
         const lines = content.split(`
 `);
         console.log(lines.slice(-n).join(`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dosu/cli",
-  "version": "0.18.1",
+  "version": "0.19.0",
   "type": "module",
   "description": "Dosu CLI - Manage MCP servers for AI tools",
   "license": "MIT",