codex-devtools 0.1.3 → 0.1.6

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
 
@@ -95,6 +105,7 @@ Build artifacts land in `release/`.
 | Workflow | Trigger | Action |
 |----------|---------|--------|
 | `ci.yml` | Push to `main`, PRs | Typecheck, lint, build, test |
+| `cut-release-tag.yml` | Successful `CI` on `main`, manual dispatch | Compute next semver tag and trigger release publish workflows |
 | `release.yml` | Semver tags (`v*`), manual | Cross-platform packaging |
 | `npm-publish.yml` | Semver tags (`v*`), manual | Publish to npm |
 
@@ -102,9 +113,18 @@ Required secret: `NPM_TOKEN` (npm automation token with publish + 2FA bypass).
 
 ## Releasing
 
+Release tags are cut automatically after `CI` succeeds on `main`.
+
+Automatic bump rules (Conventional Commit aware):
+
+- `major`: any commit subject with `!` (for example `feat!: ...`) or body with `BREAKING CHANGE:`
+- `minor`: at least one `feat:`
+- `patch`: `fix:`, `perf:`, `revert:`, or fallback when no release type is detected
+
+Manual override:
+
 ```bash
-npm version patch     # bumps version and creates git tag
-git push origin main --follow-tags
+gh workflow run "Cut Release Tag" --ref main -f bump=major
 ```
 
 Tags must be valid semver (`vMAJOR.MINOR.PATCH`). Pre-release metadata supported (`v1.2.3-beta.1`).

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/out/renderer/assets/{index-z5pXbBkY.css → index-BTmVA30y.css}

@@ -576,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);
 }
@@ -1233,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/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-NyaijTgK.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-z5pXbBkY.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.3",
+  "version": "0.1.6",
   "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",