Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@superbased/observer) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@superbased/observer

SuperBased Observer — capture, normalize, compress, and analyze AI coding tool activity across Claude Code, Codex, Cursor, Cline/Roo Code, and GitHub Copilot.

Single binary. Local-only (no network calls from the observer itself). Pure-Go, no CGO.

Install

npm install -g @superbased/observer
observer --version

The package ships pre-built binaries for:

Platform	Architecture
Linux	x64, arm64
macOS (Intel)	x64
macOS (Apple Silicon)	arm64
Windows	x64

If you're on a platform that isn't listed, file an issue or build the binary from source — see the main repo.

Quick start

# 1. Install the package + register hooks with the AI clients you use.
npm install -g @superbased/observer
observer init

# 2. Start the long-running watcher + dashboard + proxy in one process.
observer start &

# 3. Engage the proxy by pointing your AI client at the local URL.
#    Claude Code / Cursor (Anthropic mode):
export ANTHROPIC_BASE_URL=http://127.0.0.1:8820
#    Codex / Cursor (OpenAI mode):
export OPENAI_BASE_URL=http://127.0.0.1:8820/v1

# 4. Open the dashboard.
open http://127.0.0.1:8081/

What you get

Real-time dashboard at http://127.0.0.1:8081/ — cost over time, tool activity, compression savings, stale rereads, patterns, per-tool action breakdowns, and full-workbook Excel export.
Conversation compression — pre-forward trimming of API request bodies. Per-mechanism breakdown (json / code / logs / text / diff / html / drop) so you can see exactly what saved how many tokens.
MCP server with 12 tools every connected AI client can use to query each other's recorded work — get_last_test_result, check_file_freshness, get_failure_context, etc.
Patterns engine — observer patterns derives repeatable behaviours from session history; observer suggest writes them into CLAUDE.md / AGENTS.md / .cursorrules so new sessions inherit them.

Full feature reference + walkthrough: main repo README.

How the npm package works

This package is a thin Node.js shim that locates the right pre-built binary (shipped via optionalDependencies) and spawns it. Same shape as esbuild / swc / @biomejs/biome. No postinstall network calls, no compile step at install time.

License

Apache 2.0 — see LICENSE.