@superbased/observer 1.6.1 → 1.6.3

package/README.md

@@ -6,29 +6,13 @@
 
 **Capture, normalize, compress, and analyze every AI coding tool call you
 run** — across Claude Code, Codex, Cursor, Cline / Roo Code, GitHub
-Copilot, OpenCode, OpenClaw, Pi, Google Antigravity, and Gemini CLI —
-in one local single-binary tool. No telemetry, no cloud, no data
-leaves your machine.
+Copilot (VS Code), GitHub Copilot CLI, OpenCode, OpenClaw, Pi, Google
+Antigravity, Gemini CLI, and Cowork — in one local single-binary tool.
+No telemetry, no cloud, no data leaves your machine.
 
-```
-  ┌──────────────┐    ┌──────────────────────────────────┐
-  │  AI clients  │ ─▶ │ observer proxy   :8820 (local)   │ ─▶ Anthropic / OpenAI
-  │  (Claude     │    │   • intercepts every API call    │
-  │   Code,      │    │   • compresses conversations     │
-  │   Cursor,    │    │   • records api_turns + tokens   │
-  │   Codex …)   │    └──────────────┬───────────────────┘
-  │              │                   ▼
-  │              │ ◀── observer mcp (stdio JSON-RPC) ◀── 12 cross-client tools
-  └──────┬───────┘
-         │ JSONL session logs
-         ▼
-  ┌──────────────────────────────────────────────────────────────┐
-  │  observer watch    SQLite store    :8081 dashboard           │
-  │   • normalizes tool calls            • cost over time        │
-  │   • freshness, redundancy detection  • compression savings   │
-  │   • patterns, suggestions            • discovery / waste     │
-  └──────────────────────────────────────────────────────────────┘
-```
+<p align="center">
+  <img src="https://github.com/marmutapp/superbased-observer/raw/main/docs/assets/infographics/one-local-path.png" alt="One local path for AI coding activity" width="780">
+</p>
 
 # Table of contents
 
@@ -180,6 +164,10 @@ export OPENAI_BASE_URL=http://127.0.0.1:8820/v1
 
 ## Architecture in detail
 
+<p align="center">
+  <img src="https://github.com/marmutapp/superbased-observer/raw/main/docs/assets/infographics/intelligence-across-tools.png" alt="Shared local intelligence layer across tools" width="780">
+</p>
+
 Five components running side by side:
 
 ### 1. JSONL adapters (passive ingest)
@@ -254,10 +242,14 @@ Code's run. See [MCP tools reference](#mcp-tools-reference).
 
 ## Dashboard tour
 
-Open `http://127.0.0.1:8081/` after `observer start`. Eight tabs.
+Open `http://127.0.0.1:8081/` after `observer start`. Ten tabs.
 
 ### Overview tab
 
+<p align="center">
+  <img src="https://github.com/marmutapp/superbased-observer/raw/main/docs/assets/screenshots/01-overview.png" alt="Overview tab" width="900">
+</p>
+
 High-level snapshot of the selected window:
 
 - **KPI tiles**: Sessions count, API turns (proxy-captured), Token
@@ -272,6 +264,10 @@ High-level snapshot of the selected window:
 
 ### Cost tab
 
+<p align="center">
+  <img src="https://github.com/marmutapp/superbased-observer/raw/main/docs/assets/screenshots/04-cost.png" alt="Cost tab" width="900">
+</p>
+
 Per-model breakdown over the selected window. Tokens split into the
 four billing buckets, with computed dollar cost and a reliability
 flag. Cost is always computed locally as `tokens × pricing_table[model]`
@@ -288,8 +284,30 @@ uses those as-is when present. See
 Hover any column header for tooltip; click for the full definition
 in the help drawer.
 
+### Analysis tab
+
+<p align="center">
+  <img src="https://github.com/marmutapp/superbased-observer/raw/main/docs/assets/screenshots/05-analysis.png" alt="Analysis tab" width="900">
+</p>
+
+Spending insights for the selected window. Twelve headline KPI
+tiles comparing this period to prior: spend Δ%, MTD vs budget with
+projection bar, $/M output rate, cache savings + cache efficacy %,
+high-context turn count, $/turn, burn rate ($/active hour), top
+model concentration %, Discovery waste $, sessions total. Below
+the tiles: a daily-spend stacked bar with Model / Project / Tool
+dimension toggle, hour-of-day heatmap, top-12 expensive sessions
+with explanatory badges (`opus`, `lc_tier`, `many_turns`,
+`large_prompt`), period-over-period movers (top increases / decreases
+/ new entrants), and routing-efficiency suggestions (trivial Opus
+sessions that could have used Sonnet).
+
 ### Sessions tab
 
