# `gate.dashboard`: Unified dashboard

```{py:currentmodule} gate.dashboard
```

Unified spend, usage, and quota view for myGate. Builds the dashboard data layer
on top of `gate.cost` (LiteLLM spend API), `gate.quota` (quota tracking + econ
estimation), and `gate.ledger` (session transcript parsing). Orchestrates data
collection, renders CLI tables, serializes JSON, and optionally launches a
pyratatui-based TUI dashboard.

## Data layer

```{eval-rst}
.. autofunction:: gate.dashboard.build_dashboard_data
.. autoclass:: gate.dashboard.DashboardData
```

## CLI rendering

```{eval-rst}
.. autofunction:: gate.dashboard.render_spend_table
.. autofunction:: gate.dashboard.render_usage_table
.. autofunction:: gate.dashboard.render_quota_table
.. autofunction:: gate.dashboard.render_full_dashboard
```

## JSON serialization

```{eval-rst}
.. autofunction:: gate.dashboard.render_json
```

## TUI mode

```{eval-rst}
.. autofunction:: gate.dashboard.render_tui
```

The TUI mode requires the optional `pyratatui` dependency. Install it with:

```sh
uv pip install pyratatui
```

If pyratatui is not installed, the dashboard falls back to CLI table/JSON output.