@claude-view/plugin 0.8.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "claude-view",
+  "description": "Mission Control for Claude Code — auto-starts a web dashboard, provides session/cost/fluency tools, and adds /session-recap, /daily-cost, /standup skills.",
+  "version": "0.8.0",
+  "author": {
+    "name": "tombelieber",
+    "email": "nicholasgee1997@gmail.com"
+  },
+  "homepage": "https://github.com/tombelieber/claude-view",
+  "repository": "https://github.com/tombelieber/claude-view",
+  "license": "MIT",
+  "keywords": [
+    "claude-code",
+    "mission-control",
+    "session-analytics",
+    "cost-tracking",
+    "fluency-score",
+    "dashboard"
+  ]
+}

package/.mcp.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "claude-view": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/index.js"],
+      "env": {}
+    }
+  }
+}

package/README.md

@@ -0,0 +1,57 @@
+# claude-view plugin
+
+Mission Control for Claude Code. Auto-starts a web dashboard, provides 8 session/cost/fluency
+tools, and adds `/session-recap`, `/daily-cost`, `/standup` skills.
+
+## Install
+
+```bash
+claude plugin add @claude-view/plugin
+```
+
+## Prerequisites
+
+- **Node.js >= 18** (required by MCP SDK)
+- The plugin auto-starts the claude-view server, but the binary must be available:
+
+```bash
+npx claude-view   # downloads the pre-built Rust binary on first run (~5-15s first time)
+```
+
+> **First run note:** The very first session after install may take 5-30 seconds to download the
+> Rust binary. The hook will time out gracefully — the server will start in the background and be
+> ready for your next tool call or next session.
+
+## What You Get
+
+### Auto-start (SessionStart hook)
+Every time you start a Claude Code session, the plugin checks if the claude-view server
+is running. If not, it starts it in the background. Web dashboard appears at
+`http://localhost:47892`.
+
+### 8 MCP Tools (available to Claude)
+| Tool | Purpose |
+|------|---------|
+| `list_sessions` | List/filter/paginate sessions |
+| `get_session` | Full session detail + commits |
+| `search_sessions` | Full-text search across sessions |
+| `get_stats` | Dashboard overview: projects, skills, trends |
+| `get_fluency_score` | AI Fluency Score (0-100) |
+| `get_token_stats` | Token usage breakdown |
+| `list_live_sessions` | Currently running sessions |
+| `get_live_summary` | Aggregate: cost today, attention count |
+
+### 3 Skills
+| Skill | Trigger |
+|-------|---------|
+| `/session-recap` | "recap my last session", "summarize session" |
+| `/daily-cost` | "how much did I spend today", "cost report" |
+| `/standup` | "standup update", "what did I work on" |
+
+## Configuration
+
+Set `CLAUDE_VIEW_PORT` to override the default port (47892).
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,6 @@
+export declare class ClaudeViewClient {
+    readonly baseUrl: string;
+    constructor(port?: number);
+    get<T = unknown>(path: string, params?: Record<string, string | number | undefined>): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;gBAEZ,IAAI,CAAC,EAAE,MAAM;IAKnB,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GACnD,OAAO,CAAC,CAAC,CAAC;CA6Bd"}

package/dist/client.js

@@ -0,0 +1,33 @@
+export class ClaudeViewClient {
+    baseUrl;
+    constructor(port) {
+        const resolvedPort = port ?? (Number(process.env.CLAUDE_VIEW_PORT) || 47892);
+        this.baseUrl = `http://localhost:${resolvedPort}`;
+    }
+    async get(path, params) {
+        const url = new URL(path, this.baseUrl);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        let response;
+        try {
+            response = await fetch(url.toString(), {
+                headers: { Accept: 'application/json' },
+                signal: AbortSignal.timeout(10_000),
+            });
+        }
+        catch {
+            throw new Error(`claude-view server not detected at ${this.baseUrl}. Start it with: npx claude-view`);
+        }
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new Error(`claude-view API error ${response.status}: ${body}`);
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,gBAAgB;IAClB,OAAO,CAAQ;IAExB,YAAY,IAAa;QACvB,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,CAAA;QAC5E,IAAI,CAAC,OAAO,GAAG,oBAAoB,YAAY,EAAE,CAAA;IACnD,CAAC;IAED,KAAK,CAAC,GAAG,CACP,IAAY,EACZ,MAAoD;QAEpD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QACvC,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,QAAkB,CAAA;QACtB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;gBACrC,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;gBACvC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;aACpC,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,sCAAsC,IAAI,CAAC,OAAO,kCAAkC,CACrF,CAAA;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;YAClD,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAA;QACtE,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAgB,CAAA;IACtC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { TOOL_COUNT, createServer } from './server.js';
+const port = process.env.CLAUDE_VIEW_PORT ? Number(process.env.CLAUDE_VIEW_PORT) : undefined;
+const server = createServer(port);
+const transport = new StdioServerTransport();
+console.error(`claude-view MCP server starting (${TOOL_COUNT} tools, port ${port ?? 47892})`);
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAEtD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAC5F,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;AACjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;AAE5C,OAAO,CAAC,KAAK,CAAC,oCAAoC,UAAU,gBAAgB,IAAI,IAAI,KAAK,GAAG,CAAC,CAAA;AAE7F,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const TOOL_COUNT: number;
+export declare function createServer(port?: number): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAOnE,eAAO,MAAM,UAAU,QAAmB,CAAA;AAE1C,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,aA+BzC"}

package/dist/server.js

@@ -0,0 +1,34 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ClaudeViewClient } from './client.js';
+import { liveTools } from './tools/live.js';
+import { sessionTools } from './tools/sessions.js';
+import { statsTools } from './tools/stats.js';
+const ALL_TOOLS = [...sessionTools, ...statsTools, ...liveTools];
+export const TOOL_COUNT = ALL_TOOLS.length;
+export function createServer(port) {
+    const client = new ClaudeViewClient(port);
+    const server = new McpServer({
+        name: 'claude-view',
+        version: '0.8.0',
+    });
+    for (const tool of ALL_TOOLS) {
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            annotations: tool.annotations,
+        }, async (args) => {
+            try {
+                const result = await tool.handler(client, args);
+                return { content: [{ type: 'text', text: result }] };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: 'text', text: `Error: ${err.message}` }],
+                    isError: true,
+                };
+            }
+        });
+    }
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,MAAM,SAAS,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,UAAU,EAAE,GAAG,SAAS,CAAC,CAAA;AAChE,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAA;AAE1C,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAEzC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAA;IAEF,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;YACE,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,EACD,KAAK,EAAE,IAAS,EAAE,EAAE;YAClB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;gBAC/C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAA;YAC/D,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;oBACnE,OAAO,EAAE,IAAI;iBACd,CAAA;YACH,CAAC;QACH,CAAC,CACF,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/tools/live.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import type { ClaudeViewClient } from '../client.js';
+interface ToolDef<TSchema extends z.ZodObject<any> = z.ZodObject<any>> {
+    name: string;
+    description: string;
+    inputSchema: TSchema;
+    annotations: Record<string, boolean>;
+    handler: (client: ClaudeViewClient, args: z.output<TSchema>) => Promise<string>;
+}
+export declare const liveTools: ToolDef[];
+export {};
+//# sourceMappingURL=live.d.ts.map

