// Dispatch a task prompt to another named tmux pane through session-chat. Use when the user asks to assign work, dispatch a task, or send a tracked task to another Codex session.
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | dispatch |
| description | Dispatch a task prompt to another named tmux pane through session-chat. Use when the user asks to assign work, dispatch a task, or send a tracked task to another Codex session. |
When this skill is invoked, do not add a preamble or narrate the plan. Run the relevant script directly, then return only the formatted result or the shortest actionable message.
Resolve the plugin root:
PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-$HOME/.codex/plugins/cache/girishattri-codex-plugins/session-chat/0.11.0}"
[ -d "$PLUGIN_ROOT" ] || PLUGIN_ROOT="codex/plugins/session-chat"
Parse the first argument as the target pane name and the rest as the task prompt. If either is missing, tell the user:
Usage: $session-chat:dispatch <pane-name> <task prompt>
Run:
PROMPT_FILE=$(mktemp)
cat > "$PROMPT_FILE" <<'EOF'
<prompt>
EOF
bash "$PLUGIN_ROOT/scripts/dispatch-to-session.sh" "<target>" "$PROMPT_FILE"
rm -f "$PROMPT_FILE"
If tmux is not active, explain that dispatch requires running Codex inside tmux.
If the target is not found, suggest $session-chat:panes. If this pane has no name, suggest $session-chat:whoami <name>.
On success, mention that the recipient must use SESSION_CHAT_INCOMING_MODE=auto or assist to read and act on the task; default notify only reports that a dispatch arrived.
If the output reports multiple panes named the same target, tell the user to rename one pane with $session-chat:whoami <name>.
If the output says the dispatch did not land within the timeout, say the target may be busy and retry when idle or raise SESSION_CHAT_VERIFY_TIMEOUT_MS.