Skip to content
Eigenwise Toolshed

observability

Local, metadata-only telemetry for Claude Code. A bundled observer records session, tool, and subagent lifecycle events into SQLite on your machine, an optional statusline shows live context and usage, and an OpenTelemetry Collector forwards redacted signals to the observer. Logs reach configured sinks, including PostHog, through the observer’s consent-filtered outbox; traces and metrics use separate Collector sink pipelines for Grafana or generic OTLP. Telemetry payloads exclude prompts, responses, code, tool inputs and results, credentials, and environment values. Exporter settings you provide, including OTLP headers or tokens, are stored locally in %LOCALAPPDATA%\Eigenwise\Workbench\observability.json on Windows, or ~/.local/share/Eigenwise/Workbench/observability.json when LOCALAPPDATA is not set, so an exporter can authenticate. Every sink beyond local SQLite is opt-in.

Version: 0.7.34

Skills

Section titled “Skills”
  • enable-project-telemetry: Opt the current project into local Claude Code usage telemetry, or verify its setup. Use to enable, disable, or check project telemetry.

Hooks

Section titled “Hooks”
  • SessionStart (startup|resume): node --no-warnings "${CLAUDE_PLUGIN_ROOT}/lib/observability/ensure.js" --launch
  • SessionStart: node --no-warnings "${CLAUDE_PLUGIN_ROOT}/hooks/observability.js"
  • SessionEnd: node --no-warnings "${CLAUDE_PLUGIN_ROOT}/hooks/observability.js"
  • UserPromptSubmit: node --no-warnings "${CLAUDE_PLUGIN_ROOT}/hooks/observability.js"
  • PreToolUse (*): node --no-warnings "${CLAUDE_PLUGIN_ROOT}/hooks/observability.js"
  • PreToolUse (Agent|Task): node --no-warnings "${CLAUDE_PLUGIN_ROOT}/hooks/request-body-preflight.js"
  • PostToolUse (*): node --no-warnings "${CLAUDE_PLUGIN_ROOT}/hooks/observability.js"
  • Stop: node --no-warnings "${CLAUDE_PLUGIN_ROOT}/hooks/observability.js"
  • SubagentStart: node --no-warnings "${CLAUDE_PLUGIN_ROOT}/hooks/observability.js"
  • SubagentStop: node --no-warnings "${CLAUDE_PLUGIN_ROOT}/hooks/observability.js"

Bin entrypoints

Section titled “Bin entrypoints”
  • install-otel-collector.js
  • observer.js
  • project-telemetry.js
  • prune-observability.js
  • setup-observability.js
  • statusline.js
  • token-usage-report.js
  • verify-project-telemetry.js

Source on GitHub