gemix-dash 0.0.1 → 0.0.2

package/README.md

@@ -2,8 +2,32 @@
 
 Local web dashboard for [gemix](https://www.npmjs.com/package/gemix) accounts (`~/.gemix`).
 
-    npm start        # http://127.0.0.1:4577  (PORT env to change)
-    npm test         # smoke test
+## Installation
+
+```sh
+npm install -g gemix-dash
+```
+
+## CLI usage
+
+```sh
+gemix-dash              # start the server and open the dashboard in your browser
+gemix-dash stop         # stop the running server
+gemix-dash status       # check whether the server is running
+gemix-dash -p 8080      # start on a custom port
+gemix-dash --help       # show all options
+```
+
+> The dashboard binds to `127.0.0.1` only. A PID file is written to the OS temp directory so `gemix-dash stop` can find and terminate the process.
+
+## Development
+
+```sh
+npm start        # http://127.0.0.1:4577  (PORT env to change)
+npm test         # smoke test
+```
+
+## Features
 
 - Cards per account with real per-model limits (same source as `agy` `/usage`: Cloud Code `fetchAvailableModels`), cached 60s.
 - Add (Google link + paste code), Use (same as `gemix use`), Rename, Remove, all with confirmations.

package/bin/gemix-dash.js

@@ -1,14 +1,63 @@
 #!/usr/bin/env node
-import { server, PORT } from '../server.mjs';
+import { createServer } from 'node:net';
+import { spawn } from 'node:child_process';
+import { readFileSync, writeFileSync, rmSync, existsSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+
+// ── helpers ──────────────────────────────────────────────────────────────────
+
+const PID_FILE = path.join(tmpdir(), 'gemix-dash.pid');
+
+function readPid() {
+  try { return JSON.parse(readFileSync(PID_FILE, 'utf8')); } catch { return null; }
+}
+
+function writePid(pid, port) {
+  writeFileSync(PID_FILE, JSON.stringify({ pid, port }), 'utf8');
+}
+
+function removePid() {
+  try { rmSync(PID_FILE); } catch { /* already gone */ }
+}
+
+/** Open a URL in the default browser (cross-platform). */
+function openBrowser(url) {
+  const cmd = process.platform === 'darwin' ? 'open'
+            : process.platform === 'win32'  ? 'start'
+            : 'xdg-open';
+  spawn(cmd, [url], { detached: true, stdio: 'ignore' }).unref();
+}
+
+/** Check whether a port is already listening. */
+function portInUse(port) {
+  return new Promise((resolve) => {
+    const s = createServer();
+    s.once('error', () => resolve(true));
+    s.once('listening', () => { s.close(); resolve(false); });
+    s.listen(port, '127.0.0.1');
+  });
+}
+
+// ── arg parsing ───────────────────────────────────────────────────────────────
 
 const args = process.argv.slice(2);
+const cmd  = args[0];    // 'stop' | 'status' | undefined
+
+const portIndex = args.findIndex((a) => a === '-p' || a === '--port');
+const cliPort   = portIndex !== -1 ? Number(args[portIndex + 1]) : undefined;
 
 if (args.includes('-h') || args.includes('--help')) {
   console.log(`
-Usage: gemix-dash [options]
+Usage: gemix-dash [stop|status] [-p <port>]
 
 Local web dashboard for gemix accounts (~/.gemix)
 
+Commands:
+  (none)    Start the server and open the dashboard in your browser
+  stop      Stop a running gemix-dash server
+  status    Show whether gemix-dash is running
+
 Options:
   -p, --port <number>   Port to listen on (default: 4577 or PORT env)
   -h, --help            Show this help message
@@ -16,9 +65,75 @@ Options:
   process.exit(0);
 }
 
-const portIndex = args.findIndex((arg) => arg === '-p' || arg === '--port');
-const port = (portIndex !== -1 && Number(args[portIndex + 1])) || PORT;
+// ── stop ──────────────────────────────────────────────────────────────────────
+
+if (cmd === 'stop') {
+  const info = readPid();
+  if (!info) {
+    console.log('gemix-dash is not running.');
+    process.exit(0);
+  }
+  try {
+    process.kill(info.pid, 'SIGTERM');
+    removePid();
+    console.log(`gemix-dash (pid ${info.pid}) stopped.`);
+  } catch {
+    console.log(`Process ${info.pid} not found – cleaning up stale PID file.`);
+    removePid();
+  }
+  process.exit(0);
+}
+
+// ── status ────────────────────────────────────────────────────────────────────
+
+if (cmd === 'status') {
+  const info = readPid();
+  if (!info) {
+    console.log('gemix-dash is not running.');
+    process.exit(0);
+  }
+  try {
+    process.kill(info.pid, 0); // throws if process is gone
+    console.log(`gemix-dash is running  pid=${info.pid}  http://127.0.0.1:${info.port}`);
+  } catch {
+    console.log('gemix-dash is not running (stale PID file removed).');
+    removePid();
+  }
+  process.exit(0);
+}
+
+// ── start ─────────────────────────────────────────────────────────────────────
+
+// Dynamic import so we only load the server when we actually start.
+const { server, PORT: DEFAULT_PORT } = await import('../server.mjs');
+const port = cliPort || Number(process.env.PORT || DEFAULT_PORT);
+
+// Check if already running on this port
+if (await portInUse(port)) {
+  // If there's a PID file for this port, just open the browser
+  const info = readPid();
+  if (info && info.port === port) {
+    console.log(`gemix-dash is already running at http://127.0.0.1:${port}`);
+    openBrowser(`http://127.0.0.1:${port}`);
+    process.exit(0);
+  }
+  console.error(`Error: port ${port} is already in use by another process.`);
+  process.exit(1);
+}
 
 server.listen(port, '127.0.0.1', () => {
-  console.log(`gemix-dash on http://127.0.0.1:${port}`);
+  const url = `http://127.0.0.1:${port}`;
+  console.log(`gemix-dash running at ${url}`);
+  console.log(`Run 'gemix-dash stop' to shut it down.`);
+  writePid(process.pid, port);
+  openBrowser(url);
 });
+
+// Clean up PID file on exit
+function cleanup() {
+  const info = readPid();
+  if (info && info.pid === process.pid) removePid();
+}
+process.on('exit', cleanup);
+process.on('SIGINT',  () => { cleanup(); process.exit(0); });
+process.on('SIGTERM', () => { cleanup(); process.exit(0); });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gemix-dash",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Local web dashboard for gemix accounts (~/.gemix)",
   "type": "module",
   "main": "server.mjs",