Skip to content

bhatti events

Show your account's event history, or follow new events as they are committed.

Synopsis

bhatti events [--after <id>] [-f] [--type <prefix>] [--sandbox <sandbox>] [--json]

Description

Reads the authenticated Events API, not the server's local database. You see only your own events, including daemon-recorded thermal transitions and recovery events about your sandboxes. For a server-wide local query, use bhatti admin events instead.

Without --follow, prints one page of up to 1000 events, starting at the oldest retained event or after --after. If more matches remain, stderr prints the --after value for the next page; continue with the same filters. Event IDs are the first column, followed by local time, type, sandbox and details.

With --follow, keeps streaming. Omit --after for new events only; pass --after 0 to replay everything retained first. Remember the highest event ID handled and use it with --after to reconnect. Retention can prune old history: a gap warning goes to stderr if the cursor has fallen behind.

--json passes through the server's NDJSON records unchanged, one per line, including events.gap and events.more control records. It is not a JSON array. Control records have no event ID; see the API record format. Human mode sends control notices to stderr so stdout stays one line per event.

If the server closes a followed stream, the command exits non-zero and prints a command to resume from the last event received (or your original cursor if none arrived). It does not reconnect automatically or treat a daemon restart as a completed listing.

Examples

# One page of retained history; continue after a known event
bhatti events
bhatti events --after 1200

# New events only, or retained history followed by new events
bhatti events --follow
bhatti events --follow --after 0

# Filter by a literal type prefix and sandbox
bhatti events --type thermal --sandbox dev

# Machine-readable stream, including control records
bhatti events --follow --json | jq -r .type

Options

| Flag | Default | Description | | ---- | ------- | ----------- | | --after <id> | omitted | Only events with a greater ID. Must be non-negative. Explicit 0 replays all retained history, including when following. | | -f, --follow | false | Keep streaming new events. Without --after, start at the live edge. | | --type <prefix> | all types | Literal event-type prefix; thermal matches thermal.pause, thermal.wake and other thermal.* types. | | --sandbox <sandbox> | all sandboxes | Filter by sandbox name or ID. Use the ID for a destroyed sandbox. | | --json | false | Raw NDJSON, including control records, rather than human columns and notices. |

See Global flags for --url, --token, --timing and --data-dir.

See also