package/dist/tools/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/tools/live.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,UAAU,OAAO,CAAC,OAAO,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;IACnE,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,OAAO,CAAA;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAChF;AAED,eAAO,MAAM,SAAS,EAAE,OAAO,EAkD9B,CAAA"}

package/dist/tools/live.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+export const liveTools = [
+    {
+        name: 'list_live_sessions',
+        description: 'List currently running Claude Code sessions with real-time agent state, model, token usage, cost, and activity.',
+        inputSchema: z.object({}),
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        handler: async (client) => {
+            const data = await client.get('/api/live/sessions');
+            const sessions = (data.sessions ?? []).map((s) => ({
+                id: s.id,
+                project: s.projectDisplayName,
+                agent_state: s.agentState?.label ?? s.agentState?.group,
+                model: s.model,
+                turn_count: s.turnCount,
+                cost_usd: s.cost?.totalUsd,
+                total_tokens: s.tokens?.totalTokens,
+                started: s.startedAt ? new Date(s.startedAt * 1000).toISOString() : null,
+                last_activity: s.lastActivityAt ? new Date(s.lastActivityAt * 1000).toISOString() : null,
+                sub_agents: (s.subAgents ?? []).length || undefined,
+            }));
+            return JSON.stringify({ sessions, total: data.total, process_count: data.processCount }, null, 2);
+        },
+    },
+    {
+        name: 'get_live_summary',
+        description: 'Get aggregate summary of all live Claude Code sessions: how many need attention, how many are autonomous, total cost today, total tokens today.',
+        inputSchema: z.object({}),
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        handler: async (client) => {
+            const data = await client.get('/api/live/summary');
+            return JSON.stringify({
+                needs_attention: data.needsYouCount,
+                autonomous: data.autonomousCount,
+                delivered: data.deliveredCount,
+                total_cost_today_usd: data.totalCostTodayUsd,
+                total_tokens_today: data.totalTokensToday,
+                process_count: data.processCount,
+            }, null, 2);
+        },
+    },
+];
+//# sourceMappingURL=live.js.map

