session-intelligence-cli 0.1.2 → 0.1.4

package/README.md

@@ -0,0 +1,67 @@
+# Session Intelligence CLI
+
+A [Claude Code](https://docs.anthropic.com/en/docs/claude-code) plugin that gives you a real-time dashboard for all your coding sessions.
+
+See what every session is doing, track token usage and git changes, and get a full activity history across all your projects.
+
+**[session-intelligence.com](https://www.session-intelligence.com)**
+
+## What it does
+
+- **Live session tracking** — see every session as it thinks, runs tools, or waits for input
+- **Activity heatmap & stats** — tokens, lines changed, model usage, and streaks over time
+- **GitHub integration** — auto-links sessions to PRs, tracks open issues and review requests
+- **Multi-project** — one dashboard for all your repos and branches
+
+## Quick start
+
+```bash
+npx session-intelligence-cli setup
+```
+
+This will:
+
+1. Ask for your **server URL** and **API key** (get one at [session-intelligence.com](https://www.session-intelligence.com))
+2. Save config to `~/.session-intelligence/config.json`
+3. Register hooks in `~/.claude/settings.json`
+
+Your next Claude Code session will start reporting automatically.
+
+## How it works
+
+The CLI registers lightweight [Claude Code hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) that fire on session lifecycle events:
+
+| Event | What it reports |
+|---|---|
+| `SessionStart` | New session created |
+| `PostToolUse` | Tool activity (Read, Edit, Bash, etc.) |
+| `Notification` | Permission requests / input needed |
+| `SubagentStop` | Subagent task completion |
+| `Stop` | Task turn completed |
+| `SessionEnd` | Session archived with token usage summary |
+
+Each hook reads the current git state (branch, last commit, uncommitted changes) and sends a small payload to your dashboard. All calls are fire-and-forget with no impact on Claude Code performance.
+
+## Updating
+
+If you installed a previous version, re-run setup to register any new hooks:
+
+```bash
+npx session-intelligence-cli@latest setup
+```
+
+## Commands
+
+```bash
+session-intelligence setup    # configure and install hooks
+session-intelligence status   # check connection and config
+```
+
+## Requirements
+
+- Node.js >= 18
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
+
+## License
+
+MIT

package/dist/report-bg.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/report-bg.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { readGitState, readGitDiffStats } from "./git.js";
+import { sendEvent } from "./api.js";
+// Called as: node report-bg.js <json-payload>
+// Runs detached from the parent process to avoid being killed on session teardown.
+const raw = process.argv[2];
+if (!raw)
+    process.exit(0);
+const stdinData = JSON.parse(raw);
+const sessionId = stdinData.session_id ?? "";
+const cwd = stdinData.cwd ?? process.cwd();
+const payload = {
+    session_id: sessionId,
+    cwd,
+    hook_event_name: "SessionEnd",
+    model: stdinData.model,
+};
+const transcriptPath = stdinData.transcript_path;
+if (transcriptPath) {
+    try {
+        const content = readFileSync(transcriptPath, "utf-8");
+        const usage = { input_tokens: 0, output_tokens: 0, cache_read_tokens: 0, cache_creation_tokens: 0 };
+        for (const line of content.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const entry = JSON.parse(trimmed);
+                if (entry.type !== "assistant" || !entry.message?.usage)
+                    continue;
+                const u = entry.message.usage;
+                usage.input_tokens += u.input_tokens ?? 0;
+                usage.output_tokens += u.output_tokens ?? 0;
+                usage.cache_read_tokens += u.cache_read_input_tokens ?? 0;
+                usage.cache_creation_tokens += u.cache_creation_input_tokens ?? 0;
+            }
+            catch {
+                // skip malformed lines
+            }
+        }
+        payload.usage = usage;
+    }
+    catch {
+        // transcript unreadable
+    }
+}
+const git = readGitState(cwd);
+if (git) {
+    const stats = readGitDiffStats(cwd);
+    payload.git = {
+        branch: git.branch,
+        lastCommitSha: git.lastCommitSha,
+        lastCommitMessage: git.lastCommitMessage,
+        hasUncommittedChanges: git.hasUncommittedChanges,
+        filesChanged: stats.filesChanged,
+        insertions: stats.insertions,
+        deletions: stats.deletions,
+    };
+}
+await sendEvent(payload);

package/dist/report.js

@@ -1,4 +1,6 @@
-import { readFileSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
 import { readGitState, readGitDiffStats } from "./git.js";
 import { sendEvent } from "./api.js";
 const EVENT_MAP = {
@@ -9,47 +11,35 @@ const EVENT_MAP = {
     "notification": "Notification",
     "subagent-stop": "SubagentStop",
 };
-function parseTranscriptTokens(transcriptPath) {
-    const zero = { input_tokens: 0, output_tokens: 0, cache_read_tokens: 0, cache_creation_tokens: 0 };
-    try {
-        const content = readFileSync(transcriptPath, "utf-8");
-        for (const line of content.split("\n")) {
-            const trimmed = line.trim();
-            if (!trimmed)
-                continue;
+function readStdin() {
+    return new Promise((resolve) => {
+        const chunks = [];
+        process.stdin.on("data", (chunk) => chunks.push(chunk));
+        process.stdin.on("end", () => {
             try {
-                const entry = JSON.parse(trimmed);
-                if (entry.type !== "assistant" || !entry.message?.usage)
-                    continue;
-                const u = entry.message.usage;
-                zero.input_tokens += u.input_tokens ?? 0;
-                zero.output_tokens += u.output_tokens ?? 0;
-                zero.cache_read_tokens += u.cache_read_input_tokens ?? 0;
-                zero.cache_creation_tokens += u.cache_creation_input_tokens ?? 0;
+                const raw = Buffer.concat(chunks).toString("utf-8").trim();
+                resolve(raw ? JSON.parse(raw) : {});
             }
             catch {
-                // skip malformed lines
+                resolve({});
             }
-        }
-    }
-    catch {
-        // file not found or unreadable
-    }
-    return zero;
+        });
+        process.stdin.on("error", () => resolve({}));
+    });
 }
 export async function report(eventType) {
-    let stdinData = {};
-    try {
-        const chunks = [];
-        for await (const chunk of process.stdin) {
-            chunks.push(chunk);
-        }
-        const raw = Buffer.concat(chunks).toString("utf-8").trim();
-        if (raw)
-            stdinData = JSON.parse(raw);
-    }
-    catch {
-        // No stdin or invalid JSON
+    const stdinData = await readStdin();
+    // For session-end, spawn a detached background process so the hook
+    // can exit immediately and avoid being killed during session teardown.
+    if (eventType === "session-end") {
+        const scriptDir = dirname(fileURLToPath(import.meta.url));
+        const bgScript = join(scriptDir, "report-bg.js");
+        const child = spawn(process.execPath, [bgScript, JSON.stringify(stdinData)], {
+            detached: true,
+            stdio: "ignore",
+        });
+        child.unref();
+        return;
     }
     const sessionId = stdinData.session_id ?? "";
     const cwd = stdinData.cwd ?? process.cwd();
@@ -60,12 +50,6 @@ export async function report(eventType) {
         model: stdinData.model,
         tool_name: stdinData.tool_name,
     };
-    if (eventType === "session-end") {
-        const transcriptPath = stdinData.transcript_path;
-        if (transcriptPath) {
-            payload.usage = parseTranscriptTokens(transcriptPath);
-        }
-    }
     const git = readGitState(cwd);
     if (git) {
         const gitPayload = {
@@ -74,7 +58,7 @@ export async function report(eventType) {
             lastCommitMessage: git.lastCommitMessage,
             hasUncommittedChanges: git.hasUncommittedChanges,
         };
-        if (eventType === "stop" || eventType === "session-end") {
+        if (eventType === "stop") {
             const stats = readGitDiffStats(cwd);
             gitPayload.filesChanged = stats.filesChanged;
             gitPayload.insertions = stats.insertions;

package/dist/setup.js

@@ -15,6 +15,7 @@ function prompt(question) {
 const HOOKS_CONFIG = {
     SessionStart: [{ hooks: [{ type: "command", command: "npx session-intelligence-cli report session-start" }] }],
     Stop: [{ hooks: [{ type: "command", command: "npx session-intelligence-cli report stop" }] }],
+    SessionEnd: [{ hooks: [{ type: "command", command: "npx session-intelligence-cli report session-end" }] }],
     PostToolUse: [{ hooks: [{ type: "command", command: "npx session-intelligence-cli report tool-use", timeout: 3000 }] }],
     Notification: [{ hooks: [{ type: "command", command: "npx session-intelligence-cli report notification" }] }],
     SubagentStop: [{ hooks: [{ type: "command", command: "npx session-intelligence-cli report subagent-stop", timeout: 3000 }] }],

package/package.json

@@ -1,9 +1,22 @@
 {
   "name": "session-intelligence-cli",
-  "version": "0.1.2",
-  "description": "CLI plugin for Session Intelligence — hooks into Claude Code to track sessions",
+  "version": "0.1.4",
+  "description": "Real-time dashboard for Claude Code sessions — track activity, git changes, token usage, and session history across all your projects",
   "type": "module",
   "license": "MIT",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "anthropic",
+    "ai",
+    "session",
+    "dashboard",
+    "cli",
+    "hooks",
+    "developer-tools",
+    "productivity"
+  ],
+  "homepage": "https://www.session-intelligence.com",
   "repository": {
     "type": "git",
     "url": "https://github.com/0xleal/personal-dashboard.git",
@@ -13,7 +26,8 @@
     "session-intelligence": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "scripts": {
     "build": "tsc",