31 lines (20 loc) · 1018 Bytes

AGENTS.md

Rust edition: 2024

Architecture

Data flow: db::queries::load_app_data → analytics::build_snapshot → ui::app::App::run

Key Rules

Only assistant messages count toward usage
Default database paths: %APPDATA%/opencode/opencode.db (Windows), ~/.local/share/opencode/opencode.db (Linux), ~/Library/Application Support/opencode/opencode.db (macOS)

Error Handling

Domain modules (db/, cache/, config/) use thiserror with their own errors.rs and Result<T> alias
User-facing code (main.rs, app.rs) uses color_eyre::eyre::Result with .wrap_err()

Pricing

Cache: ~/.cache/oc-stats/models.json (TTL: 1 hour)
Remote: https://models.dev/api.json
OpenCode config overrides take priority
Fallback: cacheWrite = input, cacheRead = input * 0.1
Prefer stored cost from database when available

Theme

Config: ~/.config/oc-stats/config.toml
Index: ~/.config/oc-stats/themes.toml
Overrides: ~/.config/oc-stats/themes/*.toml