Session

AGH RuntimeSession

agh session events

Read session events

Audience: Operators running durable agent work
Focus: Session guidance shaped for scanability, day-two clarity, and operator context.

agh session events

Read session events

agh session events <id> [flags]

Examples

  # Read the latest stored events
  agh session events sess_1234 --last 20

  # Follow new events until interrupted
  agh session events sess_1234 --follow

Options

      --follow         Stream new events over SSE
  -h, --help           help for events
      --last int       Show only the most recent N events
      --since string   Show events since an RFC3339 timestamp or relative duration
      --type string    Filter by event type

Options inherited from parent commands

      --json            Emit JSON output
  -o, --output string   Output format: human, json, jsonl, or toon (default "human")

Output Formats

Every AGH command supports -o, --output:

human for interactive terminal use
json for scripts and other machine-readable consumers
jsonl for wait or streaming commands that emit one JSON record per line
toon for compact agent-readable summaries

Example:

agh session events <id> -o json

agh session

Manage AGH sessions

agh session health

Read session health and wake eligibility

On this page

agh session events Examples Options Options inherited from parent commands Output Formats