Skip to content
Session
AGH RuntimeSession

agh session

Manage AGH sessions

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

agh session

Manage AGH sessions

Options

  -h, --help   help for session

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

Subcommands

CommandDescription
agh session eventsRead session events
agh session healthRead session health and wake eligibility
agh session historyShow session history grouped by turn
agh session inspectInspect session health, wake audit, and policy correlation
agh session listList sessions
agh session newCreate a new session
agh session promptSend a prompt to a session
agh session repairInspect and repair an interrupted session transcript
agh session resumeResume a stopped session
agh session soulManage session Soul snapshots
agh session statusShow session status
agh session stopStop a session
agh session waitBlock until a session stops

On this page