codex-devtools 0.1.2 → 0.1.5

package/README.md

@@ -38,7 +38,17 @@ npx codex-devtools
 bunx codex-devtools
 ```
 
-This starts a standalone HTTP server at `http://localhost:3456`.
+This launches the native Electron app window.
+
+To run web/HTTP mode explicitly:
+
+```bash
+npx codex-devtools --web
+# or
+bunx codex-devtools --web
+```
+
+Standalone mode serves at `http://localhost:3456`.
 
 ## Standalone mode
 

package/bin/codex-devtools.cjs

@@ -3,21 +3,83 @@
 
 const { existsSync } = require('node:fs');
 const { join } = require('node:path');
+const { spawn } = require('node:child_process');
 
-const standaloneEntrypoint = join(__dirname, '..', 'dist-electron', 'main', 'standalone.cjs');
+const APP_ROOT = join(__dirname, '..');
+const ELECTRON_ENTRY = join(APP_ROOT, 'dist-electron', 'main', 'index.cjs');
+const STANDALONE_ENTRY = join(APP_ROOT, 'dist-electron', 'main', 'standalone.cjs');
 
-if (!existsSync(standaloneEntrypoint)) {
-  console.error(
-    '[codex-devtools] Missing standalone bundle. Reinstall package or run a version that includes dist-electron output.',
-  );
-  process.exit(1);
+function hasArg(flag) {
+  return process.argv.includes(flag);
 }
 
-const standaloneModule = require(standaloneEntrypoint);
+function runStandalone() {
+  if (!existsSync(STANDALONE_ENTRY)) {
+    console.error('[codex-devtools] Missing standalone bundle. Reinstall package and try again.');
+    process.exit(1);
+  }
 
-if (typeof standaloneModule.startStandaloneCli !== 'function') {
-  console.error('[codex-devtools] Invalid standalone entrypoint: startStandaloneCli export not found.');
-  process.exit(1);
+  const standaloneModule = require(STANDALONE_ENTRY);
+  if (typeof standaloneModule.startStandaloneCli !== 'function') {
+    console.error('[codex-devtools] Invalid standalone entrypoint: startStandaloneCli export not found.');
+    process.exit(1);
+  }
+
+  standaloneModule.startStandaloneCli();
 }
 
-standaloneModule.startStandaloneCli();
+function runDesktop() {
+  if (!existsSync(ELECTRON_ENTRY)) {
+    console.error('[codex-devtools] Missing Electron bundle. Reinstall package and try again.');
+    process.exit(1);
+  }
+
+  let electronBinary;
+  try {
+    electronBinary = require('electron');
+  } catch (error) {
+    console.error(
+      '[codex-devtools] Electron runtime is not available. Reinstall package and ensure install scripts are enabled.',
+    );
+    if (error && error.message) {
+      console.error(`[codex-devtools] ${error.message}`);
+    }
+    process.exit(1);
+  }
+
+  const forwardedArgs = process.argv.slice(2).filter((arg) => arg !== '--desktop');
+  const child = spawn(electronBinary, [APP_ROOT, ...forwardedArgs], {
+    stdio: 'inherit',
+    env: process.env,
+  });
+
+  child.on('error', (error) => {
+    console.error('[codex-devtools] Failed to launch Electron.', error);
+    process.exit(1);
+  });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+
+    process.exit(code ?? 0);
+  });
+}
+
+if (hasArg('--help') || hasArg('-h')) {
+  console.log('codex-devtools');
+  console.log('');
+  console.log('Usage:');
+  console.log('  codex-devtools           Launch Electron desktop app (default)');
+  console.log('  codex-devtools --web     Run standalone HTTP mode');
+  console.log('  codex-devtools --desktop Force desktop mode');
+  process.exit(0);
+}
+
+if (hasArg('--web') || hasArg('--standalone')) {
+  runStandalone();
+} else {
+  runDesktop();
+}

package/dist-electron/main/index.cjs

@@ -164,9 +164,21 @@ const removeIpcHandlers = (targetIpcMain) => {
   logger$1.info("All handlers removed");
 };
 const logger = CodexServiceContext.createLogger("Main");
+const APP_DISPLAY_NAME = "codex-devtools";
 let mainWindow = null;
 let serviceContext = null;
 let removeFileChangeListener = null;
