← Schema index / Config Reference
pi schema
Canonical generated docsThis section is generated from
caco config schema --json. The table below preserves the runtime field path, type, required/default markers, and canonical description for every value in this slice.Pi interactive agent configuration — houses the managed Pi session widget framework.
| Field path | Type | Required | Default | Canonical description |
|---|---|---|---|---|
pi | section | optional | Pi interactive agent configuration — houses the managed Pi session widget framework. | |
└ pi.widgets | PiWidgetsConfig | optional | Widget framework configuration. `enabled` is a list of widget names; additional keys at the same level are per-widget override blocks. | |
└ pi.widgets.enabled | list<string> | optional | Widget names to enable for managed Pi sessions (e.g. 'system-health'). | |
└ pi.widgets.<widget-name> | PiWidgetConfig | optional | Per-widget configuration block keyed by widget name. | |
└ pi.widgets.<widget-name>.slot | string | optional | top-right | Session slot: top-left, top-right, bottom-left, bottom-right, status-line. |
└ pi.widgets.<widget-name>.refresh_ms | u64 | optional | 5000 | Refresh interval in milliseconds. |
└ pi.widgets.<widget-name>.collapsed_width | u32 | optional | 60 | Terminal width below which the widget collapses to its one-line view. |