OpenSpent

OpenSpent is a privacy-first, local-only monorepo for tracking, analyzing, and visualizing OpenCode AI usage and cost data.

The repository is organized into five workspace members:

• apps/dashboard — the Flutter dashboard application.
• apps/website — the Jaspr static marketing website.
• packages/core — a pure Dart package for shared business logic and domain models.
• packages/openspent_local — local adapters package for SQLite/shared preferences.
• packages/openspent_remote — remote adapters package for Dio/Retrofit network clients.

Privacy First

OpenSpent is designed to avoid sensitive data exposure:

• It does not display prompts.
• It does not display tool arguments (state.input).
• It does not display raw tool output or errors (state.output, state.error).
• Background task ingestion extracts allowlisted metadata only and derives counts and timestamps locally.
• Source switching uses registered labels instead of exposing absolute project roots.
• All application data stays on the local machine.

Current Capabilities

• Multi-currency cost tracking with USD, CZK, and EUR support.
• Local SQLite caching for exchange rates and session metadata.
• Real-time connection to a local OpenCode server.
• Manual SQLite and JSON log ingestion.
• A monochromatic, terminal-inspired dashboard and marketing site.

Workspace Layout

.
├── apps/
│   ├── dashboard/
│   └── website/
├── packages/
│   ├── core/
│   ├── openspent_local/
│   └── openspent_remote/
├── AGENTS.md
└── DESIGN.md

Documentation

• AGENTS.md — Operational guardrails, architecture patterns, and agent-specific guidance.
• DESIGN.md — Visual authority, theme tokens, and dashboard UI/UX rules.

Development

This monorepo uses Melos.

dart pub get
dart run melos run generate
dart run melos run analyze
dart run melos run test
dart run melos run build:website

To run the Flutter dashboard locally:

cd apps/dashboard
flutter run -d macos

The website package contains the Jaspr static app for the marketing site, complete with Tailwind, static EN/CS localization, and a production Dockerfile.

Combined Web Container

The repo root now includes a combined web deployment container that builds both web apps and serves them from a single nginx document root:

• marketing site at /
• dashboard web app at /demo/

Build the combined image from the repository root:

docker build -t openspent-web .

Run it locally:

docker run --rm -p 8080:80 openspent-web

Then open:

• http://localhost:8080/ for the marketing site
• http://localhost:8080/demo/ for the dashboard

This root Dockerfile builds the Jaspr website and the Flutter dashboard web app, including flutter build web --release --base-href /demo/, and copies the dashboard output into a real demo/ subdirectory under nginx's web root.

If you enable browser-origin CORS for the OpenCode server, allow the page origin only. Do not include /demo in the --cors origin value. For local use, allow http://localhost:8080, not http://localhost:8080/demo/.

Troubleshooting

• If the dashboard shows Disconnected during development, make sure the OpenCode API server is running locally.
• If session discovery looks empty, run OpenCode at least once in the target project directory.
• If SQLite-backed data looks stale, remember that OpenCode may still be writing WAL files (opencode.db-wal, opencode.db-shm).

License

OpenSpent is available under the MIT License. See LICENSE.