references/handles-and-identify.md

123 tokens · o200k_base · 564 bytes

Handles and Identify

Most v2-backed commands accept a UUID, a short ref (window:N, workspace:N, pane:N, surface:N), or an index where legacy index-based commands still allow it.

cmux identify --json                                  # focused topology + caller resolution
cmux identify --workspace workspace:2                 # route relative actions from a known anchor
cmux identify --workspace workspace:2 --surface surface:8

cmux --json --id-format both identify                 # refs plus UUIDs
cmux --json --id-format uuids identify

Referenced from SKILL.md

66|-----------|-------------|67| [references/handles-and-identify.md](references/handles-and-identify.md) | Handle syntax, self-identify, caller targeting |68| [references/windows-workspaces.md](references/windows-workspaces.md) | Window/workspace lifecycle, reorder/move, and context-menu actions (color, description, rename) |