token-larper 1.0.0 → 1.0.1

package/README.md

@@ -27,9 +27,9 @@ It consolidates all sessions into a real-time, interactive local dashboard runni
 
 The screens below use sample data. No local sessions or project names are included.
 
-[![Token Larper usage overview](docs/media/overview.jpg)](docs/media/walkthrough.mp4)
-
-[Watch the 20-second video walkthrough (MP4)](docs/media/walkthrough.mp4)
+<video src="https://github.com/user-attachments/assets/104c8036-694e-474b-81e1-d33576f2cc30" controls playsinline poster="https://raw.githubusercontent.com/YarooqH/tokenlarper/main/docs/media/overview.jpg" width="820">
+  <a href="docs/media/walkthrough.mp4">Watch the 20-second walkthrough</a>
+</video>
 
 | Usage breakdown | Projects |
 | --- | --- |

package/bin/cli.js

@@ -8,6 +8,29 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const rootDir = join(__dirname, "..");
 const serverScript = join(rootDir, "src", "server.ts");
 
+// Check if Token Larper is already running on the requested port
+const port = process.env.PORT || 4269;
+try {
+  const res = await fetch(`http://127.0.0.1:${port}/api/tray-status`, {
+    signal: AbortSignal.timeout(600),
+  });
+  if (res.ok) {
+    console.log(`🔥 Token Larper is already running at http://localhost:${port}`);
+    console.log(`🚀 Opening dashboard in your default browser...`);
+    const cmd =
+      process.platform === "win32"
+        ? `start http://localhost:${port}`
+        : process.platform === "darwin"
+        ? `open http://localhost:${port}`
+        : `xdg-open http://localhost:${port}`;
+    const { exec } = await import("node:child_process");
+    exec(cmd);
+    process.exit(0);
+  }
+} catch {
+  // Server is not running yet, proceed with startup
+}
+
 // If executed directly inside Bun runtime
 if (typeof Bun !== "undefined") {
   await import(serverScript);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "token-larper",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Token Larper — Multi-Harness AI Coding Usage & Cost Telemetry Dashboard powered by ccusage",
   "type": "module",
   "license": "MIT",

package/src/server.ts

@@ -48,23 +48,49 @@ function isAllowedMutation(req: Request, port: number): boolean {
   return (req.headers.get("content-type") || "").toLowerCase().startsWith("application/json");
 }
 
+// Check if Token Larper is already running on the target port
+try {
+  const existing = await fetch(`http://127.0.0.1:${PORT}/api/tray-status`, {
+    signal: AbortSignal.timeout(600),
+  });
+  if (existing.ok) {
+    console.log(`🔥 Token Larper is already running at http://localhost:${PORT}`);
+    console.log(`🚀 Opening dashboard in your default browser...`);
+    const cmd =
+      process.platform === "win32"
+        ? `start http://localhost:${PORT}`
+        : process.platform === "darwin"
+        ? `open http://localhost:${PORT}`
+        : `xdg-open http://localhost:${PORT}`;
+    const { exec } = await import("node:child_process");
+    exec(cmd);
+    process.exit(0);
+  }
+} catch {
+  // Not running, proceed with startup
+}
+
 // Warm cached usage before the first dashboard request.
 void getDashboardData();
 
-const server = Bun.serve({
-  port: PORT,
-  hostname: "127.0.0.1",
-  idleTimeout: 120,
-  async fetch(req) {
-    const url = new URL(req.url);
-    const port = server.port ?? PORT;
-
-    if (!isAllowedHost(req.headers.get("host"), port)) {
-      return new Response("Forbidden", { status: 403 });
-    }
-    if (req.method !== "GET" && req.method !== "HEAD" && !isAllowedMutation(req, port)) {
-      return new Response("Forbidden", { status: 403 });
-    }
+function startServer(preferredPort: number) {
+  let port = preferredPort;
+  while (port < preferredPort + 10) {
+    try {
+      return Bun.serve({
+        port,
+        hostname: "127.0.0.1",
+        idleTimeout: 120,
+        async fetch(req) {
+          const url = new URL(req.url);
+          const activePort = server?.port ?? port;
+
+          if (!isAllowedHost(req.headers.get("host"), activePort)) {
+            return new Response("Forbidden", { status: 403 });
+          }
+          if (req.method !== "GET" && req.method !== "HEAD" && !isAllowedMutation(req, activePort)) {
+            return new Response("Forbidden", { status: 403 });
+          }
 
     if (url.pathname === "/" || url.pathname === "/index.html") {
       return new Response(Bun.file(join(CLIENT_DIR, "index.html")), {
@@ -155,10 +181,22 @@ const server = Bun.serve({
       return Response.json({ ok: true, message: "Shutting down Token Larper..." });
     }
 
-    return new Response("Not Found", { status: 404 });
-  },
-});
+          return new Response("Not Found", { status: 404 });
+        },
+      });
+    } catch (err: any) {
+      if (err?.code === "EADDRINUSE" || String(err).includes("EADDRINUSE")) {
+        console.warn(`Port ${port} in use, trying port ${port + 1}...`);
+        port++;
+        continue;
+      }
+      throw err;
+    }
+  }
+  throw new Error(`Could not find an open port starting from ${preferredPort}`);
+}
 
+const server = startServer(PORT);
 startSystemTray(server.port ?? PORT);
 
 process.on("SIGINT", () => {