@bakapiano/ccsm 0.1.0 → 0.3.0

package/CLAUDE.md

@@ -19,6 +19,8 @@ Then open http://localhost:7777.
 
 Default port `7777`, default workDir `~/ccsm-workspaces`. Config + snapshots live at `~/.ccsm/` (override with `CCSM_HOME=<path>`). All settings editable through the Config panel (`~/.ccsm/config.json` on disk). Notable knobs:
 
+- `port` (default `7777`) — preferred listen port. If taken, ccsm tries `+1..+9` then asks the OS for any free port. The startup log prints the actual URL so you always see where it ended up.
+- `browserMode` (default `app`) — how to open the UI on server start. `app` finds Edge or Chrome and spawns it with `--app=<url> --user-data-dir=<DATA_DIR>/browser-profile` for a chromeless webview-style window (no tabs, no address bar). `tab` opens the default browser as a regular tab. `none` skips opening. Legacy `autoOpenBrowser: false` still maps to `none` for back-compat.
 - `claudeCommand` (default `"claude"`) — what gets `--resume`'d or freshly invoked inside the new terminal. Can be an exe (`claude`, `claude.exe`), a PowerShell alias or function (`ccp`), or any wrapper script — see `commandShell` below.
 - `terminal` — `wt` | `powershell` | `pwsh` | `cmd`. wt opens a fresh window per launch (`wt -w new` is set to defeat the "fold into existing window" setting some users have). The other three each spawn via `cmd /c start ... <shell>`.
 - `commandShell` (default `pwsh`) — only consulted when `terminal=wt`. Values `pwsh` / `powershell` wrap `claudeCommand` inside `<shell> -NoExit -NoLogo -Command "Set-Location ...; & '<cmd>' '<args>'..."` so PowerShell aliases / functions / profile-defined names (like `ccp` from `$PROFILE`) resolve. `none` runs the command directly via wt (raw `CreateProcess`) — fine if `claudeCommand` is an actual exe on PATH, broken for aliases. `pwsh` / `powershell` kinds already wrap natively so this knob doesn't affect them; `cmd` kind has no shell concept for aliases.

package/lib/config.js

