Skip to content
Core ConceptsCLI ReferenceAPI Reference
Cli referenceWindow
AGH RuntimeWindow

agh window swap

Swap two window placements

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

agh window swap

Swap two window placements

agh window swap [flags]

Options

      --actor-id string    Optional actor identifier
      --client string      Connected presentation client ID
      --first string       First window ID
  -h, --help               help for swap
      --origin string      Command origin label (default "cli")
      --revision uint      Expected workspace revision
      --second string      Second window ID
      --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 window swap -o json

On this page

agh window swapOptionsOptions inherited from parent commandsOutput Formats