term-meshlisted
Install: claude install-skill x-mesh/term-mesh
# term-mesh Core Control
Use this skill to control non-browser term-mesh topology and routing.
## Core Concepts
- Window: top-level macOS term-mesh window.
- Workspace: tab-like group within a window.
- Pane: split container in a workspace.
- Surface: a tab within a pane (terminal or browser panel).
## Fast Start
```bash
# identify current caller context
term-mesh identify --json
# list topology
term-mesh list-windows
term-mesh list-workspaces
term-mesh list-panes
term-mesh list-pane-surfaces --pane pane:1
# create/focus/move
term-mesh new-workspace
term-mesh new-split right --panel pane:1
term-mesh move-surface --surface surface:7 --pane pane:2 --focus true
term-mesh reorder-surface --surface surface:7 --before surface:3
# attention cue
term-mesh trigger-flash --surface surface:7
```
## Handle Model
- Default output uses short refs: `window:N`, `workspace:N`, `pane:N`, `surface:N`.
- UUIDs are still accepted as inputs.
- Request UUID output only when needed: `--id-format uuids|both`.
## Deep-Dive References
| Reference | When to Use |
|-----------|-------------|
| [references/handles-and-identify.md](references/handles-and-identify.md) | Handle syntax, self-identify, caller targeting |
| [references/windows-workspaces.md](references/windows-workspaces.md) | Window/workspace lifecycle and reorder/move |
| [references/panes-surfaces.md](references/panes-surfaces.md) | Splits, surfaces, move/reorder, focus routing |
| [references/trigger-flash-and-health.md](referen