trails/.agents/skills/cmux/references/handles-and-identify.md
Ullrich Schäfer 19f2275b73 Move skills to .agents/skills for cross-agent compatibility
Skills now live in .agents/skills/ — the standard convention
aligned with Pi, OpenAI Codex, and the Agent Skills spec.

.claude/skills is a symlink back to .agents/skills/ so Claude
Code still discovers them.

Updated CLAUDE.md to document the setup.
2026-06-09 13:31:20 +02: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