agent-dag 1.0.0 → 1.0.1

package/README.md

@@ -1,14 +1,27 @@
-# ccgraph
+# agent-dag
 
 Live DAG of Claude Code agents. Watch parallel subagents fork, call tools, and return — all on one calm canvas.
 
 ## Run
 
 ```bash
-npx ccgraph
+npx agent-dag
 ```
 
-Opens http://127.0.0.1:4317. Start a Claude Code session in any directory and watch the graph fill in.
+Opens http://127.0.0.1:4317 (or a random port in 4318–4400 if 4317 is taken). Start a Claude Code session in any directory and watch the graph fill in.
+
+## Options
+
+```
+-p, --port <number>      Preferred port (default: 4317; falls back to random 4318–4400)
+    --no-open            Don't open the browser automatically
+    --workspace <path>   Workspace root to filter events (default: cwd)
+    --all                Capture sessions from all workspaces (machine-wide)
+    --history <path>     Override events log file (default: ~/.claude/ccgraph/events.jsonl)
+    --no-persist         RAM-only mode, no log file
+    --uninstall          Remove agent-dag hooks from ~/.claude/settings.json
+-h, --help               Show help
+```
 
 ## Design
 
@@ -20,11 +33,19 @@ Opens http://127.0.0.1:4317. Start a Claude Code session in any directory and wa
 
 ## How it works
 
-`ccgraph` registers a hook script in `~/.claude/settings.json` for these Claude Code events:
+`agent-dag` registers a hook script in `~/.claude/settings.json` for these Claude Code events:
 
 `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `SubagentStart`, `SubagentStop`, `Stop`, `SessionEnd`, `Notification`.
 
-The hook forwards the event JSON to the running `ccgraph` server, which streams it to the browser via SSE.
+The hook forwards the event JSON to the running server, which streams it to the browser via SSE.
+
+## Uninstall
+
+```bash
+npx agent-dag --uninstall
+```
+
+Removes all hooks from `~/.claude/settings.json`.
 
 ## Status
 

package/bin/ccgraph.js

@@ -41,7 +41,7 @@ if (!existsSync(WEB_DIST)) {
   process.exit(1);
 }
 
-console.log("ccgraph");
+console.log("agent-dag");
 console.log("  workspace:", workspace === "" ? "(all)" : workspace);
 
 const { settingsPath, hookPath, events } = await installHooks();
@@ -50,11 +50,7 @@ console.log("  events:", events.join(", "));
 console.log("  settings:", settingsPath);
 
 const server = await startServer({ port, persist }).catch(err => {
-  if (err && err.code === "EADDRINUSE") {
-    console.error(`\nccgraph: port ${port} in use. Try --port <N>.`);
-  } else {
-    console.error("ccgraph: server failed:", err.message);
-  }
+  console.error("ccgraph: server failed:", err.message);
   process.exit(1);
 });
 
@@ -103,19 +99,19 @@ function parseArgs(args) {
 }
 
 function printHelp() {
-  process.stdout.write(`ccgraph — live DAG of Claude Code agents
+  process.stdout.write(`agent-dag — live DAG of Claude Code agents
 
 Usage:
-  ccgraph [options]
+  agent-dag [options]
 
 Options:
-  -p, --port <number>      Port for the server (default: 4317)
+  -p, --port <number>      Preferred port (default: 4317; falls back to random 4318–4400)
       --no-open            Don't open the browser automatically
       --workspace <path>   Workspace root (default: cwd)
       --all                Capture sessions from ALL workspaces (machine-wide)
       --history <path>     Override events log file (default: ~/.claude/ccgraph/events.jsonl)
       --no-persist         Don't write or replay events log (RAM-only)
-      --uninstall          Remove ccgraph hook entries from ~/.claude/settings.json
+      --uninstall          Remove agent-dag hook entries from ~/.claude/settings.json
   -h, --help               Show this help
 `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-dag",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Live DAG of Claude Code agents — watch parallel subagents fork, call tools, and return on one calm canvas.",
   "type": "module",
   "bin": {

package/src/server/index.mjs

@@ -191,7 +191,21 @@ async function sweepStaleDiscovery() {
   return removed;
 }
 
-export async function startServer({ port = 4317, host = "127.0.0.1", persist = null } = {}) {
+function randomPort(min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+
+async function tryListen(server, port, host) {
+  return new Promise((res, rej) => {
+    server.once("error", rej);
+    server.listen(port, host, () => {
+      server.removeListener("error", rej);
+      res();
+    });
+  });
+}
+
+export async function startServer({ port = 4317, host = "127.0.0.1", persist = null, portRange = [4318, 4400] } = {}) {
   const removed = await sweepStaleDiscovery();
   if (removed > 0) console.log(`  swept ${removed} stale discovery file(s)`);
   if (persist) {
@@ -227,13 +241,20 @@ export async function startServer({ port = 4317, host = "127.0.0.1", persist = n
     send(res, 405, { error: "method not allowed" });
   });
 
-  return new Promise((resolveStart, rejectStart) => {
-    server.once("error", rejectStart);
-    server.listen(port, host, () => {
-      server.removeListener("error", rejectStart);
-      resolveStart(server);
-    });
-  });
+  // Try requested port first, then up to 10 random ports from portRange.
+  const candidates = [port];
+  for (let i = 0; i < 10; i++) candidates.push(randomPort(portRange[0], portRange[1]));
+
+  for (const candidate of candidates) {
+    try {
+      await tryListen(server, candidate, host);
+      return server;
+    } catch (err) {
+      if (err && err.code === "EADDRINUSE") continue;
+      throw err;
+    }
+  }
+  throw Object.assign(new Error(`all ports tried — none available`), { code: "EADDRINUSE" });
 }
 
 // Allow running this file directly for dev.