package/dist/tools/live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.js","sourceRoot":"","sources":["../../src/tools/live.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAWvB,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,iHAAiH;QACnH,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;QACjF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACxB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAM,oBAAoB,CAAC,CAAA;YACxD,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;gBACtD,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,OAAO,EAAE,CAAC,CAAC,kBAAkB;gBAC7B,WAAW,EAAE,CAAC,CAAC,UAAU,EAAE,KAAK,IAAI,CAAC,CAAC,UAAU,EAAE,KAAK;gBACvD,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,UAAU,EAAE,CAAC,CAAC,SAAS;gBACvB,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ;gBAC1B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,WAAW;gBACnC,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;gBACxE,aAAa,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;gBACxF,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,SAAS;aACpD,CAAC,CAAC,CAAA;YACH,OAAO,IAAI,CAAC,SAAS,CACnB,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,YAAY,EAAE,EACjE,IAAI,EACJ,CAAC,CACF,CAAA;QACH,CAAC;KACF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,iJAAiJ;QACnJ,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;QACjF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACxB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAM,mBAAmB,CAAC,CAAA;YACvD,OAAO,IAAI,CAAC,SAAS,CACnB;gBACE,eAAe,EAAE,IAAI,CAAC,aAAa;gBACnC,UAAU,EAAE,IAAI,CAAC,eAAe;gBAChC,SAAS,EAAE,IAAI,CAAC,cAAc;gBAC9B,oBAAoB,EAAE,IAAI,CAAC,iBAAiB;gBAC5C,kBAAkB,EAAE,IAAI,CAAC,gBAAgB;gBACzC,aAAa,EAAE,IAAI,CAAC,YAAY;aACjC,EACD,IAAI,EACJ,CAAC,CACF,CAAA;QACH,CAAC;KACF;CACF,CAAA"}

package/dist/tools/sessions.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import type { ClaudeViewClient } from '../client.js';
+interface ToolDef<TSchema extends z.ZodObject<any> = z.ZodObject<any>> {
+    name: string;
+    description: string;
+    inputSchema: TSchema;
+    annotations: Record<string, boolean>;
+    handler: (client: ClaudeViewClient, args: z.output<TSchema>) => Promise<string>;
+}
+export declare const sessionTools: ToolDef[];
+export {};
+//# sourceMappingURL=sessions.d.ts.map

package/dist/tools/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/tools/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,UAAU,OAAO,CAAC,OAAO,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;IACnE,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,OAAO,CAAA;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAChF;AAyBD,eAAO,MAAM,YAAY,EAAE,OAAO,EA0GjC,CAAA"}

