Bind runtime identity to caller
bind_runtime_identityBinds a caller session's agent row to a verified tmux runtime identity by validating PID, TTY, and pane before saving the tmux pane ID.
Instructions
Bind the caller session's agent row to a verified tmux runtime identity. Pass agent to choose the built-in process matcher (codex, claude-code, opencode), or use custom together with process_pattern. Prefer passing ui_pid for the visible agent UI process; the daemon verifies pid → tty → pane before persisting tmux_pane_id. If ui_pid is unavailable, pass ui_tty together with tmux_pane_id for a weaker but still verified binding path. This tool writes registry state; detect_tmux_pane is for debugging only.
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": {
"agent": "<agent>"
},
"name": "bind_runtime_identity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | Yes | ||
| ui_pid | No | ||
| ui_tty | No | ||
| tmux_pane_id | No | ||
| process_pattern | No |