trails/.claude/skills/cmux/references/handles-and-identify.md
Ullrich Schäfer b4c0ee954d
Add cmux skills (browser, debug-windows, markdown, core)
Skills for cmux terminal integration: browser automation for visual
verification, debug windows, markdown viewer, and core topology control.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-22 12:25:54 +01:00

774 B

Handles and Identify

Use identify and short handles for deterministic automation targeting.

Handle Inputs

Most v2-backed commands accept:

  • UUID
  • short ref (window:N, workspace:N, pane:N, surface:N)
  • index (where legacy/index-based commands still allow it)

Self Identify

cmux identify --json

Returns current focused topology plus optional caller resolution.

Caller Override

cmux identify --workspace workspace:2
cmux identify --workspace workspace:2 --surface surface:8

Useful for agents that need to route relative actions from a known caller anchor.

Output Shaping

cmux --json identify                 # refs-first output
cmux --json --id-format both identify
cmux --json --id-format uuids identify