Pre-register codex tmux pane
pre_register_codex_panePre-register a pending tmux-pane claim with pane ID and UUID so a launcher can reserve the pane before starting Codex, letting later agent registration auto-bind the correct UI pid.
Instructions
Pre-register a pending tmux-pane claim so the launcher can claim a tmux pane before starting codex. The launcher should call this with $TMUX_PANE and a freshly generated UUID, then exec codex --remote ... -c xats.agent_id="\"<uuid>\"". When the codex agent later calls register_agent({agent_type:"codex"}) without ui_pid, the daemon uses the pending row to resolve the correct UI pid and auto-bind the pane. Callable without a prior register_agent — launchers have no agent identity yet. TTL defaults to 120 seconds and is capped at 600; pending rows are garbage-collected opportunistically.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"pane_id": "<pane_id>",
"xats_agent_id": "<xats_agent_id>"
},
"name": "pre_register_codex_pane"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pane_id | Yes | ||
| ttl_seconds | No | ||
| xats_agent_id | Yes |