ai-observer: Monitor AI Coding Assistant Usage Locally
Summary
AI Observer is a self-hosted OpenTelemetry backend and dashboard for tracking usage across local AI coding assistants. It brings token and cost data, traces, logs, and metrics together in DuckDB, with both OTLP ingestion and file-based import or watching for supported tools.
At a glance
- Language
- Go
- License
- MIT
- Stars
- 279
- Forks
- 26
- Added to OSRepos
- October 4, 2026
- Last analyzed
- October 4, 2026
Topics
Click on any tag to explore related repositories
Use at your own risk
OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.
Overview
AI Observer collects telemetry from AI coding assistants into a local dashboard, helping developers see usage, estimated costs, latency, errors, and session activity in one place. It runs as a single Go binary with DuckDB storage and does not require an external observability service.
It fits developers who want local visibility into several assistants, including through standard OpenTelemetry ingestion or by importing and watching session files. File-based modes support Claude Code, Codex CLI, and Gemini CLI; GitHub Copilot and OpenCode use OTLP ingestion.
Key Features
- Ingests OpenTelemetry traces, metrics, and logs over HTTP.
- Provides dashboards with real-time updates and configurable saved widgets.
- Tracks token usage and costs across supported tools and model aliases.
- Imports historical Claude Code, Codex CLI, and Gemini CLI session files.
- Watches supported local session files to ingest new activity incrementally.
- Stores data locally in DuckDB and exports telemetry to Parquet.
- Includes REST query endpoints and a WebSocket for dashboard updates.
Use Cases
- Developers comparing token usage and estimated costs across AI coding assistants.
- Individual users who want to inspect assistant errors, latency, and session activity without sending telemetry to a third-party service.
- Teams or maintainers setting up a shared local dashboard for OpenTelemetry data from supported coding tools.
- Users who want to analyze prior Claude Code, Codex CLI, or Gemini CLI sessions without configuring live OTLP export.
Project Facts
- Language: Go
- License: MIT
- Stars: 279
- Forks: 26
- Topics: ai, claude-code, codex-cli, duckdb, gemini-cli, observability, opentelemetry
- Archived: No
Getting Started
Run with Docker and open the dashboard at http://localhost:8080:
docker run -d -p 8080:8080 -p 4318:4318 -v ai-observer-data:/app/data --name ai-observer tobilg/ai-observer:latest
See the README for tool configuration, alternatives for installation, and import or watch instructions.
Alternatives
- agent-observability: It monitors Claude Code and Codex through Prometheus, Loki, Tempo, and Grafana, rather than combining ingestion and storage in DuckDB.
Considerations
- The project is designed for local self-hosting, so you are responsible for running it and retaining its database.
- File import and watch are limited to Claude Code, Codex CLI, and Gemini CLI. Copilot and OpenCode require OTLP ingestion.
- Watch mode and OTLP server mode are mutually exclusive to avoid duplicate data.
- Telemetry content capture can include prompts, code, and tool results. Enable it only in trusted environments.
- Historical file parsing does not provide every live operational metric; some activity metrics are reconstructed and have documented limits.
Source repository
Open the original repository on GitHub.
Related repositories
Similar repositories that may be relevant next.
e2a: Email API for Applications and AI Agents
September 29, 2026
e2a provides an email API and relay for applications and AI agents. It supports transactional sending, inbound mailboxes, and agent replies, with optional human review and hosted or Docker-based deployment.
router: Route AI Requests to the Best Model
September 28, 2026
weave-os/router is a Go proxy that routes AI requests across configured model providers, while accepting Anthropic, OpenAI, and Gemini API formats. It suits developers who want model choice and routing behind one endpoint, including agent and coding-tool users.
ksail: Create and Operate Kubernetes Clusters
September 27, 2026
KSail is a Go-based toolkit for creating and operating Kubernetes clusters across local, nested, and cloud providers. It brings provisioning, GitOps, secrets, cluster operations, and AI interfaces into one tool, for developers and platform teams who want a unified workflow.
Memoh: Give AI Agents Dedicated Cloud Computers
September 26, 2026
Memoh is a multi-agent platform that gives each agent an isolated, always-on workspace with a desktop, browser, network access, and long-term memory. Use your own API keys or host agents such as Claude Code and Codex, either in Memoh Cloud or on your own infrastructure.