Cli referenceDesktop
agh desktop
Manage virtual desktops in a workspace
- Audience
- Operators running durable agent work
- Focus
- Desktop guidance shaped for scanability, day-two clarity, and operator context.
agh desktop
Manage virtual desktops in a workspace
Options
-h, --help help for desktopOptions 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 clients | Manage connected window-manager clients |
| agh desktop create | Create a persistent virtual desktop |
| agh desktop delete | Delete a desktop with an explicit transfer destination when needed |
| agh desktop list | List persistent virtual desktops |
| agh desktop reorder | Move a desktop to an ordered position |
| agh desktop switch | Switch one connected client to a desktop |
| agh desktop update | Rename a virtual desktop |