Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

castellan telemetry

Query dashboard telemetry database — sessions, agent transitions, vitals snapshots, and per-tick cost rollups — without a TTY.

Usage

castellan telemetry [--limit 20] [--db <PATH>]
castellan dashboard --history [--limit 20]

Default DB: ~/.config/castellan/telemetry.db.

Key flags

FlagDefaultNotes
--limit20Max rows per query
--dbuser config pathOverride telemetry database

Summary JSON includes cost_rollup_count, session_cost_usd, session_tokens, and recent_costs (from governance cost_rollup wire events recorded while the dashboard is open).

Recipes

Headless session list:

castellan telemetry --limit 5

Dashboard history JSON:

castellan dashboard --history --limit 10