codex-plus-patcher 0.5.0 → 0.6.0

package/README.md

@@ -29,7 +29,10 @@ patches plus readable runtime plugins:
 - add diagnostic detail for selected app-shell errors
 - add user-message bubble color controls in Appearance settings
 - add adaptive project colors for sidebar projects, grouped threads, pinned threads, user-message accents, and the composer
+- show the active project path in the thread header with a copy action
 - add the `Toggle sidebar blur` command palette entry to blur sidebar chat and project names for the current session
+- add an `Open Developer Tools` panels command for opening the current Codex window's DevTools
+- add the `Focus project selector` command and `CmdOrCtrl+.` shortcut for new-chat project selection
 - add a fullscreen Mermaid diagram viewer with zoom controls
 
 The generated app includes a readable Codex Plus runtime under
@@ -112,6 +115,13 @@ Print the machine-readable result:
 codex-plus-patcher apply --dry-run --json
 ```
 
+Inspect menu-related patch markers in a generated app:
+
+```bash
+codex-plus-patcher menu-diagnostics \
+  --asar "~/Applications/Codex Plus.app/Contents/Resources/app.asar"
+```
+
 For local development of the CLI wrapper:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-plus-patcher",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": false,
   "description": "Patch queue tool for building a local Codex Plus.app from an installed Codex.app.",
   "repository": {
@@ -28,6 +28,7 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
+    "fzf": "0.5.2",
     "ora": "^9.4.0"
   }
 }

package/src/cli.js

@@ -62,6 +62,7 @@ function helpText() {
   return `Usage:
   codex-plus-patcher
   codex-plus-patcher apply [options]
+  codex-plus-patcher menu-diagnostics --asar <path> [--json]
   codex-plus-patcher asar-list --asar <path> [--contains <text>] [--json]
   codex-plus-patcher asar-cat --asar <path> --file <asar-path> [--json]
 
@@ -156,6 +157,67 @@ function readAsarFile({ asar, file }) {
   return { asar, file, size, content };
 }
 
+function readPackedEntry(archive, node) {
+  if (node.unpacked) return null;
+  const size = Number(node.size || 0);
+  const start = archive.dataStart + Number(node.offset || 0);
+  return archive.buffer.subarray(start, start + size).toString("utf8");
+}
+
+function menuDiagnostics({ asar }) {
+  if (!asar) throw new Error("--asar is required");
+  const archive = readAsar(asar);
+  const files = walkFiles(archive.header);
+  const commandId = "codexPlusOpenDevTools";
+  const menuTitle = "Open Developer Tools";
+  const commandMetadataFiles = [];
+  const nativeBridgeFiles = [];
+  const runtimePluginFiles = [];
+  const applicationMenuFiles = [];
+
+  for (const [file, node] of files) {
+    if (!file.endsWith(".js")) continue;
+    const content = readPackedEntry(archive, node);
+    if (content == null) continue;
+    const hasDevToolsCommand = content.includes(commandId);
+    const hasMenuTitle = content.includes(menuTitle);
+    const hasToggleBottomPanel = content.includes("Toggle Bottom Panel") || content.includes("toggleBottomPanel");
+    const hasPanelsGroup = content.includes("commandMenuGroupKey:`panels`") || content.includes('commandMenuGroupKey:"panels"');
+    const hasNativeBridge = content.includes("devtools/open") || content.includes("CPXOpenDevTools");
+    const hasRuntimePlugin = file.endsWith("/devTools.js") || content.includes('id: "devTools"');
+    const hasApplicationMenu = content.includes("Menu.setApplicationMenu") || content.includes("refreshApplicationMenu");
+
+    if (hasPanelsGroup || hasDevToolsCommand || file.includes("electron-menu-shortcuts")) {
+      commandMetadataFiles.push({
+        file,
+        hasDevToolsCommand,
+        hasMenuTitle,
+        hasToggleBottomPanel,
+        hasPanelsGroup,
+      });
+    }
+    if (hasNativeBridge) nativeBridgeFiles.push({ file, hasDevToolsOpenRequest: content.includes("devtools/open"), hasOpenDevToolsCall: content.includes("openDevTools") });
+    if (hasRuntimePlugin) runtimePluginFiles.push({ file, hasDevToolsCommand, hasDevToolsOpenRequest: content.includes("devtools/open") });
+    if (hasApplicationMenu) applicationMenuFiles.push({ file, hasDiagnosticsHook: content.includes("CPXLogMenuDiagnostics"), hasDevToolsCommand });
+  }
+
+  return {
+    asar,
+    commandId,
+    menuTitle,
+    commandMetadataFiles,
+    nativeBridgeFiles,
+    runtimePluginFiles,
+    applicationMenuFiles,
+    summary: {
+      commandMetadataFilesWithCommand: commandMetadataFiles.filter((entry) => entry.hasDevToolsCommand).map((entry) => entry.file),
+      nativeBridgeFilesWithRequest: nativeBridgeFiles.filter((entry) => entry.hasDevToolsOpenRequest).map((entry) => entry.file),
+      runtimePluginFilesWithCommand: runtimePluginFiles.filter((entry) => entry.hasDevToolsCommand).map((entry) => entry.file),
+      applicationMenuFilesWithDiagnostics: applicationMenuFiles.filter((entry) => entry.hasDiagnosticsHook).map((entry) => entry.file),
+    },
+  };
+}
+
 function formatAsarListResult(result) {
   return result.files.length > 0 ? `${result.files.join("\n")}\n` : "";
 }
@@ -164,6 +226,34 @@ function formatAsarCatResult(result) {
   return result.content;
 }
 