@@ -22,6 +22,10 @@ const DEFAULTS = {
   terminal: 'wt',
   commandShell: 'pwsh',
   autoFocusOnLaunch: true,
+  // 'app'  — Edge/Chrome --app=<url> chromeless window (looks like a desktop app)
+  // 'tab'  — open in default browser as a normal tab
+  // 'none' — don't open anything
+  browserMode: 'app',
   // Add the repos you most often need on hand. The "new session" button
   // clones any selected entries into the workspace before launching claude.
   // Example shape:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bakapiano/ccsm",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Claude Code Session Manager — Windows web UI to manage many concurrent claude sessions: live list, snapshot/restore, focus existing window, new session in an isolated workspace with repo clones",
   "license": "MIT",
   "main": "server.js",

package/public/app.js

@@ -165,6 +165,9 @@ function renderConfig() {
   $('#cfgClaudeCommand').value = state.config.claudeCommand || 'claude';
   $('#cfgCommandShell').value = state.config.commandShell || 'pwsh';
   $('#cfgAutoFocus').checked = state.config.autoFocusOnLaunch !== false;
+  $('#cfgBrowserMode').value =
+    state.config.browserMode ||
+    (state.config.autoOpenBrowser === false ? 'none' : 'app');
   const termSel = $('#cfgTerminal');
   termSel.innerHTML = (state.terminals || []).map((t) =>
     `<option value="${escapeHtml(t.name)}" ${t.name === state.config.terminal ? 'selected' : ''}>${escapeHtml(t.name)} (${escapeHtml(t.processName)})</option>`
@@ -204,6 +207,7 @@ function readConfigFromForm() {
     terminal: $('#cfgTerminal').value || 'wt',
     commandShell: $('#cfgCommandShell').value || 'pwsh',
     autoFocusOnLaunch: $('#cfgAutoFocus').checked,
+    browserMode: $('#cfgBrowserMode').value || 'app',
     finderPrompt: $('#cfgFinderPrompt').value,
     repos,
   };

package/public/index.html

@@ -123,6 +123,13 @@
             <input id="cfgAutoFocus" type="checkbox" />
             <span style="color: var(--text);">auto-focus newly launched window</span>
           </label>
+          <label>browser open mode (on server start)
+            <select id="cfgBrowserMode" class="select">
+              <option value="app">app — Edge/Chrome chromeless window</option>
+              <option value="tab">tab — default browser, normal tab</option>
+              <option value="none">off — don't open anything</option>
+            </select>
+          </label>
           <label class="full">finder prompt
             <textarea id="cfgFinderPrompt" rows="3"></textarea>
           </label>

package/server.js

@@ -324,14 +324,89 @@ async function startSnapshotLoop() {
   console.log(`[snapshot] auto-saving every ${Math.round(interval / 1000)}s`);
 }
 
+// Try the preferred port, then preferred+1..+9, then let the OS pick a free
+// one. Resolves with the port the server actually bound to.
+function listenWithFallback(preferred) {
+  return new Promise((resolve, reject) => {
+    const attempt = (port, tries) => {
+      const server = app.listen(port);
+      server.once('listening', () => resolve({ server, port: server.address().port }));
+      server.once('error', (err) => {
+        if (err.code !== 'EADDRINUSE') return reject(err);
+        if (tries < 9) attempt(port + 1, tries + 1);
+        else if (tries === 9) attempt(0, tries + 1); // OS-assigned free port
+        else reject(err);
+      });
+    };
+    attempt(preferred, 0);
+  });
+}
+
+function findAppModeBrowser() {
+  const candidates = [
+    'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe',
+    'C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe',
+    'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+    process.env.LOCALAPPDATA &&
+      path.join(process.env.LOCALAPPDATA, 'Google\\Chrome\\Application\\chrome.exe'),
+    'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
+  ].filter(Boolean);
+  const fs = require('node:fs');
+  for (const p of candidates) {
+    if (fs.existsSync(p)) return p;
+  }
+  return null;
+}
+
+function openInBrowser(url, mode) {
+  if (process.platform !== 'win32' || mode === 'none') return;
+  const { spawn } = require('node:child_process');
+  const fs = require('node:fs');
+
+  if (mode === 'app') {
+    const exe = findAppModeBrowser();
+    if (exe) {
+      // Per-ccsm profile dir so we don't get the "already running, --app
+      // ignored" merge behavior of Edge/Chrome when the user has a normal
+      // window open. Lives under DATA_DIR so it's tidied with the rest.
+      const profileDir = path.join(DATA_DIR, 'browser-profile');
+      fs.mkdirSync(profileDir, { recursive: true });
+      const child = spawn(
+        exe,
+        [
+          `--app=${url}`,
+          `--user-data-dir=${profileDir}`,
+          '--window-size=1400,1000',
+          '--no-first-run',
+          '--no-default-browser-check',
+        ],
+        { detached: true, stdio: 'ignore' }
+      );
+      child.unref();
+      return;
+    }
+    console.log('[ccsm] no Edge/Chrome found for app mode, falling back to default browser');
+  }
+
+  // mode === 'tab' (or app-mode fallback)
+  const child = spawn('cmd.exe', ['/c', 'start', '', url], {
+    detached: true,
+    stdio: 'ignore',
+    windowsHide: true,
+  });
+  child.unref();
+}
+
 (async () => {
   const cfg = await loadConfig();
-  app.listen(cfg.port, () => {
-    console.log(`ccsm listening on http://localhost:${cfg.port}`);
-    console.log(`data dir:        ${DATA_DIR}`);
-    console.log(`work dir:        ${cfg.workDir}`);
-    console.log(`terminal:        ${cfg.terminal} · ${cfg.claudeCommand}${cfg.terminal === 'wt' ? ` (via ${cfg.commandShell})` : ''}`);
-  });
+  const { port } = await listenWithFallback(cfg.port);
+  const url = `http://localhost:${port}`;
+  console.log(`ccsm listening on ${url}${port !== cfg.port ? `  (requested ${cfg.port}, was taken)` : ''}`);
+  console.log(`data dir:        ${DATA_DIR}`);
+  console.log(`work dir:        ${cfg.workDir}`);
+  console.log(`terminal:        ${cfg.terminal} · ${cfg.claudeCommand}${cfg.terminal === 'wt' ? ` (via ${cfg.commandShell})` : ''}`);
+  const mode = cfg.browserMode || (cfg.autoOpenBrowser === false ? 'none' : 'app');
+  openInBrowser(url, mode);
   startSnapshotLoop();
 })().catch((err) => {
   console.error('startup failed:', err);