agent-exporter AGENTS.md

Agent Exporter is a CLI tool for tracking and analyzing LLM usage costs across multiple AI agent providers (Oh My Pi, OpenCode, Claude Code/CCUsage, Codex, Antigravity, Qwen). It uses SQLite for storage, calculates costs using @pydantic/genai-prices with a fallback pricing database, and exports data in various formats.

Development Commands

Run in development:

bun run dev <command> [args]
# Example: bun run dev sync --provider opencode

Build executable:

bun run build
# Creates compiled binary at dist/agent-exporter

Type checking:

bun run typecheck

Link for local testing:

bun link
# Then use: agent-exporter <command>

Architecture

Core Data Flow

1. Providers (src/providers/) fetch raw usage data from each platform
2. DatabaseManager (src/database/) stores unified messages in SQLite
3. Pricing (src/core/pricing.ts) resolves Oh My Pi stored/catalog costs, then genai-prices → fallback database → $0
4. Exporters (src/exporters/) transform data into output formats
5. CLI (src/cli.ts) orchestrates everything via Commander.js

Key Patterns

Provider Adapters: Each provider implements one member of the ProviderAdapter union:

• MessagesProviderAdapter: name, dataType: 'messages', and fetchMessages(): Promise<UnifiedMessage[]>
• UsageProviderAdapter: name, dataType: 'usage entries', and fetchUsageEntries(): Promise<UsageEntry[]>

Normalized Data: Message providers return UnifiedMessage[] with standardized token counts (input, output, reasoning, cache creation/read), cost, and metadata. Usage providers return UsageEntry[].

Pricing Resolution:

1. Oh My Pi: preserve non-zero recorded totals; otherwise use the bundled @oh-my-pi/pi-catalog rates
2. Primary: @pydantic/genai-prices via calcPrice(); Oh My Pi wrapper records search without the wrapper provider ID
3. Fallback: src/core/database/prices.ts for exact and regex-matched custom prices
4. Default: $0 for unknown models