+<p align="center">
+  <img src="https://github.com/marmutapp/superbased-observer/raw/main/docs/assets/screenshots/02-sessions.png" alt="Sessions tab" width="900">
+</p>
+
 One row per AI-coding session. Each session has a stable ID, a tool
 (claude-code / cursor / codex / cline / copilot / opencode / openclaw /
 pi / antigravity / gemini-cli), a working-directory project, action
@@ -298,7 +316,12 @@ the `Agent` tool), per-session **Tokens** and **Cost** columns, and —
 if `observer score` has run — quality / errors / redundancy ratios. The `~` suffix on Cost flags rows whose pricing
 was tier-fallback rather than billing-grade ("accurate" reliability).
 
-Click a row to open the session-detail modal:
+Click a row to open the session-detail panel:
+
+<p align="center">
+  <img src="https://github.com/marmutapp/superbased-observer/raw/main/docs/assets/screenshots/10-session-detail.png" alt="Session detail slide-over" width="900">
+</p>
+
 
 - **Top tiles** — Tool, Started, Actions count (ok/fail), Cost.
 - **Action breakdown** — chart of action_type counts.
@@ -325,6 +348,10 @@ Click a row to open the session-detail modal:
 
 ### Actions tab
 
+<p align="center">
+  <img src="https://github.com/marmutapp/superbased-observer/raw/main/docs/assets/screenshots/03-actions.png" alt="Actions tab" width="900">
+</p>
+
 The flat firehose: every recorded tool call, normalized across
 adapters. Filter by action type (`read_file`, `write_file`,
 `run_command`, `spawn_subagent`, `todo_update`, `mcp_call`, …).
@@ -333,6 +360,10 @@ the heading.
 
 ### Tools tab
 
+<p align="center">
+  <img src="https://github.com/marmutapp/superbased-observer/raw/main/docs/assets/screenshots/06-tools.png" alt="Tools tab" width="900">
+</p>
+
 Per-AI-client (the *client* — claude-code / cursor / codex / etc., not
 the per-tool name) aggregates plus three views:
 
@@ -347,6 +378,10 @@ the per-tool name) aggregates plus three views:
 
 ### Compression tab
 
+<p align="center">
+  <img src="https://github.com/marmutapp/superbased-observer/raw/main/docs/assets/screenshots/07-compression.png" alt="Compression tab" width="900">
+</p>
+
 How many tokens and dollars the conversation-compression pipeline
 saved by trimming requests before forwarding upstream:
 
@@ -366,6 +401,10 @@ saved by trimming requests before forwarding upstream:
 
 ### Discovery tab
 
+<p align="center">
+  <img src="https://github.com/marmutapp/superbased-observer/raw/main/docs/assets/screenshots/08-discovery.png" alt="Discovery tab" width="900">
+</p>
+
 Wasted-effort signals:
 
 - **Stale rereads** — files re-read after they changed inside the
@@ -394,6 +433,22 @@ observations push it higher) and an observation count.
 high-confidence ones into `CLAUDE.md` / `AGENTS.md` / `.cursorrules`
 so new sessions inherit your habits.
 
+### Settings tab
+
+<p align="center">
+  <img src="https://github.com/marmutapp/superbased-observer/raw/main/docs/assets/screenshots/09-settings.png" alt="Settings tab" width="900">
+</p>
+
+Fully editable visual editor for everything in `config.toml`.
+Pricing overrides hot-reload (no daemon restart — `cost.Engine`
+swaps the pricing table atomically via `atomic.Pointer.Store`).
+The Backfill panel surfaces every `observer backfill` mode as
+click-to-run buttons that spawn the CLI as a child process and
+stream output back live. Watcher / Freshness / Retention / Hooks /
+Proxy / Compression / Intelligence sections are schema-driven forms
+with inline help; a "Restart daemon" banner appears whenever a
+section is saved that consumers bind at startup.
+
 ### Help drawer
 
 Press `?` anywhere on the dashboard or click the **? Help** button in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superbased/observer",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "SuperBased Observer — capture, normalize, compress, and analyze AI coding tool activity across Claude Code, Codex, Cursor, Cline/Roo, and Copilot.",
   "keywords": [
     "ai",
@@ -36,11 +36,11 @@
     "LICENSE"
   ],
   "optionalDependencies": {
-    "@superbased/observer-linux-x64": "1.6.1",
-    "@superbased/observer-linux-arm64": "1.6.1",
-    "@superbased/observer-darwin-x64": "1.6.1",
-    "@superbased/observer-darwin-arm64": "1.6.1",
-    "@superbased/observer-win32-x64": "1.6.1"
+    "@superbased/observer-linux-x64": "1.6.3",
+    "@superbased/observer-linux-arm64": "1.6.3",
+    "@superbased/observer-darwin-x64": "1.6.3",
+    "@superbased/observer-darwin-arm64": "1.6.3",
+    "@superbased/observer-win32-x64": "1.6.3"
   },
   "scripts": {
     "test": "node bin/observer.js --version"