# renzoramosdev/agentboard architecture

> Architecture diagram of the GitHub repository renzoramosdev/agentboard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/renzoramosdev/agentboard
- Repository: https://github.com/renzoramosdev/agentboard

## Overview

AgentBoard is a local-first desktop dashboard for cost and activity across coding agents. Its main workflow reads existing agent logs, parses and incrementally caches them, derives costs and aggregates, then serves filtered results to the dashboard; an MCP server exposes the data to other agents. The README also documents live updates, budgets and alerts, pricing controls, exports, and tray access. Some UI and backend subsystems are unsampled, so their documented capabilities are represented without speculative internal wiring.

Main entry points: [`src/App.tsx`](https://github.com/renzoramosdev/agentboard/blob/main/src/App.tsx) (Dashboard shell), [`src-tauri/src/commands.rs`](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/commands.rs) (Tauri commands), [`src-tauri/src/ingest.rs`](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/ingest.rs) (Incremental ingest), [`src-tauri/src/ingest_thread.rs`](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/ingest_thread.rs) (Ingest worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Log collection"]
  node_provider_parsers["Agent parsers<br/>[mod.rs]"]
  node_incremental_ingest["Incremental ingest<br/>[ingest.rs]"]
  node_watcher["Log watcher<br/>[watcher.rs]"]
  node_ingest_worker["Ingest worker<br/>[ingest_thread.rs]"]
end

subgraph group_core["Rust data core"]
  node_sqlite_cache[("SQLite cache<br/>[db.rs]")]
  node_derived_data["Derived aggregates<br/>[derived.rs]"]
  node_pricing["Model pricing<br/>[pricing.rs]"]
  node_queries["Analytics queries<br/>[queries.rs]"]
  node_sessions["Session details<br/>[sessions.rs]"]
  node_settings["Settings<br/>[settings.rs]"]
  node_alerts["Budget alerts<br/>[alerts.rs]"]
  node_commands["Tauri commands<br/>[commands.rs]"]
  node_export["CSV/JSON export<br/>[commands.rs]"]
end

subgraph group_desktop["Desktop interface"]
  node_app["Dashboard shell<br/>[App.tsx]"]
  node_api["Tauri API client<br/>[api.ts]"]
  node_overview["Overview<br/>[Overview.tsx]"]
  node_analytics_views["Analytics sections<br/>[sections.tsx]"]
  node_projects["Projects and sessions<br/>[Projects.tsx]"]
  node_pricing_view["Pricing controls<br/>[Pricing.tsx]"]
  node_chart_components["Charts and tables<br/>[Charts.tsx]"]
  node_live_view["Live activity<br/>[TodayLive.tsx]"]
  node_tray_view["Tray panel<br/>[TrayPanel.tsx]"]
end

subgraph group_access["Other access"]
  node_mcp_server["MCP server<br/>[main.rs]"]
end

node_person(("Desktop user"))
node_agentlogs["Agent logs"]
node_mcp_client(("AI agent"))

node_agentlogs -->|"read logs"| node_provider_parsers
node_provider_parsers -->|"parse records"| node_incremental_ingest
node_watcher -.->|"request rescans"| node_ingest_worker
node_ingest_worker -->|"run scans"| node_incremental_ingest
node_incremental_ingest -->|"write records"| node_sqlite_cache
node_incremental_ingest -->|"price calls"| node_pricing
node_ingest_worker -->|"recompute"| node_derived_data
node_derived_data -->|"update aggregates"| node_sqlite_cache
node_commands -->|"request ingest"| node_ingest_worker
node_commands -->|"fetch reports"| node_queries
node_commands -->|"fetch sessions"| node_sessions
node_commands -->|"manage settings"| node_settings
node_commands -->|"check budgets"| node_alerts
node_queries -.->|"query data"| node_sqlite_cache
node_sessions -.->|"read details"| node_sqlite_cache
node_person -->|"inspect activity"| node_app
node_app -->|"request data"| node_api
node_api -->|"invoke commands"| node_commands
node_app -->|"show summary"| node_overview
node_app -->|"show reports"| node_analytics_views
node_app -->|"browse projects"| node_projects
node_app -->|"edit pricing"| node_pricing_view
node_analytics_views -->|"render visuals"| node_chart_components
node_person -->|"monitor activity"| node_live_view
node_person -->|"view tray totals"| node_tray_view
node_mcp_client -->|"ask questions"| node_mcp_server
node_mcp_server -.->|"reuse data access"| node_queries
node_person -->|"export reports"| node_export

click node_provider_parsers "https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/providers/mod.rs"
click node_incremental_ingest "https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/ingest.rs"
click node_watcher "https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/watcher.rs"
click node_ingest_worker "https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/ingest_thread.rs"
click node_sqlite_cache "https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/db.rs"
click node_derived_data "https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/derived.rs"
click node_pricing "https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/pricing.rs"
click node_queries "https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/queries.rs"
click node_sessions "https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/sessions.rs"
click node_settings "https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/settings.rs"
click node_alerts "https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/alerts.rs"
click node_commands "https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/commands.rs"
click node_app "https://github.com/renzoramosdev/agentboard/blob/main/src/App.tsx"
click node_api "https://github.com/renzoramosdev/agentboard/blob/main/src/lib/api.ts"
click node_overview "https://github.com/renzoramosdev/agentboard/blob/main/src/views/Overview.tsx"
click node_analytics_views "https://github.com/renzoramosdev/agentboard/blob/main/src/views/sections.tsx"
click node_projects "https://github.com/renzoramosdev/agentboard/blob/main/src/views/Projects.tsx"
click node_pricing_view "https://github.com/renzoramosdev/agentboard/blob/main/src/views/Pricing.tsx"
click node_chart_components "https://github.com/renzoramosdev/agentboard/blob/main/src/components/Charts.tsx"
click node_live_view "https://github.com/renzoramosdev/agentboard/blob/main/src/views/TodayLive.tsx"
click node_tray_view "https://github.com/renzoramosdev/agentboard/blob/main/src/views/TrayPanel.tsx"
click node_mcp_server "https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/mcp/src/main.rs"
click node_export "https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/commands.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_provider_parsers,node_incremental_ingest,node_watcher,node_ingest_worker,node_person toneBlue
class node_sqlite_cache,node_derived_data,node_pricing,node_queries,node_sessions,node_settings,node_alerts,node_commands,node_export toneAmber
class node_app,node_api,node_overview,node_analytics_views,node_projects,node_pricing_view,node_chart_components,node_live_view,node_tray_view toneMint
class node_mcp_server toneRose
class node_agentlogs,node_mcp_client toneIndigo
```

## Components

### Log collection

- [Agent parsers](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/providers/mod.rs): `src-tauri/src/providers/mod.rs`
- [Incremental ingest](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/ingest.rs): `src-tauri/src/ingest.rs`
- [Log watcher](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/watcher.rs): `src-tauri/src/watcher.rs`
- [Ingest worker](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/ingest_thread.rs): `src-tauri/src/ingest_thread.rs`

### Rust data core

- [SQLite cache](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/db.rs): `src-tauri/src/db.rs`
- [Derived aggregates](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/derived.rs): `src-tauri/src/derived.rs`
- [Model pricing](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/pricing.rs): `src-tauri/src/pricing.rs`
- [Analytics queries](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/queries.rs): `src-tauri/src/queries.rs`
- [Session details](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/sessions.rs): `src-tauri/src/sessions.rs`
- [Settings](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/settings.rs): `src-tauri/src/settings.rs`
- [Budget alerts](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/alerts.rs): `src-tauri/src/alerts.rs`
- [Tauri commands](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/commands.rs): `src-tauri/src/commands.rs`
- [CSV/JSON export](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/src/commands.rs): `src-tauri/src/commands.rs`

### Desktop interface

- [Dashboard shell](https://github.com/renzoramosdev/agentboard/blob/main/src/App.tsx): `src/App.tsx`
- [Tauri API client](https://github.com/renzoramosdev/agentboard/blob/main/src/lib/api.ts): `src/lib/api.ts`
- [Overview](https://github.com/renzoramosdev/agentboard/blob/main/src/views/Overview.tsx): `src/views/Overview.tsx`
- [Analytics sections](https://github.com/renzoramosdev/agentboard/blob/main/src/views/sections.tsx): `src/views/sections.tsx`
- [Projects and sessions](https://github.com/renzoramosdev/agentboard/blob/main/src/views/Projects.tsx): `src/views/Projects.tsx`
- [Pricing controls](https://github.com/renzoramosdev/agentboard/blob/main/src/views/Pricing.tsx): `src/views/Pricing.tsx`
- [Charts and tables](https://github.com/renzoramosdev/agentboard/blob/main/src/components/Charts.tsx): `src/components/Charts.tsx`
- [Live activity](https://github.com/renzoramosdev/agentboard/blob/main/src/views/TodayLive.tsx): `src/views/TodayLive.tsx`
- [Tray panel](https://github.com/renzoramosdev/agentboard/blob/main/src/views/TrayPanel.tsx): `src/views/TrayPanel.tsx`

### Other access

- [MCP server](https://github.com/renzoramosdev/agentboard/blob/main/src-tauri/mcp/src/main.rs): `src-tauri/mcp/src/main.rs`

### Other components

- **Desktop user**
- **Agent logs**
- **AI agent**

## Connections

- Agent logs → Agent parsers: read logs
- Agent parsers → Incremental ingest: parse records (evidence: `src-tauri/src/ingest.rs`)
- Log watcher → Ingest worker: request rescans
- Ingest worker → Incremental ingest: run scans (evidence: `src-tauri/src/ingest_thread.rs`)
- Incremental ingest → SQLite cache: write records (evidence: `src-tauri/src/ingest.rs`)
- Incremental ingest → Model pricing: price calls (evidence: `src-tauri/src/ingest.rs`)
- Ingest worker → Derived aggregates: recompute (evidence: `src-tauri/src/ingest_thread.rs`)
- Derived aggregates → SQLite cache: update aggregates (evidence: `src-tauri/src/derived.rs`)
- Tauri commands → Ingest worker: request ingest (evidence: `src-tauri/src/commands.rs`)
- Tauri commands → Analytics queries: fetch reports (evidence: `src-tauri/src/commands.rs`)
- Tauri commands → Session details: fetch sessions (evidence: `src-tauri/src/commands.rs`)
- Tauri commands → Settings: manage settings (evidence: `src-tauri/src/commands.rs`)
- Tauri commands → Budget alerts: check budgets (evidence: `src-tauri/src/commands.rs`)
- Analytics queries → SQLite cache: query data
- Session details → SQLite cache: read details
- Desktop user → Dashboard shell: inspect activity
- Dashboard shell → Tauri API client: request data (evidence: `src/App.tsx`)
- Tauri API client → Tauri commands: invoke commands
- Dashboard shell → Overview: show summary (evidence: `src/App.tsx`)
- Dashboard shell → Analytics sections: show reports (evidence: `src/App.tsx`)
- Dashboard shell → Projects and sessions: browse projects (evidence: `src/App.tsx`)
- Dashboard shell → Pricing controls: edit pricing (evidence: `src/App.tsx`)
- Analytics sections → Charts and tables: render visuals
- Desktop user → Live activity: monitor activity
- Desktop user → Tray panel: view tray totals
- AI agent → MCP server: ask questions
- MCP server → Analytics queries: reuse data access
- Desktop user → CSV/JSON export: export reports
