tracer-sh 0.2.1 → 0.2.2

package/README.md

@@ -66,9 +66,19 @@ tracer-sh
 
 Open `http://localhost:3579`, go to **Settings** to add your API keys and choose an LLM — done.
 
+## Headless / CLI
+
+Run an investigation from the terminal and get back the final analysis — so other tools and agents (including Claude Code) can drive Tracer:
+
+```bash
+tracer-sh analyze "Why did checkout error rate spike after 14:00 UTC?"
+```
+
+Continue a prior run with `--session <id>`; pass `--json` for the full response (session id, queries, usage). Requires a running server.
+
 ## Supported Providers
 
-**Data:** New Relic (NRQL via NerdGraph), Google Cloud (Logs, Traces, Metrics, Errors)
+**Data:** New Relic (NRQL), Google Cloud (Logs, Traces, Metrics, Errors), PostHog (HogQL)
 
 **LLM:** Anthropic (Claude), Google (Gemini)
 

package/bin/tracer.mjs

@@ -10,6 +10,64 @@ const serverPath = resolve(__dirname, "../packages/server/dist/index.js");
 // Must match RESTART_EXIT_CODE in packages/server/src/updater.ts
 const RESTART_EXIT_CODE = 75;
 
+// `tracer analyze "<message>" [--session <id>] [--provider <name>] [--json]`
+// Runs the investigation agent on the already-running local server and prints
+// the final analysis. Lets other local agents (e.g. Claude Code) drive Tracer.
+if (process.argv[2] === "analyze") {
+  await runAnalyze(process.argv.slice(3));
+  process.exit(0);
+}
+
+async function runAnalyze(args) {
+  let message;
+  let sessionId;
+  let provider;
+  let asJson = false;
+
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === "--json") asJson = true;
+    else if (a === "--session" || a === "-s") sessionId = args[++i];
+    else if (a === "--provider" || a === "-p") provider = args[++i];
+    else if (message === undefined) message = a;
+  }
+
+  if (!message) {
+    console.error('Usage: tracer-sh analyze "<message>" [--session <id>] [--provider <name>] [--json]');
+    process.exit(2);
+  }
+
+  const host = process.env.TRACER_HOST || "127.0.0.1";
+  const port = process.env.TRACER_PORT || "3579";
+  const url = `http://${host}:${port}/api/v1/analyze`;
+
+  let res;
+  try {
+    res = await fetch(url, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ message, sessionId, provider }),
+    });
+  } catch {
+    console.error(`Could not reach Tracer at ${url}. Is the server running? Start it with: tracer-sh`);
+    process.exit(1);
+  }
+
+  const data = await res.json().catch(() => ({}));
+
+  if (!res.ok || data.status === "error") {
+    console.error(`Error: ${data.error || res.statusText}`);
+    process.exit(1);
+  }
+
+  if (asJson) {
+    process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+  } else {
+    process.stdout.write((data.analysis || "") + "\n");
+    console.error(`session ${data.sessionId}${data.model ? ` · ${data.model}` : ""}`);
+  }
+}
+
 const banner = `
   ╔═══════════════════════════════════╗
   ║       Tracer Debug Platform       ║

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tracer-sh",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "type": "module",
   "description": "Local-first debugging & analysis platform",
   "license": "SEE LICENSE IN LICENSE",
@@ -34,7 +34,12 @@
     "onlyBuiltDependencies": [
       "better-sqlite3",
       "esbuild"
-    ]
+    ],
+    "overrides": {
+      "mermaid": "^11.15.0",
+      "postcss": "^8.5.10",
+      "uuid": "^11.1.1"
+    }
   },
   "devDependencies": {
     "concurrently": "^9.2.1",