claudeck 1.0.2 → 1.0.3

package/README.md

@@ -24,16 +24,19 @@
 # One-command launch (no install needed)
 npx claudeck
 
+# Custom port
+npx claudeck --port 3000
+
 # Or install globally
 npm install -g claudeck
 claudeck
 ```
 
-Open **http://localhost:9009** in your browser.
+On first run, Claudeck will ask you to choose a port (default: `9009`), then open your browser to the URL shown in the terminal. The port is saved to `~/.claudeck/.env` for future runs.
 
 > Requires **Node.js 18+** and Claude Code CLI authentication (`claude auth login`).
 
-On first run, Claudeck creates `~/.claudeck/` with your config, database, and plugins directory — safe for NPX upgrades.
+User data lives in `~/.claudeck/` (config, database, plugins) — safe for NPX upgrades.
 
 ---
 

package/cli.js

@@ -1,2 +1,67 @@
 #!/usr/bin/env node
-import("./server.js");
+import { homedir } from "os";
+import { join } from "path";
+import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import { createInterface } from "readline";
+
+const DEFAULT_PORT = 9009;
+const envDir = process.env.CLAUDECK_HOME || join(homedir(), ".claudeck");
+const envPath = join(envDir, ".env");
+mkdirSync(envDir, { recursive: true });
+
+function readEnv() {
+  try { return readFileSync(envPath, "utf-8"); } catch { return ""; }
+}
+
+function savePort(port) {
+  let content = readEnv();
+  if (/^PORT=.*/m.test(content)) {
+    content = content.replace(/^PORT=.*/m, `PORT=${port}`);
+  } else {
+    content = content.trimEnd() + `\nPORT=${port}\n`;
+  }
+  writeFileSync(envPath, content);
+}
+
+function getSavedPort() {
+  const match = readEnv().match(/^PORT=(\d+)/m);
+  return match ? match[1] : null;
+}
+
+function ask(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise(resolve => {
+    rl.question(question, answer => { rl.close(); resolve(answer.trim()); });
+  });
+}
+
+async function main() {
+  // --port flag takes priority
+  const portArg = process.argv.find(a => a.startsWith('--port'));
+  if (portArg) {
+    const port = portArg.includes('=') ? portArg.split('=')[1] : process.argv[process.argv.indexOf(portArg) + 1];
+    if (port) {
+      process.env.PORT = port;
+      savePort(port);
+      return import("./server.js");
+    }
+  }
+
+  // If port already saved, use it
+  const saved = getSavedPort();
+  if (saved) {
+    process.env.PORT = saved;
+    return import("./server.js");
+  }
+
+  // First run — ask user
+  console.log(`\n\x1b[36m  Claudeck\x1b[0m — first-time setup\n`);
+  const answer = await ask(`  Which port would you like to use? \x1b[2m(default: ${DEFAULT_PORT})\x1b[0m `);
+  const port = answer && /^\d+$/.test(answer) ? answer : String(DEFAULT_PORT);
+  process.env.PORT = port;
+  savePort(port);
+  console.log(`\x1b[2m  Saved to ~/.claudeck/.env\x1b[0m\n`);
+  return import("./server.js");
+}
+
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudeck",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "type": "module",
   "description": "A browser-based UI for Claude Code — chat, run workflows, manage MCP servers, track costs, and orchestrate autonomous agents from a local web interface. Installable as a PWA.",
   "main": "server.js",

package/server.js

@@ -164,7 +164,21 @@ const PORT = process.env.PORT || 9009;
 // Mount full-stack plugin routes, then start server
 mountPluginRoutes(app, fullStackPluginsDir).then(() => {
   server.listen(PORT, () => {
-    console.log(`Claudeck running at http://localhost:${PORT}`);
+    const url = `http://localhost:${PORT}`;
+    console.log(`
+\x1b[36m   _____ _                 _           _
+  / ____| |               | |         | |
+ | |    | | __ _ _   _  __| | ___  ___| | __
+ | |    | |/ _\` | | | |/ _\` |/ _ \\/ __| |/ /
+ | |____| | (_| | |_| | (_| |  __/ (__|   <
+  \\_____|_|\\__,_|\\__,_|\\__,_|\\___|\\___|_|\\_\\\x1b[0m
+
+\x1b[2m  Browser UI for Claude Code\x1b[0m
+
+  \x1b[1m\x1b[32m➜\x1b[0m  \x1b[1mReady:\x1b[0m   ${url}
+  \x1b[2m➜  Port:\x1b[0m    ${PORT}
+  \x1b[2m➜  Data:\x1b[0m    ~/.claudeck/
+`);
   });
 });