+function formatMenuDiagnosticsResult(result) {
+  const lines = [
+    `ASAR: ${result.asar}`,
+    `Command: ${result.commandId}`,
+    "",
+    "Command metadata bundles:",
+    ...result.commandMetadataFiles.map((entry) =>
+      `- ${entry.file}: command=${entry.hasDevToolsCommand ? "yes" : "no"}, title=${entry.hasMenuTitle ? "yes" : "no"}, bottomPanel=${entry.hasToggleBottomPanel ? "yes" : "no"}, panels=${entry.hasPanelsGroup ? "yes" : "no"}`,
+    ),
+    "",
+    "Native bridge bundles:",
+    ...result.nativeBridgeFiles.map((entry) =>
+      `- ${entry.file}: request=${entry.hasDevToolsOpenRequest ? "yes" : "no"}, openDevTools=${entry.hasOpenDevToolsCall ? "yes" : "no"}`,
+    ),
+    "",
+    "Runtime plugin bundles:",
+    ...result.runtimePluginFiles.map((entry) =>
+      `- ${entry.file}: command=${entry.hasDevToolsCommand ? "yes" : "no"}, request=${entry.hasDevToolsOpenRequest ? "yes" : "no"}`,
+    ),
+    "",
+    "Application menu bundles:",
+    ...result.applicationMenuFiles.map((entry) =>
+      `- ${entry.file}: diagnosticsHook=${entry.hasDiagnosticsHook ? "yes" : "no"}, command=${entry.hasDevToolsCommand ? "yes" : "no"}`,
+    ),
+  ];
+  return `${lines.join("\n")}\n`;
+}
+
 function formatError(error, { debug = false } = {}) {
   if (debug || process.env.CODEX_PLUS_PATCHER_DEBUG === "1") return error.stack || error.message || String(error);
   return `Error: ${error.message || String(error)}`;
@@ -232,6 +322,11 @@ async function main() {
     process.stdout.write(args.json ? `${JSON.stringify(result, null, 2)}\n` : formatAsarCatResult(result));
     return;
   }
+  if (args.command === "menu-diagnostics") {
+    const result = menuDiagnostics(args);
+    process.stdout.write(args.json ? `${JSON.stringify(result, null, 2)}\n` : formatMenuDiagnosticsResult(result));
+    return;
+  }
   if (args.command !== "apply") throw new Error(`Unknown command: ${args.command}`);
 
   const patchSets = await loadPatchSets(args);
@@ -266,10 +361,12 @@ module.exports = {
   formatAsarCatResult,
   formatAsarListResult,
   formatError,
+  formatMenuDiagnosticsResult,
   formatResult,
   helpText,
   listAsarFiles,
   loadPatchSets,
+  menuDiagnostics,
   parseArgs,
   readAsarFile,
   requirePatchSetModule,

package/src/patches/26.616.41845-4198.js

@@ -15,6 +15,8 @@ module.exports = buildCodexPlusPatchSet({
     "threadSidePanelTabs": "webview/assets/thread-side-panel-tabs-D0dd27Zf.js",
     "userMessageAttachments": "webview/assets/user-message-attachments-CgyXEK9U.js",
     "composer": "webview/assets/composer-CCuv6v-2.js",
+    "localActiveWorkspaceRootDropdown": "webview/assets/local-active-workspace-root-dropdown-ymhXI2RF.js",
+    "runCommand": "webview/assets/run-command-D6apgII3.js",
     "localTaskRow": "webview/assets/local-task-row-vTrSC6Rc.js",
     "keyboardShortcutsSearchInput": "webview/assets/keyboard-shortcuts-search-input-DjVpifwp.js",
     "src": "src-C7fSIbpz.js",

package/src/patches/26.616.51431-4212.js

@@ -15,6 +15,8 @@ module.exports = buildCodexPlusPatchSet({
     "threadSidePanelTabs": "webview/assets/thread-side-panel-tabs-D0dd27Zf.js",
     "userMessageAttachments": "webview/assets/user-message-attachments-CgyXEK9U.js",
     "composer": "webview/assets/composer-CCuv6v-2.js",
+    "localActiveWorkspaceRootDropdown": "webview/assets/local-active-workspace-root-dropdown-ymhXI2RF.js",
+    "runCommand": "webview/assets/run-command-D6apgII3.js",
     "localTaskRow": "webview/assets/local-task-row-vTrSC6Rc.js",
     "keyboardShortcutsSearchInput": "webview/assets/keyboard-shortcuts-search-input-DjVpifwp.js",
     "src": "src-C7fSIbpz.js",

package/src/patches/26.616.71553-4265.js

@@ -11,10 +11,16 @@ module.exports = buildCodexPlusPatchSet({
     "appShell": "webview/assets/app-shell-0b-x_r3Z.js",
     "errorBoundary": "webview/assets/error-boundary-BOla93vo.js",
     "generalSettings": "webview/assets/general-settings-U7DFIZBC.js",
+    "header": "webview/assets/header-DgzE38hF.js",
+    "threadPageHeader": "webview/assets/thread-page-header-D_hZ50OA.js",
+    "localConversationPage": "webview/assets/local-conversation-page-dVDt8SxG.js",
+    "threadContext": "webview/assets/thread-context-B0hBrRyZ.js",
     "sidebarProjectHoverCardSourceRows": "webview/assets/sidebar-project-hover-card-source-rows-DtE7St1r.js",
     "threadSidePanelTabs": "webview/assets/thread-side-panel-tabs-CLuB2SaS.js",
     "userMessageAttachments": "webview/assets/user-message-attachments-5G1ZKim-.js",
     "composer": "webview/assets/composer-DlMDPaCL.js",
+    "localActiveWorkspaceRootDropdown": "webview/assets/local-active-workspace-root-dropdown-B28GluSz.js",
+    "runCommand": "webview/assets/run-command-B0E8hx7Q.js",
     "localTaskRow": "webview/assets/local-task-row-CoPNn6SW.js",
     "mermaidDiagramShell": "webview/assets/mermaid-diagram-shell-BO-t9BGx.js",
     "keyboardShortcutsSearchInput": "webview/assets/keyboard-shortcuts-search-input-C1dmntOi.js",

package/src/patches/26.616.81150-4306.js

@@ -7,14 +7,21 @@ module.exports = buildCodexPlusPatchSet({
   "asarSha256": "7f45c6a6bad9c6fabe2226e8f7e0aae3792eca8c59f24305b5f2996ee4b37e40",
   "files": {
     "main": ".vite/build/main-dSxbxAhH.js",
+    "electronCommandSource": ".vite/build/src-DBVh5FZA.js",
     "appMain": "webview/assets/app-main-Dldh3K_n.js",
     "appShell": "webview/assets/app-shell-0b-x_r3Z.js",
     "errorBoundary": "webview/assets/error-boundary-BOla93vo.js",
     "generalSettings": "webview/assets/general-settings-U7DFIZBC.js",
+    "header": "webview/assets/header-DgzE38hF.js",
+    "threadPageHeader": "webview/assets/thread-page-header-D_hZ50OA.js",
+    "localConversationPage": "webview/assets/local-conversation-page-dVDt8SxG.js",
+    "threadContext": "webview/assets/thread-context-B0hBrRyZ.js",
     "sidebarProjectHoverCardSourceRows": "webview/assets/sidebar-project-hover-card-source-rows-DtE7St1r.js",
     "threadSidePanelTabs": "webview/assets/thread-side-panel-tabs-CLuB2SaS.js",
     "userMessageAttachments": "webview/assets/user-message-attachments-5G1ZKim-.js",
     "composer": "webview/assets/composer-DlMDPaCL.js",
+    "localActiveWorkspaceRootDropdown": "webview/assets/local-active-workspace-root-dropdown-B28GluSz.js",
+    "runCommand": "webview/assets/run-command-B0E8hx7Q.js",
     "localTaskRow": "webview/assets/local-task-row-CoPNn6SW.js",
     "mermaidDiagramShell": "webview/assets/mermaid-diagram-shell-BO-t9BGx.js",
     "keyboardShortcutsSearchInput": "webview/assets/keyboard-shortcuts-search-input-C1dmntOi.js",

package/src/patches/lib/common-patches.js

@@ -1,6 +1,10 @@
 const { codexPlusRuntimeAssets } = require("../../runtime/assets");
 const { replaceOnce } = require("./replace");
 const { makePatchSet } = require("./make-patch-set");
+const {
+  patchLocalActiveWorkspaceRootDropdownProjectSelectorShortcut,
+  patchRunCommandProjectSelectorShortcut,
+} = require("./project-selector-shortcut-patch");
 
 function buildCodexPlusPatchSet(config) {
   const oldTitle = "<title>Codex</title>";
@@ -11,14 +15,22 @@ function buildCodexPlusPatchSet(config) {
   const files = config.files;
   const anchors = config.anchors;
   const mainFile = files.main;
+  const electronCommandSourceFile = files.electronCommandSource;
   const appMainFile = files.appMain;
   const appShellFile = files.appShell;
   const errorBoundaryFile = files.errorBoundary;
   const generalSettingsFile = files.generalSettings;
   const sidebarProjectHoverCardSourceRowsFile = files.sidebarProjectHoverCardSourceRows;
+  const headerFile = files.header;
+  const threadPageHeaderFile = files.threadPageHeader;
+  const localConversationPageFile = files.localConversationPage;
+  const threadContextFile = files.threadContext;
+  const threadContextImportFile = threadContextFile?.split("/").pop();
   const threadSidePanelTabsFile = files.threadSidePanelTabs;
   const userMessageAttachmentsFile = files.userMessageAttachments;
   const composerFile = files.composer;
+  const localActiveWorkspaceRootDropdownFile = files.localActiveWorkspaceRootDropdown;
+  const runCommandFile = files.runCommand;
   const localTaskRowFile = files.localTaskRow;
   const mermaidDiagramShellFile = files.mermaidDiagramShell;
   const electronMenuShortcutsFile = files.electronMenuShortcuts;
@@ -133,8 +145,11 @@ function CPXDiagnosticDetails(e){return window.CodexPlus?.ui?.errors?.renderDeta
 const codexPlusMermaidHelpers = `
 function CPXMermaidDiagramProps(e){return window.CodexPlus?.ui?.mermaid?.diagramProps?.(e)}`;
 
+const codexPlusThreadHeaderHelpers = `
+function CPXThreadHeaderAccessories(e){return window.CodexPlus?.ui?.threadHeader?.renderAccessories?.(e)??null}`;
+
 const codexPlusNativeMainHelpers = `
-function CPXOpenMermaidViewer(e){let t=e?.html;if(typeof t!==\`string\`||t.length===0)return{ok:!1};let n=(0,s.join)((0,o.tmpdir)(),\`codex-plus-mermaid-\${(0,u.randomUUID)()}.html\`);(0,l.writeFileSync)(n,t,\`utf8\`);let r=new a.BrowserWindow({height:900,resizable:!0,show:!0,title:\`Mermaid diagram viewer\`,webPreferences:{contextIsolation:!0,nodeIntegration:!1,sandbox:!0},width:1400});return r.webContents.setWindowOpenHandler(e=>{try{let t=new URL(e.url);if(t.protocol===\`https:\`&&t.hostname===\`mermaid.live\`)a.shell.openExternal(e.url)}catch{}return{action:\`deny\`}}),r.on(\`closed\`,()=>{try{(0,l.unlinkSync)(n)}catch{}}),r.loadURL((0,S.pathToFileURL)(n).toString()).catch(()=>{}),{ok:!0}}function CPXRegisterNativeRequest(e){return a.ipcMain.handle(\`codex_plus:native-request\`,async(t,n)=>{if(!e.isTrustedIpcEvent(t))return{ok:!1};switch(n?.method){case\`mermaid/openViewer\`:return CPXOpenMermaidViewer(n.params);default:return{ok:!1}}})}`;
+let CPXNativeMenuItems=[],CPXRefreshApplicationMenu=null;function CPXMenuSnapshot(e){return e?.items?.map(e=>({id:e.id,label:e.label,enabled:e.enabled,visible:e.visible,accelerator:e.accelerator,submenu:CPXMenuSnapshot(e.submenu)}))}function CPXLogMenuDiagnostics(){try{let e=CPXMenuSnapshot(a.Menu.getApplicationMenu())??[],t=JSON.stringify(e),n=t.includes(\`codexPlusOpenDevTools\`)||t.includes(\`Open Developer Tools\`);if(process.env.CODEX_PLUS_MENU_DIAGNOSTICS===\`1\`||!n)console.log(\`[Codex Plus menu diagnostics] \${JSON.stringify({hasOpenDeveloperTools:n,menu:e})}\`)}catch(e){console.log(\`[Codex Plus menu diagnostics] \${JSON.stringify({error:String(e?.message??e)})}\`)}}function CPXOpenDevTools(e){try{let t=e?.sender;if(typeof t?.openDevTools!==\`function\`)return{ok:!1};return t.openDevTools(),{ok:!0}}catch{return{ok:!1}}}function CPXFocusedEvent(){let e=a.BrowserWindow.getFocusedWindow();return e&&!e.isDestroyed()?{sender:e.webContents}:null}function CPXRunNativeMenuRequest(e){switch(e?.method){case\`devtools/open\`:return CPXOpenDevTools(CPXFocusedEvent());default:return{ok:!1}}}function CPXNativeMenuTemplateItems(e){return CPXNativeMenuItems.filter(t=>t.menuId===e).map(e=>({id:e.id,label:e.label,click:()=>{CPXRunNativeMenuRequest(e.nativeRequest)}}))}function CPXRegisterNativeMenuItem(e){if(e?.id==null||e?.menuId==null||e?.label==null||e?.nativeRequest?.method==null)return{ok:!1};let t={id:String(e.id),menuId:String(e.menuId),label:String(e.label),nativeRequest:{method:String(e.nativeRequest.method),params:e.nativeRequest.params},afterId:e.afterId==null?null:String(e.afterId),afterLabel:e.afterLabel==null?null:String(e.afterLabel)};CPXNativeMenuItems=CPXNativeMenuItems.filter(e=>e.id!==t.id),CPXNativeMenuItems.push(t);try{CPXRefreshApplicationMenu?.()}catch{}return CPXLogMenuDiagnostics(),{ok:!0}}function CPXOpenMermaidViewer(e){let t=e?.html;if(typeof t!==\`string\`||t.length===0)return{ok:!1};let n=(0,s.join)((0,o.tmpdir)(),\`codex-plus-mermaid-\${(0,u.randomUUID)()}.html\`);(0,l.writeFileSync)(n,t,\`utf8\`);let r=new a.BrowserWindow({height:900,resizable:!0,show:!0,title:\`Mermaid diagram viewer\`,webPreferences:{contextIsolation:!0,nodeIntegration:!1,sandbox:!0},width:1400});return r.webContents.setWindowOpenHandler(e=>{try{let t=new URL(e.url);if(t.protocol===\`https:\`&&t.hostname===\`mermaid.live\`)a.shell.openExternal(e.url)}catch{}return{action:\`deny\`}}),r.on(\`closed\`,()=>{try{(0,l.unlinkSync)(n)}catch{}}),r.loadURL((0,S.pathToFileURL)(n).toString()).catch(()=>{}),{ok:!0}}function CPXRegisterNativeRequest(e){return a.ipcMain.handle(\`codex_plus:native-request\`,async(t,n)=>{if(!e.isTrustedIpcEvent(t))return{ok:!1};switch(n?.method){case\`native-menu/register-item\`:return CPXRegisterNativeMenuItem(n.params);case\`devtools/open\`:return CPXOpenDevTools(t);case\`mermaid/openViewer\`:return CPXOpenMermaidViewer(n.params);default:return{ok:!1}}})}`;
 
 function patchThreadSidePanelTabs(text) {
   let patched = replaceOnce(
@@ -384,6 +399,91 @@ function patchSidebarProjectHoverCardSourceRows(text) {
   );
 }
 
+function patchHeader(text) {
+  let patched = replaceOnce(
+    text,
+    `import{Z as r,a as i,s as a}from"./app-scope-CWE-zIhQ.js";`,
+    `import{Z as r,a as i,a as CPX_readAtom,s as a}from"./app-scope-CWE-zIhQ.js";`,
+    "thread header atom reader alias import anchor",
+  );
+  patched = replaceOnce(
+    patched,
+    `import{t as ee}from"./tooltip-B-u9JAuV.js";`,
+    `import{t as ee,t as CPX_Tooltip}from"./tooltip-B-u9JAuV.js";`,
+    "thread header tooltip alias import anchor",
+  );
+  patched = replaceOnce(
+    patched,
+    `import{t as _e}from"./dock-DAmmeMut.js";`,
+    `import{t as _e}from"./dock-DAmmeMut.js";import{n as CPX_headerCwd,i as CPX_headerHostId}from"./${threadContextImportFile}";`,
+    "thread header context import anchor",
+  );
+  patched = replaceOnce(
+    patched,
+    "function lt(e){let t=(0,Z.c)(68),",
+    `${codexPlusThreadHeaderHelpers}function lt(e){let t=(0,Z.c)(72),`,
+    "thread header accessory helper insertion anchor",
+  );
+  patched = replaceOnce(
+    patched,
+    "let C;t[36]!==c||t[37]!==g||t[38]!==i?(C=(0,Q.jsx)(`div`,{className:`mr-3 line-clamp-1 flex min-w-0 flex-1 items-center gap-1 truncate`,style:{viewTransitionName:`header-title`},children:i?(0,Q.jsxs)(`div`,{className:`flex min-w-0 flex-1 items-center gap-1`,children:[(0,Q.jsx)(mt,{onClick:c}),(0,Q.jsx)(x,{color:`ghostActive`,type:`button`,onClick:u,className:`min-w-0 flex-1 truncate !px-0 !py-0 text-left text-sm text-token-foreground hover:!bg-transparent hover:opacity-80 electron:font-medium`,children:(0,Q.jsx)(`span`,{className:`truncate`,children:i})})]}):(0,Q.jsx)(`span`,{className:`text-token-description-foreground`,children:(0,Q.jsx)(pt,{mergedTasks:g,onBack:c,showBackButton:!0})})}),t[36]=c,t[37]=g,t[38]=i,t[39]=C):C=t[39];",
+    "let CPX_headerContext={cwd:CPX_readAtom(CPX_headerCwd),hostId:CPX_readAtom(CPX_headerHostId)},CPX_headerAccessories=CPXThreadHeaderAccessories({context:CPX_headerContext,deps:{jsx:Q.jsx,jsxs:Q.jsxs,Tooltip:CPX_Tooltip}});let C;t[36]!==c||t[37]!==g||t[38]!==i||t[68]!==CPX_headerAccessories?(C=(0,Q.jsx)(`div`,{className:`mr-3 line-clamp-1 flex min-w-0 flex-1 items-center gap-1 truncate`,style:{viewTransitionName:`header-title`},children:i?(0,Q.jsxs)(`div`,{className:`flex min-w-0 flex-1 items-center gap-1`,children:[(0,Q.jsx)(mt,{onClick:c}),(0,Q.jsx)(x,{color:`ghostActive`,type:`button`,onClick:u,className:`min-w-0 flex-1 truncate !px-0 !py-0 text-left text-sm text-token-foreground hover:!bg-transparent hover:opacity-80 electron:font-medium`,children:(0,Q.jsx)(`span`,{className:`truncate`,children:i})}),CPX_headerAccessories]}):(0,Q.jsx)(`span`,{className:`text-token-description-foreground`,children:(0,Q.jsx)(pt,{mergedTasks:g,onBack:c,showBackButton:!0})})}),t[36]=c,t[37]=g,t[38]=i,t[68]=CPX_headerAccessories,t[39]=C):C=t[39];",
+    "thread header accessory render anchor",
+  );
+  patched = replaceOnce(
+    patched,
+    "t[53]!==A||t[54]!==b||t[55]!==S||t[56]!==C?(M=(0,Q.jsxs)(`div`,{className:b,children:[S,C,A]}),t[53]=A,t[54]=b,t[55]=S,t[56]=C,t[57]=M):M=t[57]",
+    "t[53]!==A||t[54]!==b||t[55]!==S||t[56]!==C?(M=(0,Q.jsxs)(`div`,{className:b,children:[S,C,A]}),t[53]=A,t[54]=b,t[55]=S,t[56]=C,t[57]=M):M=t[57]",
+    "thread header accessory mount anchor",
+  );
+  return patched;
+}
+
+function patchThreadPageHeader(text) {
+  let patched = text;
+  patched = replaceOnce(
+    patched,
+    "function c(e){let t=(0,o.c)(21),",
+    `${codexPlusThreadHeaderHelpers}function c(e){let t=(0,o.c)(24),`,
+    "thread page header helper insertion anchor",
+  );
+  patched = replaceOnce(
+    patched,
+    "let t=(0,o.c)(24),{start:c,startActions:l,env:u,secondary:d,trailing:f,hostConfig:p}=e,m;",
+    "let t=(0,o.c)(24),{start:c,startActions:l,env:u,secondary:d,trailing:f,hostConfig:p,cwd:CPX_headerCwd}=e,CPX_headerContext={cwd:CPX_headerCwd,hostId:p?.id??null,header:{env:u,hostDisplayName:p?.display_name??null,startText:typeof c==`string`?c:null,secondaryText:typeof d==`string`?d:null,hasTrailing:f!=null}},CPX_headerAccessories=CPXThreadHeaderAccessories({context:CPX_headerContext,deps:{jsx:s.jsx,jsxs:s.jsxs}}),m;",
+    "thread page header accessory render anchor",
+  );
+  patched = replaceOnce(
+    patched,
+    "t[8]!==l||t[9]!==v||t[10]!==y||t[11]!==b?(x=(0,s.jsxs)(`div`,{className:`text-md flex min-w-0 items-center gap-2 truncate text-base electron:font-medium`,children:[v,y,b,l]}),t[8]=l,t[9]=v,t[10]=y,t[11]=b,t[12]=x):x=t[12]",
+    "t[8]!==l||t[9]!==v||t[10]!==y||t[11]!==b||t[21]!==CPX_headerAccessories?(x=(0,s.jsxs)(`div`,{className:`text-md flex min-w-0 items-center gap-2 truncate text-base electron:font-medium`,children:[v,y,b,CPX_headerAccessories,l]}),t[8]=l,t[9]=v,t[10]=y,t[11]=b,t[21]=CPX_headerAccessories,t[12]=x):x=t[12]",
+    "thread page header accessory mount anchor",
+  );
+  return patched;
+}
+
+function patchLocalConversationPageHeader(text) {
+  let patched = replaceOnce(
+    text,
+    "function Tt(e){let t=(0,Y.c)(42),",
+    `${codexPlusThreadHeaderHelpers}function Tt(e){let t=(0,Y.c)(45),`,
+    "local conversation header helper insertion anchor",
+  );
+  patched = replaceOnce(
+    patched,
+    "let t=(0,Y.c)(45),{conversationId:n,getConversationMarkdown:r,markdownParentConversationId:a,title:o,titleSuffix:s,cwd:c,canPin:l,hideProjectMetadata:d,hideForkActions:f}=e,p=l===void 0?!0:l,m=d===void 0?!1:d,h=A(),g;",
+    "let t=(0,Y.c)(45),{conversationId:n,getConversationMarkdown:r,markdownParentConversationId:a,title:o,titleSuffix:s,cwd:c,canPin:l,hideProjectMetadata:d,hideForkActions:f}=e,CPX_headerContext={cwd:c,hostId:u(i(O,n)).id,header:{surface:`local-conversation`,titleText:typeof o==`string`?o:null}},CPX_headerAccessories=CPXThreadHeaderAccessories({context:CPX_headerContext,deps:{jsx:Z.jsx,jsxs:Z.jsxs}}),p=l===void 0?!0:l,m=d===void 0?!1:d,h=A(),g;",
+    "local conversation header accessory render anchor",
+  );
+  patched = replaceOnce(
+    patched,
+    "t[38]!==F||t[39]!==I||t[40]!==L?(z=(0,Z.jsx)(`div`,{className:`draggable grid w-full min-w-0 grid-cols-[minmax(0,1fr)] items-center gap-x-4 electron:h-toolbar extension:py-row-y`,children:(0,Z.jsxs)(`div`,{className:`flex min-w-0 items-center gap-2 truncate text-base electron:font-medium`,children:[F,I,L,R]})}),t[38]=F,t[39]=I,t[40]=L,t[41]=z):z=t[41]",
+    "t[38]!==F||t[39]!==I||t[40]!==L||t[42]!==CPX_headerAccessories?(z=(0,Z.jsx)(`div`,{className:`draggable grid w-full min-w-0 grid-cols-[minmax(0,1fr)] items-center gap-x-4 electron:h-toolbar extension:py-row-y`,children:(0,Z.jsxs)(`div`,{className:`flex min-w-0 items-center gap-2 truncate text-base electron:font-medium`,children:[F,I,L,CPX_headerAccessories,R]})}),t[38]=F,t[39]=I,t[40]=L,t[42]=CPX_headerAccessories,t[41]=z):z=t[41]",
+    "local conversation header accessory mount anchor",
+  );
+  return patched;
+}
+
 const codexPlusProjectColorHelpers = `
 function CPXHostProjectRowProps(e){return window.CodexPlus?.ui?.sidebar?.projectRowProps?.({project:e})}function CPXHostThreadRowProps(e){return window.CodexPlus?.ui?.sidebar?.threadRowProps?.({project:e})}function CPXHostUserBubbleProps(e){return window.CodexPlus?.ui?.message?.userBubbleProps?.(e)}function CPXHostComposerSurfaceProps(e){return window.CodexPlus?.ui?.composer?.surfaceProps?.(e)}`;
 
@@ -497,7 +597,7 @@ function patchElectronMenuShortcuts(text) {
   return replaceOnce(
     text,
     "{id:`toggleSidebar`,titleIntlId:`codex.command.toggleSidebar`,descriptionIntlId:`codex.commandDescription.toggleSidebar`,commandMenuGroupKey:`panels`,commandMenu:!0,electron:{menuTitle:`Toggle Sidebar`,menuTitleIntlId:`codex.commandMenuTitle.toggleSidebar`,defaultKeybindings:[{key:`CmdOrCtrl+B`}]}},{id:`toggleBottomPanel`,",
-    "{id:`toggleSidebar`,titleIntlId:`codex.command.toggleSidebar`,descriptionIntlId:`codex.commandDescription.toggleSidebar`,commandMenuGroupKey:`panels`,commandMenu:!0,electron:{menuTitle:`Toggle Sidebar`,menuTitleIntlId:`codex.commandMenuTitle.toggleSidebar`,defaultKeybindings:[{key:`CmdOrCtrl+B`}]}},...(window.CodexPlus?.ui?.commands?.commandMetadata?.()??[]),{id:`toggleBottomPanel`,",
+    "{id:`toggleSidebar`,titleIntlId:`codex.command.toggleSidebar`,descriptionIntlId:`codex.commandDescription.toggleSidebar`,commandMenuGroupKey:`panels`,commandMenu:!0,electron:{menuTitle:`Toggle Sidebar`,menuTitleIntlId:`codex.commandMenuTitle.toggleSidebar`,defaultKeybindings:[{key:`CmdOrCtrl+B`}]}},{id:`codexPlus.focusProjectSelector`,title:`Focus project selector`,description:`Focus or open the new chat project selector`,commandMenuGroupKey:`workspace`,commandMenu:!0,electron:{menuTitle:`Focus project selector`,defaultKeybindings:[{key:`CmdOrCtrl+.`}]}},...(window.CodexPlus?.ui?.commands?.commandMetadata?.()?.filter?.(e=>e.id!==`codexPlus.focusProjectSelector`)??[]),{id:`toggleBottomPanel`,",
     "sidebar blur command palette metadata anchor",
   );
 }
@@ -583,6 +683,27 @@ function patchMainNativeBridge(text) {
   );
 }
 
+function patchMainMenuDiagnostics(text) {
+  let patched = replaceOnce(
+    text,
+    "He={...b(`toggleSidePanel`),click:async()=>{let e=await y();e&&_.sendMessageToWindow(e,{type:`toggle-diff-panel`})}},Ue=",
+    "He={...b(`toggleSidePanel`),click:async()=>{let e=await y();e&&_.sendMessageToWindow(e,{type:`toggle-diff-panel`})}},Ue=",
+    "codex plus menu template helper presence anchor",
+  );
+  patched = replaceOnce(
+    patched,
+    "He,We,{type:`separator`}",
+    "He,We,...CPXNativeMenuTemplateItems(`view-menu`),{type:`separator`}",
+    "codex plus view menu template items anchor",
+  );
+  return replaceOnce(
+    patched,
+    "me.refreshApplicationMenu(),w(`application menu refreshed`,A),",
+    "CPXRefreshApplicationMenu=()=>me.refreshApplicationMenu(),me.refreshApplicationMenu(),CPXLogMenuDiagnostics(),w(`application menu refreshed`,A),",
+    "codex plus menu diagnostics refresh anchor",
+  );
+}
+
 return makePatchSet({
     id: config.id,
     codexVersion: config.codexVersion,
@@ -636,6 +757,14 @@ return makePatchSet({
         [composerFile, patchComposerProjectColors],
       ],
     },
+    ...(headerFile ? [{
+      id: "project-path-header",
+      fileTransforms: [
+        [headerFile, patchHeader],
+        ...(threadPageHeaderFile ? [[threadPageHeaderFile, patchThreadPageHeader]] : []),
+        ...(localConversationPageFile ? [[localConversationPageFile, patchLocalConversationPageHeader]] : []),
+      ],
+    }] : []),
     {
       id: "sidebar-name-blur",
       fileTransforms: [
@@ -644,11 +773,19 @@ return makePatchSet({
         [keyboardShortcutsSearchInputFile, patchKeyboardShortcutsSearchInput],
       ],
     },
-    ...(mermaidDiagramShellFile ? [{
+    {
+      id: "project-selector-shortcut",
+      fileTransforms: [
+        [localActiveWorkspaceRootDropdownFile, patchLocalActiveWorkspaceRootDropdownProjectSelectorShortcut],
+        [runCommandFile, patchRunCommandProjectSelectorShortcut],
+      ],
+    },
+    ...(mainFile ? [{
       id: "codex-plus-native-bridge",
       fileTransforms: [
         [preloadFile, patchPreloadNativeBridge],
         [mainFile, patchMainNativeBridge],
+        ...(electronCommandSourceFile ? [[mainFile, patchMainMenuDiagnostics]] : []),
       ],
     }] : []),
     ...(mermaidDiagramShellFile ? [{

package/src/patches/lib/project-selector-shortcut-patch.js

@@ -0,0 +1,54 @@
+const { replaceOnce } = require("./replace");
+
+function patchLocalActiveWorkspaceRootDropdownProjectSelectorShortcut(text) {
+  let patched = replaceOnce(
+    text,
+    "Ne=r();function Pe(e){let t=(0,Ne.c)(42),",
+    "Ne=r();function CPXProjectSelectorFuzzyFilter(e,t){let n=String(t??``).trim().toLowerCase();return window.CodexPlus?.ui?.projectSelector?.fuzzyFilter?.(e,t)??(n?e.filter(e=>[e.label,e.repositoryData?.rootFolder??``,e.path??``,e.hostDisplayName??``].some(e=>String(e??``).toLowerCase().includes(n))):e)}function CPXProjectSelectorFuzzyHighlight(e,t){return window.CodexPlus?.ui?.projectSelector?.fuzzyHighlight?.({text:e,query:t,jsx:H.jsx})??e}function CPXProjectSelectorAcceptFirst(e,t,n,r){let i=t?.[0];if(e?.key!==`Enter`||String(r??``).trim().length===0||i==null)return;e.preventDefault?.(),e.stopPropagation?.(),n(i.projectId)}function Pe(e){let t=(0,Ne.c)(42),",
+    "project selector fuzzy search adapter insertion anchor",
+  );
+  patched = replaceOnce(
+    patched,
+    "let e=h.trim().toLowerCase();v=n.filter(t=>{if(!e)return!0;let n=t.repositoryData?.rootFolder??``;return[t.label,n,t.path??``,t.hostDisplayName??``].some(t=>t.toLowerCase().includes(e))});",
+    "v=CPXProjectSelectorFuzzyFilter(n,h);",
+    "project selector fuzzy search filter anchor",
+  );
+  patched = replaceOnce(
+    patched,
+    "S=(0,H.jsx)(ve,{value:h,onChange:o,placeholder:s,className:`mb-1`})",
+    "S=(0,H.jsx)(ve,{value:h,onChange:o,onKeyDown:e=>CPXProjectSelectorAcceptFirst(e,v,i,h),placeholder:s,className:`mb-1`})",
+    "project selector accept first match keydown anchor",
+  );
+  patched = replaceOnce(
+    patched,
+    "(0,H.jsx)(`span`,{className:`truncate`,children:e.label})",
+    "(0,H.jsx)(`span`,{className:`truncate`,children:CPXProjectSelectorFuzzyHighlight(e.label,h)})",
+    "project selector fuzzy search highlight anchor",
+  );
+  patched = replaceOnce(
+    patched,
+    "function Ie(e){let t=(0,Ne.c)(81),",
+    "function CPXProjectSelectorTrigger(e,t){return Me.isValidElement(e)?Me.cloneElement(e,{...e.props,\"data-codex-plus-project-selector-trigger\":!0,\"data-codex-plus-project-selector-variant\":t}):e}function Ie(e){let t=(0,Ne.c)(81),",
+    "project selector shortcut helper insertion anchor",
+  );
+  return replaceOnce(
+    patched,
+    "at=(0,H.jsx)(ye,{open:f,onOpenChange:g,onCloseAutoFocus:Y,align:tt,disabled:O,triggerButton:X,contentWidth:`workspace`,contentMaxHeight:`tall`,children:$})",
+    "at=(0,H.jsx)(ye,{open:f,onOpenChange:g,onCloseAutoFocus:Y,align:tt,disabled:O,triggerButton:CPXProjectSelectorTrigger(X,k),contentWidth:`workspace`,contentMaxHeight:`tall`,children:$})",
+    "project selector shortcut final dropdown trigger anchor",
+  );
+}
+
+function patchRunCommandProjectSelectorShortcut(text) {
+  return replaceOnce(
+    text,
+    "],[`openFolder`,()=>{r()}],[`toggleSidebar`,",
+    "],[`codexPlus.focusProjectSelector`,()=>{window.CodexPlus?.commands?.run?.(`codexPlus.focusProjectSelector`)}],[`openFolder`,()=>{r()}],[`toggleSidebar`,",
+    "project selector shortcut command dispatch anchor",
+  );
+}
+
+module.exports = {
+  patchLocalActiveWorkspaceRootDropdownProjectSelectorShortcut,
+  patchRunCommandProjectSelectorShortcut,
+};

package/src/runtime/assets.js

@@ -11,7 +11,11 @@ const runtimeFiles = [
   ["webview/assets/codex-plus/plugins/diagnosticErrors.js", "plugins/diagnosticErrors.js"],
   ["webview/assets/codex-plus/plugins/userBubbleColors.js", "plugins/userBubbleColors.js"],
   ["webview/assets/codex-plus/plugins/projectColors.js", "plugins/projectColors.js"],
+  ["webview/assets/codex-plus/plugins/projectPathHeader.js", "plugins/projectPathHeader.js"],
   ["webview/assets/codex-plus/plugins/sidebarNameBlur.js", "plugins/sidebarNameBlur.js"],
+  ["webview/assets/codex-plus/plugins/devTools.js", "plugins/devTools.js"],
+  ["webview/assets/codex-plus/vendor/fzf.umd.js", "../../node_modules/fzf/dist/fzf.umd.js"],
+  ["webview/assets/codex-plus/plugins/projectSelectorShortcut.js", "plugins/projectSelectorShortcut.js"],
   ["webview/assets/codex-plus/plugins/mermaidFullscreen.js", "plugins/mermaidFullscreen.js"],
 ];
 

package/src/runtime/plugins/devTools.js

@@ -0,0 +1,33 @@
+(function () {
+  const CodexPlus = window.CodexPlus;
+  CodexPlus.registerPlugin(
+    CodexPlus.definePlugin({
+      id: "devTools",
+      name: "Developer Tools",
+      description: "Registers the Open Developer Tools command.",
+      required: true,
+      commands: [
+        {
+          id: "codexPlusOpenDevTools",
+          title: "Open Developer Tools",
+          description: "Open DevTools for the current Codex window",
+          menu: { groups: ["panels"] },
+          palette: { enabled: true, keywords: ["devtools", "developer", "console"] },
+          shortcut: { defaultKeybindings: [] },
+          run() {
+            return CodexPlus.native.request("devtools/open").catch(() => ({ ok: false }));
+          },
+        },
+      ],
+      start(api) {
+        api.nativeMenus.registerItem({
+          id: "codexPlusOpenDevTools",
+          menuId: "view-menu",
+          afterLabel: "Find",
+          label: "Open Developer Tools",
+          nativeRequest: { method: "devtools/open" },
+        });
+      },
+    }),
+  );
+})();

package/src/runtime/plugins/projectPathHeader.js

@@ -0,0 +1,116 @@
+(function (globalObject) {
+  function pathFromContext(context) {
+    const value = context?.cwd ?? context?.project?.cwd ?? context?.project?.path ?? null;
+    if (typeof value !== "string") return "";
+    return value.trim();
+  }
+
+  function middleTruncate(value, maxLength = 46) {
+    const text = String(value || "");
+    if (text.length <= maxLength) return text;
+    if (maxLength <= 5) return text.slice(0, maxLength);
+    const keep = maxLength - 3;
+    const start = Math.ceil(keep / 2);
+    const end = Math.floor(keep / 2);
+    return `${text.slice(0, start)}...${text.slice(text.length - end)}`;
+  }
+
+  function formatPathLabel(value, maxLength = 54, tailSegments = 3) {
+    const text = String(value || "");
+    if (text.length <= maxLength) return text;
+    const parts = text.split("/").filter(Boolean);
+    const tail = parts.slice(-tailSegments).join("/");
+    if (!tail) return middleTruncate(text, maxLength);
+    const prefix = "…";
+    const label = `${prefix}/${tail}`;
+    return label.length <= maxLength ? label : `${prefix}/${parts.slice(-2).join("/")}`;
+  }
+
+  function copyPath(path) {
+    return globalObject?.navigator?.clipboard?.writeText?.(path);
+  }
+
+  function diagnose(event, details) {
+    globalObject?.CodexPlus?.diagnostics?.log?.(`projectPathHeader.${event}`, details);
+  }
+
+  function ProjectPathAccessory({ context, jsx, jsxs, Tooltip }) {
+    const path = pathFromContext(context);
+    if (!path) {
+      diagnose("render.skip", {
+        reason: "missing-cwd",
+        contextKeys: context && typeof context === "object" ? Object.keys(context) : [],
+      });
+      return null;
+    }
+    const label = formatPathLabel(path);
+    diagnose("render.chip", { path, label, tooltip: typeof Tooltip === "function" });
+    const chip = jsxs("div", {
+      "data-codex-plus-project-path-header": "",
+      className:
+        "no-drag ml-1 flex min-w-0 items-center gap-1 overflow-hidden rounded border border-token-border px-1.5 py-0.5 text-xs text-token-description-foreground",
+      style: { flexShrink: 999, maxWidth: "min(24rem, 28vw)" },
+      title: path,
+      children: [
+        jsx("span", { className: "min-w-0 truncate", children: label }),
+        jsx("button", {
+          type: "button",
+          className:
+            "flex h-4 w-4 shrink-0 items-center justify-center rounded text-token-input-placeholder-foreground hover:bg-token-list-hover-background hover:text-token-foreground",
+          "aria-label": "Copy project path",
+          title: "Copy project path",
+          onClick(event) {
+            event?.preventDefault?.();
+            event?.stopPropagation?.();
+            copyPath(path);
+          },
+          children: jsx("svg", {
+            "aria-hidden": "true",
+            className: "h-3 w-3",
+            fill: "none",
+            stroke: "currentColor",
+            strokeLinecap: "round",
+            strokeLinejoin: "round",
+            strokeWidth: "2",
+            viewBox: "0 0 24 24",
+            children: [
+              jsx("rect", { x: "9", y: "9", width: "13", height: "13", rx: "2", ry: "2" }),
+              jsx("path", { d: "M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" }),
+            ],
+          }),
+        }),
+      ],
+    });
+    if (typeof Tooltip === "function") return jsx(Tooltip, { tooltipContent: path, children: chip });
+    return chip;
+  }
+
+  const exportsObject = {
+    ProjectPathAccessory,
+    copyPath,
+    formatPathLabel,
+    middleTruncate,
+    pathFromContext,
+  };
+
+  if (typeof module !== "undefined" && module.exports) {
+    module.exports = exportsObject;
+  }
+
+  const CodexPlus = globalObject?.CodexPlus;
+  if (!CodexPlus) return;
+
+  CodexPlus.registerPlugin(
+    CodexPlus.definePlugin({
+      id: "projectPathHeader",
+      name: "Project Path Header",
+      description: "Shows the active project path in the thread header.",
+      required: true,
+      exports: exportsObject,
+      start(api) {
+        diagnose("start", { hasThreadHeader: Boolean(api.ui.threadHeader) });
+        api.ui.threadHeader.addAccessory(ProjectPathAccessory);
+      },
+    }),
+  );
+})(typeof window !== "undefined" ? window : globalThis);

package/src/runtime/plugins/projectSelectorShortcut.js

@@ -0,0 +1,207 @@
+(function () {
+  const CodexPlus = window.CodexPlus;
+  const triggerSelector = "[data-codex-plus-project-selector-trigger]";
+  let keydownHandler = null;
+
+  function normalizeForFzf(value) {
+    const source = String(value ?? "");
+    const map = [];
+    let text = "";
+    let inSeparator = false;
+
+    for (let index = 0; index < source.length; index += 1) {
+      const char = source[index];
+      if (/[\s-]/.test(char)) {
+        if (!inSeparator) {
+          text += " ";
+          map.push(index);
+          inSeparator = true;
+        }
+        continue;
+      }
+      text += char;
+      map.push(index);
+      inSeparator = false;
+    }
+
+    return { map, text };
+  }
+
+  function projectSearchText(project) {
+    return [
+      project?.label,
+      project?.repositoryData?.rootFolder,
+      project?.path,
+      project?.hostDisplayName,
+    ].map((value) => normalizeForFzf(value).text.trim()).filter(Boolean).join(" ");
+  }
+
+  function fzfConstructor() {
+    return window.fzf?.Fzf;
+  }
+
+  function fallbackFilter(items, query) {
+    const needle = normalizeForFzf(query).text.trim().toLowerCase();
+    if (!needle) return items;
+    return items.filter((item) => projectSearchText(item).toLowerCase().includes(needle));
+  }
+
+  function fuzzyFilter(items, query) {
+    const list = Array.isArray(items) ? items : [];
+    const normalizedQuery = normalizeForFzf(query).text.trim();
+    if (!normalizedQuery) return list;
+
+    const Fzf = fzfConstructor();
+    if (typeof Fzf !== "function") return fallbackFilter(list, query);
+
+    return new Fzf(
+      list.map((project) => ({ project, searchText: projectSearchText(project) })),
+      { selector: (entry) => entry.searchText },
+    ).find(normalizedQuery).map((entry) => entry.item.project);
+  }
+
+  function labelPositions(text, query) {
+    const Fzf = fzfConstructor();
+    if (typeof Fzf !== "function") return null;
+
+    const normalizedText = normalizeForFzf(text);
+    const normalizedQuery = normalizeForFzf(query).text.trim();
+    if (!normalizedText.text || !normalizedQuery) return null;
+
+    const [entry] = new Fzf([normalizedText.text]).find(normalizedQuery);
+    if (!entry || typeof entry.positions?.forEach !== "function") return null;
+
+    const positions = [];
+    entry.positions.forEach((index) => positions.push(index));
+    return positions.map((index) => normalizedText.map[index]).filter((index) => Number.isInteger(index));
+  }
+
+  function fuzzyHighlight({ text, query, jsx }) {
+    if (typeof jsx !== "function") return text;
+
+    const positions = labelPositions(text, query);
+    if (positions == null || positions.length === 0) return text;
+
+    const matchedIndices = new Set(positions);
+    const parts = [];
+    let index = 0;
+    let key = 0;
+    const style = {
+      color: "var(--color-token-text-link-foreground, #2563eb)",
+    };
+
+    while (index < text.length) {
+      const isMatched = matchedIndices.has(index);
+      const start = index;
+      while (index < text.length && matchedIndices.has(index) === isMatched) index += 1;
+
+      const value = text.slice(start, index);
+      parts.push(
+        isMatched
+          ? jsx("strong", {
+              className: "font-semibold",
+              style,
+              children: value,
+            }, key++)
+          : value,
+      );
+    }
+
+    return parts;
+  }
+
+  function dispatchMouseEvent(target, type) {
+    if (typeof target.dispatchEvent !== "function") return false;
+    const EventConstructor = type === "pointerdown"
+      ? window.PointerEvent || window.MouseEvent
+      : window.MouseEvent;
+    if (typeof EventConstructor !== "function") return false;
+    target.dispatchEvent(new EventConstructor(type, {
+      bubbles: true,
+      button: 0,
+      buttons: type === "pointerdown" || type === "mousedown" ? 1 : 0,
+      cancelable: true,
+      ctrlKey: false,
+      view: window,
+    }));
+    return true;
+  }
+
+  function visibleTriggerCandidates() {
+    return Array.from(document.querySelectorAll(triggerSelector)).filter((trigger) => {
+      if (!(trigger instanceof HTMLElement)) return false;
+      if (trigger.disabled || trigger.getAttribute("aria-disabled") === "true") return false;
+      const rect = trigger.getBoundingClientRect?.();
+      return rect && rect.width > 0 && rect.height > 0;
+    });
+  }
+
+  function triggerPriority(trigger) {
+    const variant = trigger.getAttribute("data-codex-plus-project-selector-variant");
+    if (variant === "default") return 0;
+    if (variant == null || variant === "") return 1;
+    return 2;
+  }
+
+  function projectSelectorTrigger() {
+    const [trigger] = visibleTriggerCandidates().sort((left, right) => {
+      const priority = triggerPriority(left) - triggerPriority(right);
+      if (priority !== 0) return priority;
+      const leftRect = left.getBoundingClientRect();
+      const rightRect = right.getBoundingClientRect();
+      return rightRect.top - leftRect.top || rightRect.left - leftRect.left;
+    });
+    return trigger ?? null;
+  }
+
+  function focusProjectSelector() {
+    const trigger = projectSelectorTrigger();
+    if (trigger == null) return false;
+    trigger.focus?.();
+    const dispatched = [
+      dispatchMouseEvent(trigger, "pointerdown"),
+      dispatchMouseEvent(trigger, "mousedown"),
+      dispatchMouseEvent(trigger, "mouseup"),
+      dispatchMouseEvent(trigger, "click"),
+    ].some(Boolean);
+    if (!dispatched) trigger.click?.();
+    return true;
+  }
+
+  CodexPlus.registerPlugin(
+    CodexPlus.definePlugin({
+      id: "projectSelectorShortcut",
+      name: "Project Selector Shortcut",
+      description: "Registers the Focus project selector command.",
+      required: true,
+      commands: [
+        {
+          id: "codexPlus.focusProjectSelector",
+          title: "Focus project selector",
+          description: "Focus or open the new chat project selector",
+          menu: { groups: ["suggested", "workspace"] },
+          palette: { enabled: true, keywords: ["project", "selector", "new chat"] },
+          shortcut: { defaultKeybindings: [{ key: "CmdOrCtrl+." }] },
+          run: focusProjectSelector,
+        },
+      ],
+      start(api) {
+        api.ui.projectSelector = {
+          fuzzyFilter,
+          fuzzyHighlight,
+        };
+        keydownHandler = (event) => {
+          if (event.defaultPrevented || event.key !== "." || (!event.metaKey && !event.ctrlKey) || event.altKey || event.shiftKey) {
+            return;
+          }
+          if (api.commands.run("codexPlus.focusProjectSelector")) event.preventDefault();
+        };
+        document.addEventListener("keydown", keydownHandler, true);
+      },
+      stop() {
+        if (keydownHandler) document.removeEventListener("keydown", keydownHandler, true);
+        keydownHandler = null;
+      },
+    }),
+  );
+})();

package/src/runtime/runtime.js

@@ -9,6 +9,27 @@
   const styleElements = new Map();
   const settingsListeners = new Map();
   const storagePrefix = "codex-plus:plugin:";
+  const diagnosticEvents = [];
+
+  function diagnosticsEnabled() {
+    try {
+      return globalObject.localStorage?.getItem("codex-plus:diagnostics") === "1";
+    } catch {
+      return false;
+    }
+  }
+
+  function diagnose(event, details = {}) {
+    const entry = { event, details, time: new Date().toISOString() };
+    diagnosticEvents.push(entry);
+    if (diagnosticEvents.length > 200) diagnosticEvents.shift();
+    if (diagnosticsEnabled()) {
+      try {
+        console.info("[Codex Plus]", event, details);
+      } catch {}
+    }
+    return entry;
+  }
 
   function safeId(id) {
     if (typeof id !== "string" || id.trim() === "") throw new Error("Codex Plus plugin ids must be non-empty strings");
@@ -258,6 +279,34 @@
     return null;
   }
 
+  function ThreadHeaderAccessoryHost({ accessory, context, deps }) {
+    const rendered = accessory?.({ context, ...deps }) ?? null;
+    diagnose("threadHeader.accessoryHost.render", {
+      accessoryName: accessory?.name || null,
+      cwd: typeof context?.cwd === "string" ? context.cwd : null,
+      rendered: rendered != null,
+    });
+    return rendered;
+  }
+
+  function renderThreadHeaderAccessories({ context, deps } = {}) {
+    const jsx = deps?.jsx;
+    if (typeof jsx !== "function") {
+      diagnose("threadHeader.render.skip", { reason: "missing-jsx" });
+      return null;
+    }
+    diagnose("threadHeader.render", {
+      accessoryCount: CodexPlus.ui.threadHeader.accessories.length,
+      cwd: typeof context?.cwd === "string" ? context.cwd : null,
+      hostId: context?.hostId ?? null,
+      header: context?.header ?? null,
+    });
+    const rendered = CodexPlus.ui.threadHeader.accessories.map((accessory, index) =>
+      jsx(ThreadHeaderAccessoryHost, { accessory, context, deps }, `thread-header-accessory:${index}`),
+    );
+    return rendered.length === 0 ? null : rendered;
+  }
+
   function registerStyle(pluginId, cssText) {
     if (typeof document === "undefined") return null;
     const id = `codex-plus-style-${safeId(pluginId)}`;
@@ -288,6 +337,7 @@
     for (const command of plugin.commands || []) registerCommand({ ...command, plugin: plugin.id });
     if (plugin.styles) registerStyle(plugin.id, plugin.styles);
     if (plugin.required || plugin.enabledByDefault) startPlugin(plugin.id);
+    diagnose("plugin.register", { id: plugin.id, started: startedPlugins.has(plugin.id) });
     return plugin;
   }
 
@@ -296,6 +346,7 @@
     if (!plugin || startedPlugins.has(id)) return;
     plugin.start?.(CodexPlus);
     startedPlugins.add(id);
+    diagnose("plugin.start", { id });
   }
 
   function stopPlugin(id) {
@@ -305,6 +356,10 @@
     startedPlugins.delete(id);
   }
 
+  function registerNativeMenuItem(item) {
+    return CodexPlus.native.request("native-menu/register-item", item).catch(() => ({ ok: false }));
+  }
+
   const CodexPlus = {
     definePlugin,
     registerPlugin,
@@ -330,6 +385,15 @@
       composer: { surfaceDecorators: [], decorateSurface(fn) { this.surfaceDecorators.push(fn); return fn; }, surfaceProps(props) { return applyDecorators(props, this.surfaceDecorators); } },
       about: { buildInfo: [], addBuildInfo(fn) { this.buildInfo.push(fn); return fn; } },
       errors: { boundaryDecorators: [], decorateBoundary(fn) { this.boundaryDecorators.push(fn); return fn; }, renderDetails: renderErrorDetails },
+      threadHeader: {
+        accessories: [],
+        addAccessory(fn) {
+          this.accessories.push(fn);
+          diagnose("threadHeader.addAccessory", { accessoryName: fn?.name || null, accessoryCount: this.accessories.length });
+          return fn;
+        },
+        renderAccessories: renderThreadHeaderAccessories,
+      },
       mermaid: {
         diagramDecorators: [],
         decorateDiagram(fn) { this.diagramDecorators.push(fn); return fn; },
@@ -337,12 +401,20 @@
       },
     },
     commands: { register: registerCommand, run: runCommand, all: () => Array.from(commands.values()), menuItems: (group) => Array.from(commands.values()).filter((command) => commandGroups(command).includes(group)) },
+    nativeMenus: { registerItem: registerNativeMenuItem },
     settings: { define: defineSettings },
     native: { async request(method, params) { return globalObject.codexPlusNative?.request?.(method, params) ?? globalObject.CodexPlusHost?.nativeRequest?.(method, params); } },
     styles: { register: registerStyle, setRootVars },
+    diagnostics: {
+      log: diagnose,
+      snapshot() { return diagnosticEvents.slice(); },
+      clear() { diagnosticEvents.splice(0, diagnosticEvents.length); },
+      enabled: diagnosticsEnabled,
+    },
   };
 
   globalObject.CodexPlus = CodexPlus;
+  globalObject.CodexPlusDiagnostics = CodexPlus.diagnostics;
   globalObject.CodexPlusHost ||= {};
   globalObject.CodexPlusHost.register = registerHostModule;
 
@@ -352,18 +424,31 @@
     "plugins/diagnosticErrors.js",
     "plugins/userBubbleColors.js",
     "plugins/projectColors.js",
+    "plugins/projectPathHeader.js",
     "plugins/sidebarNameBlur.js",
+    "plugins/devTools.js",
+    "vendor/fzf.umd.js",
+    "plugins/projectSelectorShortcut.js",
     "plugins/mermaidFullscreen.js",
   ];
 
   if (typeof document !== "undefined") {
     const base = new URL(".", document.currentScript?.src || globalObject.location?.href || "");
-    for (const file of pluginFiles) {
-      const script = document.createElement("script");
-      script.src = new URL(file, base).href;
-      script.async = false;
-      script.defer = false;
-      document.head?.appendChild(script);
+    if (document.readyState === "loading" && typeof document.write === "function") {
+      diagnose("plugins.load", { mode: "document.write", count: pluginFiles.length });
+      for (const file of pluginFiles) {
+        const src = new URL(file, base).href.replace(/"/g, """);
+        document.write(`<script src="${src}"><\/script>`);
+      }
+    } else {
+      diagnose("plugins.load", { mode: "appendChild", count: pluginFiles.length });
+      for (const file of pluginFiles) {
+        const script = document.createElement("script");
+        script.src = new URL(file, base).href;
+        script.async = false;
+        script.defer = false;
+        document.head?.appendChild(script);
+      }
     }
   }
 })();