package/dist/tools/sessions.js

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+const listSessionsSchema = z.object({
+    limit: z.number().optional().describe('Max sessions to return (default 30)'),
+    q: z.string().optional().describe('Text search query'),
+    filter: z.string().optional().describe('Filter: all, has_commits, high_reedit, long_session'),
+    sort: z.string().optional().describe('Sort: recent, tokens, prompts, files_edited, duration'),
+    offset: z.number().optional().describe('Pagination offset'),
+    branches: z.string().optional().describe('Comma-separated branch names'),
+    models: z.string().optional().describe('Comma-separated model names'),
+    time_after: z.number().optional().describe('Unix timestamp lower bound'),
+    time_before: z.number().optional().describe('Unix timestamp upper bound'),
+});
+const getSessionSchema = z.object({
+    session_id: z.string().describe('The session ID to look up'),
+});
+const searchSessionsSchema = z.object({
+    query: z.string().describe('Search query'),
+    limit: z.number().optional().describe('Max results (default 10)'),
+    offset: z.number().optional().describe('Pagination offset'),
+    scope: z.string().optional().describe('Search scope: all, user, assistant'),
+});
+export const sessionTools = [
+    {
+        name: 'list_sessions',
+        description: 'List Claude Code sessions with optional filters. Returns session summaries including project, model, duration, and token usage.',
+        inputSchema: listSessionsSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        handler: async (client, args) => {
+            const data = await client.get('/api/sessions', {
+                limit: args.limit,
+                q: args.q,
+                filter: args.filter,
+                sort: args.sort,
+                offset: args.offset,
+                branches: args.branches,
+                models: args.models,
+                time_after: args.time_after,
+                time_before: args.time_before,
+            });
+            const sessions = (data.sessions ?? []).map((s) => ({
+                id: s.id,
+                project: s.displayName || s.project,
+                branch: s.gitBranch,
+                model: s.primaryModel,
+                turns: s.turnCount,
+                messages: s.messageCount,
+                commits: s.commitCount,
+                duration_min: Math.round((s.durationSeconds ?? 0) / 60),
+                input_tokens: s.totalInputTokens,
+                output_tokens: s.totalOutputTokens,
+                modified: s.modifiedAt ? new Date(s.modifiedAt * 1000).toISOString() : null,
+            }));
+            return JSON.stringify({ sessions, total: data.total, has_more: data.hasMore }, null, 2);
+        },
+    },
+    {
+        name: 'get_session',
+        description: 'Get detailed information about a specific Claude Code session, including commits, token breakdown, and derived metrics.',
+        inputSchema: getSessionSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        handler: async (client, args) => {
+            const data = await client.get(`/api/sessions/${args.session_id}`);
+            return JSON.stringify({
+                id: data.id,
+                project: data.displayName || data.project,
+                branch: data.gitBranch,
+                model: data.primaryModel,
+                summary: data.preview,
+                turns: data.turnCount,
+                messages: data.userPromptCount,
+                commits: data.commits?.length ?? data.commitCount,
+                duration_min: Math.round((data.durationSeconds ?? 0) / 60),
+                input_tokens: data.totalInputTokens,
+                output_tokens: data.totalOutputTokens,
+                cache_read_tokens: data.totalCacheReadTokens,
+                derived_metrics: data.derivedMetrics,
+                recent_commits: (data.commits ?? []).slice(0, 10).map((c) => ({
+                    hash: c.hash?.slice(0, 8),
+                    message: c.message,
+                    branch: c.branch,
+                })),
+            }, null, 2);
+        },
+    },
+    {
+        name: 'search_sessions',
+        description: 'Search across all Claude Code sessions using unified enhanced search. Returns matching sessions with highlighted snippets.',
+        inputSchema: searchSessionsSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        handler: async (client, args) => {
+            const data = await client.get('/api/search', {
+                q: args.query,
+                limit: args.limit,
+                offset: args.offset,
+                scope: args.scope,
+            });
+            return JSON.stringify({
+                query: data.query,
+                total_sessions: data.totalSessions,
+                total_matches: data.totalMatches,
+                elapsed_ms: data.elapsedMs,
+                results: (data.sessions ?? []).map((s) => ({
+                    session_id: s.sessionId,
+                    project: s.project,
+                    branch: s.branch,
+                    match_count: s.matchCount,
+                    best_score: s.bestScore,
+                    top_matches: (s.matches ?? []).slice(0, 3).map((m) => ({
+                        role: m.role,
+                        snippet: m.snippet?.replace(/<\/?mark>/g, '**'),
+                        turn: m.turnNumber,
+                    })),
+                })),
+            }, null, 2);
+        },
+    },
+];
+//# sourceMappingURL=sessions.js.map

