Cli referenceDesktop State
agh desktop-state
Manage workspace desktop state
- Audience
- Operators running durable agent work
- Focus
- Desktop State guidance shaped for scanability, day-two clarity, and operator context.
agh desktop-state
Manage workspace desktop state
Options
-h, --help help for desktop-stateOptions 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
Subcommands
| Command | Description |
|---|---|
| agh desktop-state delete | Delete one desktop-state value |
| agh desktop-state get | Read one saved desktop-state value |
| agh desktop-state list | List the saved desktop state for a workspace |
| agh desktop-state set | Create or replace one desktop-state value |
| agh desktop-state watch | Watch committed desktop-state changes |