Observability Commands
Genie provides seven command groups for observability:events for the audit log, sessions for Claude Code session history, metrics for machine state, schedule for cron triggers, qa for self-testing, log for a unified real-time feed, and brief for session startup context.
Events
Thegenie events command group queries the PostgreSQL audit event log. Events are structured as OTel-compatible records covering API costs, tool usage, task transitions, and errors.
genie events list
List recent audit events.
| Option | Description |
|---|---|
--type <type> | Filter by event type |
--entity <entity> | Filter by entity type or entity ID |
--since <duration> | Time window, e.g., 1h, 30m, 2d (default: 1h) |
--errors-only | Show only error events |
--limit <n> | Max rows (default: 50) |
--json | Output as JSON |
genie events errors
Show aggregated error patterns.
genie events costs
Cost breakdown from OTel API request events.
| Option | Description |
|---|---|
--today | Show costs from the last 24h |
--since <duration> | Time window (default: 24h) |
--by-agent | Group by agent |
--by-wish | Group by wish |
--by-model | Group by model |
--json | Output as JSON |
genie events tools
Tool usage analytics from OTel tool events.
| Option | Description |
|---|---|
--since <duration> | Time window (default: 24h) |
--by-tool | Group by tool name (default) |
--by-agent | Group by agent |
--json | Output as JSON |
genie events timeline
Full event timeline for a task, agent, wish, or trace ID. Shows all events associated with a specific entity in chronological order.
genie events summary
High-level stats: agents spawned, tasks moved, costs, errors.
genie events scan
Full server cost scan via ccusage. Scans all Claude Code sessions on the machine, not just genie-spawned ones.
Log
Thegenie log command provides a unified observability feed that aggregates transcripts, DMs, team chat, tool calls, and system events into a single stream.
genie log
Unified observability feed for an agent or team.
| Option | Description |
|---|---|
--team <name> | Show interleaved feed for all agents in a team |
--type <kind> | Filter by event kind: transcript, message, tool_call, state, system |
--since <timestamp> | Only events after ISO timestamp |
--last <n> | Show last N events |
--ndjson | Output as newline-delimited JSON (pipeable to jq) |
--json | Output as pretty JSON |
-f, --follow | Follow mode — real-time streaming |
Brief
genie brief shows an aggregated startup brief with context since the last session — useful for agents resuming work or operators reviewing what happened overnight.
genie brief
| Option | Description |
|---|---|
--team <name> | Team name (default: GENIE_TEAM env var) |
--agent <name> | Agent name (default: GENIE_AGENT_NAME env var) |
--since <iso> | Start timestamp (default: last executor end) |
Sessions
Thegenie sessions command group provides history and search across Claude Code sessions. Session metadata and content are stored in PostgreSQL.
genie sessions list
List Claude Code sessions.
| Option | Description |
|---|---|
--active | Show only active sessions |
--orphaned | Show only orphaned sessions |
--agent <name> | Filter by agent |
--json | Output as JSON |
genie sessions replay
Replay a session — interleaves content and events in chronological order.
genie sessions search
Full-text search across session content.
genie sessions ingest
Manual batch import of JSONL session files.
--backfill flag imports all existing JSONL files that haven’t been ingested yet.
Metrics
Thegenie metrics command group provides machine-level state snapshots and agent heartbeat data.
genie metrics now
Current machine state — CPU, memory, active workers, teams.
genie metrics history
Machine snapshot history over time.
1h. Supports durations like 6h, 1d.
genie metrics agents
Per-agent heartbeat summary — shows each agent’s last heartbeat, state, and uptime.
Schedule
Thegenie schedule command group manages cron-based scheduled triggers.
genie schedule create
Create a new schedule.
genie schedule list
List schedules with next due trigger.
genie schedule cancel
Cancel a schedule and skip pending triggers.
genie schedule retry
Reset a failed trigger to pending.
genie schedule history
Show past executions for a schedule.
QA
Thegenie qa command group runs self-testing specs against the Genie CLI itself.