@bakapiano/ccsm 0.1.0 → 0.2.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.
+- `autoOpenBrowser` (default true) — after `listen()` succeeds, ccsm spawns `cmd /c start "" <url>` to open the UI in the default browser. Disable for headless / nohup setups.
 - `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,7 @@ const DEFAULTS = {
   terminal: 'wt',
   commandShell: 'pwsh',
   autoFocusOnLaunch: true,
+  autoOpenBrowser: true,
   // 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.2.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,7 @@ function renderConfig() {
   $('#cfgClaudeCommand').value = state.config.claudeCommand || 'claude';
   $('#cfgCommandShell').value = state.config.commandShell || 'pwsh';
   $('#cfgAutoFocus').checked = state.config.autoFocusOnLaunch !== false;
+  $('#cfgAutoOpenBrowser').checked = state.config.autoOpenBrowser !== false;
   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 +205,7 @@ function readConfigFromForm() {
     terminal: $('#cfgTerminal').value || 'wt',
     commandShell: $('#cfgCommandShell').value || 'pwsh',
     autoFocusOnLaunch: $('#cfgAutoFocus').checked,
+    autoOpenBrowser: $('#cfgAutoOpenBrowser').checked,
     finderPrompt: $('#cfgFinderPrompt').value,
     repos,
   };

package/public/index.html

@@ -123,6 +123,10 @@
             <input id="cfgAutoFocus" type="checkbox" />
             <span style="color: var(--text);">auto-focus newly launched window</span>
           </label>
+          <label class="full" style="flex-direction: row; align-items: center; gap: 8px;">
+            <input id="cfgAutoOpenBrowser" type="checkbox" />
+            <span style="color: var(--text);">auto-open this UI in browser on server start</span>
+          </label>
           <label class="full">finder prompt
             <textarea id="cfgFinderPrompt" rows="3"></textarea>
           </label>

package/server.js

@@ -324,14 +324,47 @@ 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 openInBrowser(url) {
+  if (process.platform !== 'win32') return;
+  const { spawn } = require('node:child_process');
+  // cmd's `start` builtin opens URL in the default browser. The empty "" is
+  // the window-title slot for `start`, otherwise `<url>` would be eaten as
+  // the title when it has spaces.
+  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})` : ''}`);
+  if (cfg.autoOpenBrowser !== false) openInBrowser(url);
   startSnapshotLoop();
 })().catch((err) => {
   console.error('startup failed:', err);