package/dist/tools/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/tools/sessions.ts"],"names":[],"mappings":"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"}

package/dist/tools/stats.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import type { ClaudeViewClient } from '../client.js';
+interface ToolDef<TSchema extends z.ZodObject<any> = z.ZodObject<any>> {
+    name: string;
+    description: string;
+    inputSchema: TSchema;
+    annotations: Record<string, boolean>;
+    handler: (client: ClaudeViewClient, args: z.output<TSchema>) => Promise<string>;
+}
+export declare const statsTools: ToolDef[];
+export {};
+//# sourceMappingURL=stats.d.ts.map

package/dist/tools/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/tools/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,UAAU,OAAO,CAAC,OAAO,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;IACnE,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,OAAO,CAAA;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAChF;AAgDD,eAAO,MAAM,UAAU,EAAE,OAAO,EAqE/B,CAAA"}

package/dist/tools/stats.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+const getStatsSchema = z.object({
+    project: z.string().optional().describe('Filter by project name'),
+    branch: z.string().optional().describe('Filter by git branch'),
+    from: z
+        .union([z.number(), z.string()])
+        .optional()
+        .describe('Start time (Unix seconds, or ISO 8601 / YYYY-MM-DD date string)'),
+    to: z
+        .union([z.number(), z.string()])
+        .optional()
+        .describe('End time (Unix seconds, or ISO 8601 / YYYY-MM-DD date string)'),
+});
+function parseUnixSeconds(value, field) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            throw new Error(`Invalid ${field} value: must be a finite number`);
+        }
+        return Math.trunc(value);
+    }
+    const trimmed = value.trim();
+    if (trimmed === '') {
+        return undefined;
+    }
+    const numeric = Number(trimmed);
+    if (Number.isFinite(numeric) && /^\d+$/.test(trimmed)) {
+        return Math.trunc(numeric);
+    }
+    const parsedMs = Date.parse(trimmed);
+    if (!Number.isNaN(parsedMs)) {
+        return Math.trunc(parsedMs / 1000);
+    }
+    throw new Error(`Invalid ${field} value: expected Unix seconds or parseable date string`);
+}
+export const statsTools = [
+    {
+        name: 'get_stats',
+        description: 'Get dashboard overview statistics: total sessions, projects, top skills, tool usage totals, current week metrics, and week-over-week trends. Optionally filter by project, branch, or date range.',
+        inputSchema: getStatsSchema,
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        handler: async (client, args) => {
+            const from = parseUnixSeconds(args.from, 'from');
+            const to = parseUnixSeconds(args.to, 'to');
+            const data = await client.get('/api/stats/dashboard', {
+                project: args.project,
+                branch: args.branch,
+                from,
+                to,
+            });
+            return JSON.stringify({
+                total_sessions: data.totalSessions,
+                total_projects: data.totalProjects,
+                top_projects: (data.topProjects ?? []).slice(0, 5).map((p) => ({
+                    name: p.displayName || p.name,
+                    sessions: p.sessionCount,
+                })),
+                top_skills: (data.topSkills ?? []).slice(0, 5),
+                tool_totals: data.toolTotals,
+                current_week: data.currentWeek,
+                trends: data.trends,
+                ranges: data.meta?.ranges,
+            }, null, 2);
+        },
+    },
+    {
+        name: 'get_fluency_score',
+        description: 'Get the AI Fluency Score (0-100 composite) measuring coding effectiveness with Claude. Includes achievement rate, friction rate, cost efficiency, satisfaction trend, consistency.',
+        inputSchema: z.object({}),
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        handler: async (client) => {
+            const data = await client.get('/api/score');
+            return JSON.stringify({
+                score: data.score,
+                achievementRate: data.achievementRate,
+                frictionRate: data.frictionRate,
+                costEfficiency: data.costEfficiency,
+                satisfactionTrend: data.satisfactionTrend,
+                consistency: data.consistency,
+                sessionsAnalyzed: data.sessionsAnalyzed,
+            }, null, 2);
+        },
+    },
+    {
+        name: 'get_token_stats',
+        description: "Get token usage statistics: total input/output/cache tokens, cache hit ratio, session and turn counts. Note: no USD cost fields — use live summary for today's cost.",
+        inputSchema: z.object({}),
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        handler: async (client) => {
+            const data = await client.get('/api/stats/tokens');
+            return JSON.stringify(data, null, 2);
+        },
+    },
+];
+//# sourceMappingURL=stats.js.map

