Skip to content
SessionSoul
AGH RuntimeSession

agh session soul refresh

Refresh an idle session's Soul snapshot

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

agh session soul refresh

Refresh an idle session's Soul snapshot

agh session soul refresh <session-id> [flags]

Examples

  agh session soul refresh sess_123 --expected-digest sha256:old --json

Options

      --expected-digest string   Expected current session Soul digest for CAS
  -h, --help                     help for refresh
      --idempotency-key string   Optional idempotency key

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 soul refresh <session-id> -o json

On this page