+function resolveAppIconPath() {
+  const candidates = [
+    path.join(process.cwd(), "resources/logo.png"),
+    path.join(process.cwd(), "resources/icon.png"),
+    path.join(__dirname, "../../resources/logo.png"),
+    path.join(__dirname, "../../resources/icon.png"),
+    path.join(process.resourcesPath, "resources/logo.png"),
+    path.join(process.resourcesPath, "resources/icon.png")
+  ];
+  return candidates.find((candidate) => fs.existsSync(candidate));
+}
 function getRendererIndexPath() {
   const candidates = [
     path.join(__dirname, "../../out/renderer/index.html"),
@@ -175,9 +187,12 @@ function getRendererIndexPath() {
   return candidates.find((candidate) => fs.existsSync(candidate)) ?? candidates[0];
 }
 const createWindow = () => {
+  const iconPath = resolveAppIconPath();
   const window = new electron.BrowserWindow({
+    title: APP_DISPLAY_NAME,
     width: 1200,
     height: 800,
+    ...iconPath ? { icon: iconPath } : {},
     webPreferences: {
       preload: path.join(__dirname, "../preload/index.cjs"),
       contextIsolation: true,
@@ -224,7 +239,12 @@ function disposeServices() {
     serviceContext = null;
   }
 }
+electron.app.setName(APP_DISPLAY_NAME);
 void electron.app.whenReady().then(() => {
+  const iconPath = resolveAppIconPath();
+  if (iconPath && process.platform === "darwin" && electron.app.dock) {
+    electron.app.dock.setIcon(iconPath);
+  }
   initializeServices();
   mainWindow = createWindow();
   electron.app.on("activate", () => {

package/dist-electron/main/standalone.cjs

@@ -187,7 +187,8 @@ const logger = CodexServiceContext.createLogger("Standalone");
 const __filename$1 = node_url.fileURLToPath(require("url").pathToFileURL(__filename).href);
 const __dirname$1 = path.dirname(__filename$1);
 const createStandaloneServer = async (options = {}) => {
-  const app = Fastify({ logger: true });
+  const enableHttpLogs = process.env.CODEX_DEVTOOLS_HTTP_LOGS === "1";
+  const app = Fastify({ logger: enableHttpLogs });
   const serviceContext = new CodexServiceContext.CodexServiceContext({
     sessionsPath: options.sessionsPath ?? process.env.CODEX_SESSIONS_PATH,
     configPath: options.configPath

package/out/renderer/assets/{index-r_pK0Xle.css → index-BTmVA30y.css}

@@ -555,6 +555,9 @@ video {
     max-width: 1536px;
   }
 }
+.visible {
+  visibility: visible;
+}
 .static {
   position: static;
 }
@@ -573,14 +576,6 @@ video {
 .transform {
   transform: translate(var(--tw-translate-x), var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y));
 }
-.bg-slate-950 {
-  --tw-bg-opacity: 1;
-  background-color: rgb(2 6 23 / var(--tw-bg-opacity, 1));
-}
-.text-slate-100 {
-  --tw-text-opacity: 1;
-  color: rgb(241 245 249 / var(--tw-text-opacity, 1));
-}
 .filter {
   filter: var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow);
 }
@@ -1230,6 +1225,11 @@ select {
   padding: 10px 12px;
 }
 
+:root.light .chat-user-bubble {
+  border-color: rgba(37, 99, 235, 0.24);
+  background: rgba(37, 99, 235, 0.1);
+}
+
 .chat-attachments {
   display: grid;
   gap: 8px;

package/out/renderer/assets/{index-CR8-JZrV.js → index-C1DUQHyp.js}

@@ -7734,7 +7734,7 @@ const createAppStore = (client2 = api) => create()((...args) => ({
 }));
 const useAppStore = createAppStore();
 const REFRESH_DEBOUNCE_MS = 120;
-const FALLBACK_POLL_INTERVAL_MS = 1500;
+const FALLBACK_POLL_INTERVAL_MS = 15e3;
 function initializeEventListeners(store = useAppStore, client2 = api) {
   let refreshTimer = null;
   let pollTimer = null;
@@ -7761,6 +7761,9 @@ function initializeEventListeners(store = useAppStore, client2 = api) {
     }, REFRESH_DEBOUNCE_MS);
   });
   const runFallbackRefresh = () => {
+    if (typeof document !== "undefined" && document.visibilityState !== "visible") {
+      return;
+    }
     if (polling) {
       return;
     }
@@ -11564,6 +11567,7 @@ const DateGroupedSessions = () => {
   const {
     sessions,
     sessionsLoading,
+    activeProjectCwd,
     activeSessionId,
     sessionPreviews,
     sessionUpdateBadges,
@@ -11572,6 +11576,7 @@ const DateGroupedSessions = () => {
   } = useAppStore((state) => ({
     sessions: state.sessions,
     sessionsLoading: state.sessionsLoading,
+    activeProjectCwd: state.activeProjectCwd,
     activeSessionId: state.activeSessionId,
     sessionPreviews: state.sessionPreviews,
     sessionUpdateBadges: state.sessionUpdateBadges,
@@ -11594,7 +11599,7 @@ const DateGroupedSessions = () => {
     return /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "sidebar-loading", children: "Loading sessions..." });
   }
   if (groups.length === 0) {
-    return /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "sidebar-empty", children: "No sessions found for this project." });
+    return /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "sidebar-empty", children: activeProjectCwd ? "No sessions found for this project." : "Select a project to load sessions." });
   }
   return /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "session-groups", children: groups.map((group) => /* @__PURE__ */ jsxRuntimeExports.jsxs("section", { className: "session-group", children: [
     /* @__PURE__ */ jsxRuntimeExports.jsx("h2", { className: "session-group-title", children: group.label }),
@@ -11679,6 +11684,11 @@ const Sidebar = () => {
         }
       )
     ] }),
+    !projectsLoading && projects.length === 0 ? /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { className: "sidebar-empty", children: [
+      "No projects discovered. Set ",
+      /* @__PURE__ */ jsxRuntimeExports.jsx("code", { children: "CODEX_SESSIONS_PATH" }),
+      " and restart."
+    ] }) : null,
     /* @__PURE__ */ jsxRuntimeExports.jsx(DateGroupedSessions, {})
   ] });
 };

package/out/renderer/index.html

@@ -7,10 +7,10 @@
     <link rel="icon" type="image/png" sizes="32x32" href="./assets/32x32-DQgygEFU.png" />
     <link rel="icon" type="image/png" sizes="16x16" href="./assets/16x16-B2_QkmoB.png" />
     <title>codex-devtools</title>
-    <script type="module" crossorigin src="./assets/index-CR8-JZrV.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-r_pK0Xle.css">
+    <script type="module" crossorigin src="./assets/index-C1DUQHyp.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-BTmVA30y.css">
   </head>
-  <body class="bg-slate-950 text-slate-100">
+  <body>
     <div id="root">
       <div style="padding: 16px; font: 500 14px/1.4 system-ui, -apple-system, Segoe UI, sans-serif;">
         Loading codex-devtools...

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "codex-devtools",
   "type": "module",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "description": "Desktop app for inspecting Codex session data",
   "license": "MIT",
   "author": {
@@ -27,7 +27,8 @@
     "README.md"
   ],
   "scripts": {
-    "dev": "electron-vite dev",
+    "dev": "node scripts/dev.mjs",
+    "dev:raw": "electron-vite dev",
     "build": "electron-vite build",
     "dist": "electron-builder --mac --win --linux --publish never",
     "dist:mac": "electron-builder --mac --publish never",
@@ -46,6 +47,7 @@
     "@fastify/static": "^9.0.0",
     "@tanstack/react-virtual": "^3.10.8",
     "date-fns": "^3.6.0",
+    "electron": "~40.3.0",
     "fastify": "^5.7.4",
     "lucide-react": "^0.562.0",
     "react": "^18.3.1",
@@ -59,7 +61,6 @@
     "@types/react-dom": "^18.3.0",
     "@vitejs/plugin-react": "^4.3.1",
     "autoprefixer": "^10.4.17",
-    "electron": "~40.3.0",
     "electron-builder": "^25.1.8",
     "electron-vite": "^2.3.0",
     "eslint": "^9.39.2",