ship-of-tools

Bootstrap a (re)started Ship of Tools FE session — set the win-fe handle, point relay sends at the local SSH tunnel to the backend Unix socket, re-arm the fast-comm wake (fe-inbox Monitor), and catch up on anything missed during the down-window. Fires automatically as the first turn after an ADR-0017 FE relaunch (via the [terminal] resume_command, i.e. claude --continue "/sot-fe-session-start"); also runnable manually. Activates for "fe session start", "frontend session start", "session start", "bootstrap session", "rearm fe comm", "rearm comm", "fe bootstrap session", "resume bootstrap".

Bootstrap a frontend-side Codex session for Ship of Tools. Use in a local FE terminal/Codex session to set the win-fe handle, send through the local SSH tunnel to the backend Unix socket, read the frontend-local fe-inbox, and coordinate with backend sessions without relying on old remote TCP.

Surface a result you just produced (saved plot/figure, rendered image, screenshot, PDF, HTML report, built doc, output file) in the user's Ship of Tools nav/preview pane — badge it (shown completely, nav + preview, when the user looks; their session is never stolen), never merely name it in text. Fire whenever your work creates something the user should SEE.

Session-to-session messaging for Ship of Tools sessions (fork of agent-comm, cross-tmux-session and cross-machine on shared $HOME). Use when sending messages between Claude sessions, joining/leaving the sot-comm network, checking for messages, listing who is online, or starting/stopping other sessions (durable peers via ccb/ccbe, ephemeral task agents via comm-spawn). Also activates on receiving a message in "[name:repo] ..." format. Activates for "sot send", "sot comm", "comm send", "comm join", "comm poll", "broadcast to sessions", "@<session>", "comm spawn", "spawn a session", "spawn an agent", "start a session on <repo>", "despawn".

Cut a Ship of Tools release — stamp the product version everywhere, tag, and let CI build+publish the GitHub Release (ADR 0030 Phase B). Activates for "cut a release", "release vX.Y.Z", "tag a release", "publish a release", "new release" in the ship-of-tools repo.

Bootstrap a (re)started Ship of Tools BE (backend / tmux) session so it RECEIVES instant fast-comm — run the generic /sot-session-start receive-bootstrap, then add sot-specific checks: confirm a frontend is reachable, report how many FEs are attached, and pull the .claude-bus git fallback. The BE counterpart of /sot-fe-session-start (which is FE-only). Runnable manually or as a `claude --continue` resume turn. Activates for "be session start", "backend session start", "rearm be comm", "be bootstrap session".

Install or update Ship of Tools agent resources (Claude Code skills, Codex skills/hooks, and sot-comm scripts) from the package into ~/.claude, ~/.codex, ~/.local/bin, and ~/.sot-comm. Idempotent. Run after pulling the Ship of Tools repo on a machine to close version skew. Activates for "install sot", "update sot comm", "sync sot", "sot install", "reinstall comm".

Bootstrap a (re)started backend Claude session so it RECEIVES instant fast-comm on the sot-comm network — start the durable relay listener, arm the inbox Monitor that wakes the session, prove the wake path, then catch up on anything missed while it was down. Generic across all projects (no app-specific steps). Runnable manually or as a `claude --continue` resume turn. Activates for "comm session start", "comm bootstrap", "rearm comm", "start relay listener", "receive setup".

Bootstrap or repair a Ship of Tools backend Codex session, including generic Codex comm setup, socket-only relay awareness, frontend reachability ping, and backlog handling. Use for BE session start, backend comm repair, or after restarting a backend Codex pane.

Use Ship of Tools comms from Codex: send/poll messages, coordinate with Claude Code or Codex peers, use socket-only daemon relay, report work-state, and show results through the frontend. Use when asked to message agents, check backlog, repair comms, use @handles, or drive the FE from a Codex session.

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.

One-shot, cross-OS onboarding for a Ship of Tools machine (Windows / Linux / macOS). Walks the user through a Q&A (machine role + backend server info), then does USER-LEVEL installs of every dependency (Rust via rustup, Julia via juliaup when needed), builds the rust/ workspace, writes hosts.toml + settings.toml from the answers, installs the Claude statusline INCLUDING the Windows `bash -c` forward-slash fix, installs + joins sot-comm, and creates a launcher/shortcut. Use for "set up Ship of Tools", "Ship of Tools setup", "onboard this machine", "install the dev env", "new machine setup", "set up rust/julia/statusline for Ship of Tools". Supersedes the older Windows-only setup flow.

Authenticate (or re-authenticate) the GitHub CLI (gh) on a headless box without the browser-wedge — drives the OAuth device flow directly so you enter a short code in any browser (e.g. your Windows one) and gh completes by polling. Use when gh auth is broken/expired, `gh`/`git push` over HTTPS fails with an auth error, or you want to log gh in on a server. Activates for "gh auth", "github auth", "gh login", "authenticate gh", "gh token expired", "re-auth github", "fix gh auth", "gh auth broken", "/sot-gh-auth".

Take a screenshot of the *running* Ship of Tools frontend window (its real current state — mode, selection, preview, drawer) and read it. This is the live-window grab via Windows DWM (PowerShell + System.Drawing.CopyFromScreen on the FE window rect), NOT the headless `--capture` flag (which spawns a fresh separate FE). Use when the user says "selfie", "take a self screenshot", "screenshot the running FE", "look at the live window", or wants the actual on-screen state analyzed.

Deterministically clean up and shut down the LOCAL Ship of Tools frontend — kill the supervisor, then the FE, wait for the daemon to detach the client cleanly, then tear the SSH tunnel (order matters — see below), leaving the remote sotd + workspaces running by design. Use when the user says "clean up and shut down", "shut down the FE", "tear it all down", "close everything", or "/sot-fe-shutdown". NOT for a relaunch (that's the ADR-0017 sentinel) — this is a real quit with no respawn.

Create a git worktree of the current repo and spawn a parallel sot-comm session bound to it (named <repo>-wt-<shortname> so it groups next to its parent in the sessions list); show worktree status (current/done/ready-to-clean + each session's work-state); remind a repo's parent + worktree sessions to compare progress and sync; and clean up a finished worktree (remove + delete branch + despawn). Use when making/spawning a worktree, checking worktree status, polling worktree sessions, syncing them, or cleaning one up. Activates for "new worktree", "create worktree", "spawn worktree", "worktree", "worktree status", "list worktrees", "what worktrees", "are worktrees done", "worktrees ready to clean", "poll worktree", "worktree sync", "sync worktrees", "remind worktrees", "clean worktree", "remove worktree", "wt".