Skip to content
Core ConceptsCLI ReferenceAPI Reference
Cli referenceLayout
AGH RuntimeLayout

agh layout arrange

Arrange explicit windows as one tiled group

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

agh layout arrange

Arrange explicit windows as one tiled group

agh layout arrange [flags]

Options

      --actor-id string      Optional actor identifier
      --arrangement string   Arrangement: horizontal, vertical, grid, or stack
      --client string        Connected presentation client ID
      --desktop string       Desktop ID
      --frame string         Group frame as x,y,width,height; defaults to the full desktop
      --group string         Stable group ID; generated when omitted
  -h, --help                 help for arrange
      --origin string        Command origin label (default "cli")
      --resource string      Declarative layout resource ID
      --revision uint        Expected workspace revision
      --window stringArray   Participant window ID; repeat for each window
      --workspace string     Workspace ID

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 layout arrange -o json

On this page

agh layout arrangeOptionsOptions inherited from parent commandsOutput Formats