Documentation Index
Fetch the complete documentation index at: https://docs.coval.dev/llms.txt
Use this file to discover all available pages before exploring further.
Dashboards provide customizable views for monitoring evaluation results. Each dashboard contains widgets that display charts, tables, or text.
List Dashboards
coval dashboards list [OPTIONS]
| Option | Type | Default | Description |
|---|
--filter | string | — | Filter expression |
--page-size | number | 50 | Results per page |
--order-by | string | — | Sort order |
Get Dashboard
coval dashboards get <dashboard_id>
| Argument | Type | Required | Description |
|---|
dashboard_id | string | Yes | The dashboard ID |
coval dashboards get db_abc123
Create Dashboard
coval dashboards create [OPTIONS]
| Option | Type | Required | Description |
|---|
--name | string | Yes | Display name |
coval dashboards create --name "Production Metrics"
Update Dashboard
coval dashboards update <dashboard_id> [OPTIONS]
| Argument | Type | Required | Description |
|---|
dashboard_id | string | Yes | The dashboard ID to update |
| Option | Type | Description |
|---|
--name | string | New display name |
coval dashboards update db_abc123 --name "Staging Metrics"
Delete Dashboard
coval dashboards delete <dashboard_id>
| Argument | Type | Required | Description |
|---|
dashboard_id | string | Yes | The dashboard ID to delete |
coval dashboards delete db_abc123
Widgets are visual components that live inside a dashboard. All widget commands are nested under coval dashboards widgets.
coval dashboards widgets list <dashboard_id> [OPTIONS]
| Argument | Type | Required | Description |
|---|
dashboard_id | string | Yes | The parent dashboard ID |
| Option | Type | Default | Description |
|---|
--page-size | number | 50 | Results per page |
coval dashboards widgets list db_abc123
coval dashboards widgets get <dashboard_id> <widget_id>
| Argument | Type | Required | Description |
|---|
dashboard_id | string | Yes | The parent dashboard ID |
widget_id | string | Yes | The widget ID |
coval dashboards widgets get db_abc123 wgt_xyz789
coval dashboards widgets create <dashboard_id> [OPTIONS]
| Argument | Type | Required | Description |
|---|
dashboard_id | string | Yes | The parent dashboard ID |
| Option | Type | Required | Description |
|---|
--name | string | Yes | Widget display name |
--type | string | Yes | Widget type (see below) |
--config | string | No | JSON config string or @filepath to read from file |
--grid-w | number | No | Grid width |
--grid-h | number | No | Grid height |
--grid-x | number | No | Grid X position |
--grid-y | number | No | Grid Y position |
| Type | Description |
|---|
chart | Line, bar, or area chart visualization |
table | Tabular data display |
text | Static text or markdown content |
# Create a chart widget
coval dashboards widgets create db_abc123 \
--name "Score Trends" \
--type chart \
--config '{"metric_id": "met_001"}' \
--grid-w 6 \
--grid-h 4
# Create a widget with config from a file
coval dashboards widgets create db_abc123 \
--name "Detailed Report" \
--type table \
--config @widget-config.json
coval dashboards widgets update <dashboard_id> <widget_id> [OPTIONS]
| Argument | Type | Required | Description |
|---|
dashboard_id | string | Yes | The parent dashboard ID |
widget_id | string | Yes | The widget ID to update |
| Option | Type | Description |
|---|
--name | string | New display name |
--type | string | New widget type |
--config | string | New JSON config or @filepath |
--grid-w | number | New grid width |
--grid-h | number | New grid height |
--grid-x | number | New grid X position |
--grid-y | number | New grid Y position |
coval dashboards widgets update db_abc123 wgt_xyz789 \
--grid-w 12 --grid-h 6
coval dashboards widgets delete <dashboard_id> <widget_id>
| Argument | Type | Required | Description |
|---|
dashboard_id | string | Yes | The parent dashboard ID |
widget_id | string | Yes | The widget ID to delete |
coval dashboards widgets delete db_abc123 wgt_xyz789
