codex-plus-patcher 0.5.0 → 0.7.0

package/README.md

@@ -29,14 +29,18 @@ 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
 `webview/assets/codex-plus/`. Versioned ASAR patches install the runtime,
 built-in plugins, and the small Codex core hooks those plugins use. See
 [Runtime Plugin Support](docs/plugin-support.md) for the currently supported
-plugin interfaces.
+plugin interfaces and [Plugin Architecture](docs/plugin-architecture.md) for
+the layer rules.
 
 ## How It Works
 
@@ -112,6 +116,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.7.0",
   "private": false,
   "description": "Patch queue tool for building a local Codex Plus.app from an installed Codex.app.",
   "repository": {
@@ -21,13 +21,16 @@
   ],
   "scripts": {
     "test": "node --test",
-    "check": "node scripts/check-syntax.js"
+    "check": "node scripts/check-syntax.js",
+    "check:pr": "node scripts/safe-automerge-pr.js --check",
+    "pr:automerge": "node scripts/safe-automerge-pr.js"
   },
   "engines": {
     "node": ">=20"
   },
   "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",