Track your OpenCode AI spending. Real costs from real data.
ocsight reads your OpenCode sessions and shows you exactly what you're spending:
- Cost tracking by provider and model
- Budget limits with spending alerts
- Token usage breakdowns
- Live monitoring of active sessions
# macOS/Linux (Homebrew)
brew install heyhuynhgiabuu/tap/ocsight
# Node.js (npm)
npm install -g ocsight
# Direct download
curl -L https://github.com/heyhuynhgiabuu/ocsight/releases/latest/download/ocsight-$(uname -s)-$(uname -m).zip | tar -xz# See your spending
ocsight summary
# Set budget limits
ocsight budget set --monthly 200
# Monitor live usage
ocsight liveSee your OpenCode usage at a glance with provider breakdowns and daily activity:
Track your AI spending with daily breakdowns and spending alerts:
Browse, analyze, and drill into individual sessions:
Real-time dashboard showing active session costs and tokens:
Set spending limits and get alerts when approaching budgets:
Add budget limits and configure spending alerts:
View detailed budget information and settings:
Browse pricing across 500+ AI models:
ocsight can export your data in multiple formats for reporting and analysis:
{
"summary": {
"totalSessions": 787,
"totalCost": 8736.43,
"totalTokens": 2949563969,
"dateRange": "2024-12-12 to 2024-12-19"
},
"providers": [
{
"name": "anthropic",
"sessions": 26,
"cost": 8237.66,
"tokens": 699650136
}
]
}Date,Provider,Model,Sessions,Tokens,Cost
2024-12-19,anthropic,claude-3.5-sonnet,15,12345678,234.56
2024-12-18,openai,gpt-4o,23,23456789,456.78
2024-12-17,anthropic,claude-3.5-haiku,19,18234567,345.67# OpenCode Usage Report
## Summary
- **Period**: 2024-12-12 to 2024-12-19
- **Total Sessions**: 787
- **Total Cost**: $8,736.43
- **Total Tokens**: 2,949,563,969
## Top Providers
| Provider | Sessions | Cost | Tokens |
| --------- | -------- | --------- | ----------- |
| anthropic | 26 | $8,237.66 | 699,650,136 |
| openai | 77 | $405.73 | 471,822,278 |ocsight summary # Last 7 days
ocsight summary --days 30 # Last month
ocsight summary --provider anthropic # Filter by provider
ocsight summary --detailed # Full breakdownocsight sessions list # List all sessions
ocsight sessions list --recent # Recent only
ocsight sessions show ses_123 # View specific session
ocsight sessions top --cost # Most expensive sessions
ocsight sessions top --tokens # Most tokens usedocsight costs # Last 7 days
ocsight costs today # Today only
ocsight costs --days 30 # Last month
ocsight costs --alert 100 # Alert if >$100/day
ocsight costs --provider anthropic # Filter by providerocsight live # Monitor current session
ocsight live --session ses_123 # Monitor specific session
ocsight live --refresh 5 # Update every 5 secondsocsight export # JSON format
ocsight export --format csv # CSV format
ocsight export --format markdown # Markdown report
ocsight export --output report.csv # Custom filenameocsight models list # List all models
ocsight models providers # List providers
ocsight models show gpt-4o # Model detailsocsight budget set --monthly 200 # Set $200 monthly limit
ocsight budget add # Add provider budget
ocsight budget forecast # Project month-end costs
ocsight budget status # Current budget usage
ocsight budget show # Show budget details📊 Usage Summary
════════════════
Overview
Sessions │ 787
Total Cost │ $8,736.43
Total Tokens │ 2,949,563,969
Avg Cost/Session │ $11.10
Provider Breakdown
┌──────────┬──────────┬──────────┬───────────────┐
│ Provider │ Sessions │ Cost │ Tokens │
├──────────┼──────────┼──────────┼───────────────┤
│ anthropic│ 26 │ $8,237.66│ 699,650,136 │
│ openai │ 77 │ $405.73│ 471,822,278 │
│ github │ 517 │ $0.00│ 805,039,693 │
└──────────┴──────────┴──────────┴───────────────┘
Daily Activity (Last 7 Days)
┌────────────┬─────────┬──────────┬─────────────┐
│ Date │ Sessions│ Cost │ Tokens │
├────────────┼─────────┼──────────┼─────────────┤
│ 2024-12-19 │ 15 │ $234.56│ 12,345,678 │
│ 2024-12-18 │ 23 │ $456.78│ 23,456,789 │
│ 2024-12-17 │ 19 │ $345.67│ 18,234,567 │
└────────────┴─────────┴──────────┴─────────────┘
Real costs from actual model pricing, no estimates
Built with Bun for maximum performance:
- Zstd compression (faster/smaller than gzip)
- SIMD-accelerated ANSI processing
- Native TypeScript execution
- Concurrent test execution
- Handles 10k+ sessions instantly with optimized caching
Set limits, get alerts, forecast spending with conservative projections
Watch costs accumulate in real-time
Detailed breakdowns by provider, model, and time period
Runs locally, never sends your data anywhere
- Bun runtime (recommended) or Node.js 18+
- OpenCode installed
- Session data in
~/.local/share/opencode/storage/
ocsight is optimized for Bun v1.3+:
- 6-57x faster ANSI processing with native SIMD operations
- Smaller cache files using zstd compression instead of gzip
- Faster startup with native TypeScript execution
- 166ms build time using Bun.build API
- Concurrent testing for faster test execution
When running with Bun, you automatically get:
- Native zstd compression for cache (faster + smaller than gzip)
- SIMD-accelerated ANSI stripping in live monitoring
- OS-native credential storage for secrets
- Faster JSON parsing and file I/O
Node.js fallbacks ensure full compatibility without Bun-specific features.
ocsight reads from your local OpenCode storage:
~/.local/share/opencode/storage/
├── session/<project-hash>/ses_*.json # Session metadata
└── message/<session-id>/msg_*.json # Individual messages
git clone https://github.com/heyhuynhgiabuu/ocsight
cd ocsight
bun install
bun run build
bun test
bun run packages/cli/src/index.ts summaryocsight uses Bun's native build system:
# Bundle CLI with Bun.build API
bun run scripts/bundle-cli.ts
# Compile standalone executables
bun build packages/cli/src/index.ts --compile --outfile ocsight-linux-x64
# Run tests with concurrent execution
bun test --concurrent
# Watch mode for development
bun test --watchNative executables are built via CI:
- Linux x64 - Ubuntu 22.04 build
- macOS x64 - Intel Mac build with code signing
- macOS ARM64 - Apple Silicon build with code signing
- Windows x64 - Windows build with .exe output
Download from releases page.
ocsight works out of the box. Optional config:
ocsight budget set --monthly 200 # Set budget
ocsight config show # View config
ocsight config doctor # Validate setupNo data showing?
- Check OpenCode is installed:
which opencode - Verify data exists:
ls ~/.local/share/opencode/storage/ - Run doctor:
ocsight config doctor
Wrong costs?
- ocsight uses models.dev pricing
- Some providers (github) show $0.00 for free tiers
- Custom/enterprise pricing not supported
Performance issues?
- First run caches data (may be slow)
- Use
--daysflag to limit data range - Large histories (>10k sessions) may be slow
- Tip: Run with Bun for 6-57x faster performance vs Node.js
ocsight/
├── packages/
│ ├── cli/ # CLI implementation
│ └── web/ # Documentation website
├── assets/ # Screenshots and examples
├── scripts/ # Build and release scripts
└── README.md # You are here
Contributions welcome! Please:
- Fork the repository
- Create a feature branch
- Add tests for new features
- Submit a pull request
MIT © heyhuynhgiabuu
Track your AI costs with confidence · Built with Bun.js for speed