Cli referenceDesktop State
agh desktop-state list
List the saved desktop state for a workspace
- Audience
- Operators running durable agent work
- Focus
- Desktop State guidance shaped for scanability, day-two clarity, and operator context.
agh desktop-state list
List the saved desktop state for a workspace
agh desktop-state list [flags]Examples
agh desktop-state list --workspace ws_1234
agh desktop-state list --workspace ws_1234 -o jsonOptions
-h, --help help for list
--workspace string Workspace idOptions 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:
humanfor interactive terminal usejsonfor scripts and other machine-readable consumersjsonlfor wait or streaming commands that emit one JSON record per linetoonfor compact agent-readable summaries
Example:
agh desktop-state list -o json