Cli referenceLayout
agh layout
Inspect, preview, and change workspace layouts
- Audience
- Operators running durable agent work
- Focus
- Layout guidance shaped for scanability, day-two clarity, and operator context.
agh layout
Inspect, preview, and change workspace layouts
Options
-h, --help help for layoutOptions 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 layout apply | Atomically replace topology from a validated layout document |
| agh layout arrange | Arrange explicit windows as one tiled group |
| agh layout balance | Equalize one split or every split in a group |
| agh layout export | Export a history-free declarative layout document |
| agh layout get | Get the authoritative topology and revision |
| agh layout preview | Preview any semantic window-manager command without writing |
| agh layout redo | Redo the latest undone layout operation |
| agh layout resize | Resize one shared split boundary |
| agh layout undo | Undo the latest workspace layout operation |
| agh layout validate | Validate a declarative layout without writing it |
| agh layout watch | Watch the snapshot fence and later committed topology events |