sot-session-start

name	sot-session-start
description	Bootstrap or repair a backend Codex session on the Ship of Tools comm network. Use after a Codex restart, manual tmux attach, lost comms, or when a session needs to join, start its relay listener, start codex-watch pane injection, poll backlog, and self-test socket-mode relay.

sot-session-start

ccx normally runs this bootstrap before Codex starts. Run it manually only when the session was started without ccx, was resumed in an existing pane, or comms need repair.

Steps

Set a default handle if the launcher did not:

if [ -z "${SOT_COMM_NAME:-}" ]; then
  repo="$(basename "$(git rev-parse --show-toplevel 2>/dev/null || pwd)")"
  host="$(hostname -s 2>/dev/null || hostname)"
  export SOT_COMM_NAME="${repo}-cx-${host}"
fi

Join, listen, and start the Codex wake helper:

~/.sot-comm/bin/comm-join.sh --name "$SOT_COMM_NAME"
~/.sot-comm/bin/comm-listen.sh
if [ -n "${TMUX_PANE:-}" ]; then
  nohup ~/.sot-comm/bin/codex-watch.sh "$SOT_COMM_NAME" "$TMUX_PANE" >/dev/null 2>&1 &
fi
~/.sot-comm/bin/comm-poll.sh

Then prove the relay receive path:

~/.sot-comm/bin/comm-listen.sh --selftest

Exit codes: 0 OK, 3 bridge still connecting on a cold start, 1 endpoint missing or unreachable. For 3, wait a few seconds and rerun once. The real Codex wake proof is a typed [relay] from __selftest__: line from codex-watch.sh.

Socket-Only Endpoint

Do not expect remote TCP 127.0.0.1:18743. Backend scripts auto-discover the Unix socket with sotd session-socket-path ${SOT_BACKEND_LABEL:-sot}. Override only for special cases:

export SOT_RELAY_ENDPOINT=unix:/path/to/sot.sock

Frontend hosts should use their local SSH-forwarded TCP endpoint instead.