How koureasstavros/aitoolsessiontracker works
AI Tool Session Tracker is a local, read-only browser app for exploring AI coding-agent sessions from provider transcripts and OpenTelemetry data. Users select a provider and inspect sessions, turns, invocations, context, tool activity, token usage, costs, and aggregate statistics. The large viewer module is the documented app entry point; provider modules parse distinct local formats, while shared modules handle OTEL ingestion, source selection, pricing, and configuration storage. The supplied excerpts do not expose the full UI-to-parser orchestration, so only documented or indexed relationships are shown.
Main entry points: session_token_viewer.py Session Viewer · source_archive.py Source Archives · source_otel.py OTEL Receiver · anthropic_claude_local_provider.py Claude Local
Components 20
Viewer
- Session Viewer
session_token_viewer.py
Local Providers
- Claude Local
src/providers/anthropic_claude_local_provider.py - Devin Local
src/providers/cognition_devin_local_provider.py - Copilot Local
src/providers/github_copilot_local_provider.py - Antigravity Local
src/providers/google_antigravity_local_provider.py - Codex Local
src/providers/openai_codex_local_provider.py - Cursor Local
src/providers/xai_cursor_local_provider.py - M365 Copilot
src/providers/m365_copilot_local_provider.py
OpenTelemetry
- OTEL Receiver
src/common/source_otel.py - Claude OTEL
src/providers/anthropic_claude_otel_provider.py - Copilot OTEL
src/providers/github_copilot_otel_provider.py - Codex OTEL
src/providers/openai_codex_otel_provider.py
Shared Services
- Model Pricing
src/common/model_costs.py - Model Mapping
src/common/model_mapping.py - Source Routing
src/common/source_routing.py - Provider Paths
src/common/source_paths.py - Source Archives
src/common/source_archive.py - SQLite Storage
src/common/tracker_database.py
Other components
- User
- OTEL Client
Connections 27
- User → Session Viewer: explores sessions
README.md - Session Viewer → Claude Local: loads sessions
session_token_viewer.py - Session Viewer → Devin Local: loads sessions
session_token_viewer.py - Session Viewer → Copilot Local: loads sessions
session_token_viewer.py - Session Viewer → Antigravity Local: loads sessions
session_token_viewer.py - Session Viewer → Codex Local: loads sessions
session_token_viewer.py - Session Viewer → Cursor Local: loads sessions
session_token_viewer.py - Session Viewer → M365 Copilot: loads sessions
session_token_viewer.py - OTEL Client → OTEL Receiver: sends OTLP
README.md - Session Viewer → OTEL Receiver: reads OTEL sessions
session_token_viewer.py - OTEL Receiver → Claude OTEL: uses adapter
src/common/source_otel.py - OTEL Receiver → Copilot OTEL: uses adapter
src/common/source_otel.py - OTEL Receiver → Codex OTEL: uses adapter
src/common/source_otel.py - OTEL Receiver → SQLite Storage: stores content
src/common/source_otel.py - Session Viewer → Model Pricing: calculates costs
session_token_viewer.py - Session Viewer → Model Mapping: maps models
session_token_viewer.py - Session Viewer → Source Routing: selects source
session_token_viewer.py - Claude Local → Provider Paths: finds storage
src/providers/anthropic_claude_local_provider.py - Copilot Local → Provider Paths: finds storage
src/providers/github_copilot_local_provider.py - Claude Local → Source Archives: archives sources
src/providers/anthropic_claude_local_provider.py - Devin Local → Source Archives: archives sources
src/providers/cognition_devin_local_provider.py - Copilot Local → Source Archives: archives sources
src/providers/github_copilot_local_provider.py - Antigravity Local → Source Archives: archives sources
src/providers/google_antigravity_local_provider.py - Codex Local → Source Archives: archives sources
src/providers/openai_codex_local_provider.py - Cursor Local → Source Archives: archives sources
src/providers/xai_cursor_local_provider.py - M365 Copilot → Source Archives: archives sources
src/providers/m365_copilot_local_provider.py - Source Routing → SQLite Storage: persists settings
src/common/source_routing.py