package/dist/tools/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/tools/stats.ts"],"names":[],"mappings":"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"}

package/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/start-server.sh",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/start-server.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+# claude-view SessionStart hook — ensure server is running
+# Non-blocking: ALWAYS exits 0, even if server fails to start.
+# Uses set -uo pipefail (no -e) so the script never aborts early.
+
+set -uo pipefail
+
+PORT="${CLAUDE_VIEW_PORT:-47892}"
+HEALTH_URL="http://localhost:${PORT}/api/health"
+
+# Check if already running (curl inside if-guard: safe with any set flags)
+if curl -sf --max-time 2 "${HEALTH_URL}" >/dev/null 2>&1; then
+  exit 0
+fi
+
+# Locate npx — version managers (nvm, volta, fnm, asdf) put it outside system PATH.
+# Claude Code hooks run with limited env, so we search common locations.
+find_npx() {
+  # 1. Already in PATH?
+  command -v npx 2>/dev/null && return
+  # 2. Common version manager locations
+  for candidate in \
+    "${HOME}/.volta/bin/npx" \
+    "${HOME}/.local/share/fnm/aliases/default/bin/npx" \
+    "/usr/local/bin/npx" \
+    "/opt/homebrew/bin/npx"; do
+    [ -x "$candidate" ] && echo "$candidate" && return
+  done
+  # 3. nvm — glob for the default version
+  for candidate in "${HOME}"/.nvm/versions/node/*/bin/npx; do
+    [ -x "$candidate" ] && echo "$candidate" && return
+  done
+}
+
+NPX="$(find_npx)"
+if [ -z "$NPX" ]; then
+  # npx not found — cannot auto-start server. Tools will show a clear error.
+  exit 0
+fi
+
+# Not running — start in background.
+# CLAUDE_VIEW_NO_OPEN=1 suppresses browser tab open from the hook context.
+# || true ensures nohup failure (e.g. binary download timeout) never propagates.
+CLAUDE_VIEW_NO_OPEN=1 nohup "$NPX" claude-view >/dev/null 2>&1 &
+
+# Wait up to 3 seconds for server to become healthy.
+# On first-ever run, binary download takes 5-30s — this will time out. That's fine:
+# the server starts in the background and will be ready for the next tool call or session.
+for _ in 1 2 3; do
+  sleep 1
+  if curl -sf --max-time 1 "${HEALTH_URL}" >/dev/null 2>&1; then
+    exit 0
+  fi
+done
+
+# Server didn't start in time — don't block the session.
+exit 0

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@claude-view/plugin",
+  "version": "0.8.0",
+  "description": "Claude Code plugin for claude-view — auto-starts web dashboard, provides session/cost/fluency tools and skills",
+  "private": false,
+  "type": "module",
+  "files": [".claude-plugin/", ".mcp.json", "skills/", "hooks/", "dist/", "README.md"],
+  "scripts": {
+    "build": "node scripts/bundle-mcp.mjs",
+    "prepublishOnly": "node scripts/bundle-mcp.mjs",
+    "typecheck": "echo 'no TS in plugin'",
+    "lint": "echo 'markdown + json only'",
+    "test": "node scripts/bundle-mcp.mjs && bash scripts/validate-plugin.sh"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.24"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "claude-code",
+    "claude-code-plugin",
+    "claude-view",
+    "mission-control",
+    "session-analytics",
+    "cost-tracking"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tombelieber/claude-view",
+    "directory": "packages/plugin"
+  },
+  "license": "MIT"
+}

package/skills/daily-cost/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: daily-cost
+description: "Use when the user asks about cost, spending, or budget — e.g. 'how much did I spend today', 'daily cost', 'cost report', 'what's my spend'"
+---
+
+# Daily Cost Report
+
+Show the user's Claude Code spending for today using the claude-view MCP tools.
+
+## Steps
+
+1. **Get live summary.** Call `mcp__claude-view__get_live_summary` to get today's aggregate cost and active session counts.
+
+2. **Get per-session details.** If there are running sessions (needs_attention > 0 or autonomous > 0), call `mcp__claude-view__list_live_sessions` to get per-session project, model, cost, and agent state.
+
+3. **Get dashboard stats.** Call `mcp__claude-view__get_stats` with `from` set to today's date (e.g. `2026-03-01`) to get today's session breakdown.
+
+4. **Present the cost report** in this format:
+
+```
+## Daily Cost Report — [today's date]
+
+**Total spent today:** $X.XX USD
+**Sessions today:** N | **Currently running:** M
+
+### Running sessions
+- [project] — [model] — $X.XX — [agent_state]
+(per-session data from list_live_sessions)
+
+### Token usage today
+- Input: X tokens | Output: Y tokens
+- Cache read: Z tokens
+```
+
+5. **If total cost is $0.00**, say "No Claude Code usage detected today" and suggest checking if the claude-view server has indexed recent sessions.
+
+6. **If the user asks about a different time range** (e.g. "this week", "last month"), use the `from` and `to` parameters on `mcp__claude-view__get_stats` accordingly.

package/skills/session-recap/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: session-recap
+description: "Use when the user asks to recap, summarize, or review a Claude Code session — e.g. 'recap my last session', 'what happened in that session', 'session summary'"
+---
+
+# Session Recap
+
+Summarize a Claude Code session using the claude-view MCP tools.
+
+## Steps
+
+1. **Identify the session.** If the user specified a session ID, use it. Otherwise, call the `mcp__claude-view__list_sessions` tool with `limit: 5` to show recent sessions and ask which one to recap. If the user says "last session" or "most recent", use the first result.
+
+2. **Fetch session details.** Call the `mcp__claude-view__get_session` tool with the session ID.
+
+3. **Present the recap** in this format:
+
+```
+## Session Recap: [project] — [branch]
+
+**Duration:** X minutes | **Model:** [model] | **Turns:** [turns]
+
+### What was done
+[2-3 sentence summary based on recent_commits and summary field]
+
+### Commits
+- `abc1234` — commit message
+- `def5678` — commit message
+
+### Metrics
+- Input tokens: [input_tokens] | Output tokens: [output_tokens] | Cache hits: [cache_read_tokens]
+- Cost efficiency: [from derived_metrics if available]
+```
+
+4. **Keep it concise.** The recap should fit in one screen. If there are more than 5 commits, show the top 5 and note "and N more".

package/skills/standup/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: standup
+description: "Use when the user asks for a standup update, work log, or activity summary — e.g. 'standup update', 'what did I work on today', 'work log', 'daily summary'"
+---
+
+# Standup Update
+
+Generate a standup-style work summary from recent Claude Code sessions.
+
+## Steps
+
+1. **Fetch recent sessions.** Call `mcp__claude-view__list_sessions` with:
+   - `sort: "recent"`
+   - `limit: 20`
+
+   From the results, filter to sessions whose `modified` field (ISO 8601 string) is within the last 24 hours. If the user asks about a different period (e.g. "this week"), adjust the filter accordingly.
+
+2. **For the top 3-5 sessions by duration**, call `mcp__claude-view__get_session` on each to get commit details.
+
+3. **Check for running sessions.** Call `mcp__claude-view__list_live_sessions` to find any currently active sessions for the "In Progress" section.
+
+4. **Present the standup** in this format:
+
+```
+## Standup — [today's date]
+
+### Done
+- **[project] ([branch])** — [1-line summary from recent_commits/summary] (Xm)
+- **[project] ([branch])** — [1-line summary] (Xm)
+
+### In Progress
+- [project] — [model] — [agent_state] (from list_live_sessions)
+
+### Metrics
+- Sessions: N | Total time: Xh Ym | Commits: Z
+```
+
+5. **Keep each item to one line.** The standup should be copy-pasteable into Slack or a standup bot.
+
+6. **If no sessions found in the time range**, say "No Claude Code sessions found in the last 24 hours."