Cross Session Message

Cross-Session Message

Use the repo-managed send-zellij-message helper when you want to nudge another live tracked task/session with a bounded instruction.

Invocation

/cross-session-message <task slug|tracker ref|session name>

Command

send-zellij-message --project-root "<project-root>" --text "<message>" <target>

Useful flags:

• --execute
• --submit enter
• --tab-name <name>
• --replace-claude-suggestion
• --json

Behavior

• Run the preview first. The helper is dry-run by default.
• Add --execute only after the resolved session/tab target looks correct.
• Use --submit enter only when you intentionally want the target session to receive Enter after the text write.
• Require a supported, uniquely resolved agent pane and a visibly empty composer before execution. Claude Code autocomplete is a narrow exception only after a human confirms it is a suggestion and a flagged preview with --replace-claude-suggestion reports preview_probe_required. Execution sends a non-text cursor probe. A real buffered draft is restored unchanged and blocked; only suggestion_probe: verified_empty_buffer may proceed.
• Treat only outcome: delivered with delivered: true as a forwarded turn. executed: true, staging, or an Enter action alone is not delivery.
• If the receipt is unsafe or unverified, stop and use manual inspection. Never clear, append to, or submit unknown composer text through the helper.
• Keep Claude suggestion-override messages short enough for the whole staged payload to remain visible. If staging is unverified, do not send Enter.
• Stop on ambiguous tab selection, cross-machine targets, or missing tracked session data unless the user is intentionally doing local debug work.
• When XDG_RUNTIME_DIR is absent, the helper may select /run/user/<uid> only if the default namespace lacks an active exact target and that systemd namespace contains it live. The receipt records the selected namespace.
• A uniquely supported wrapped Claude or Codex UI may be identified read-only when process-command metadata is unavailable. Ambiguity fails closed.
• Use this for bounded prompt delivery, status pings, or resumable instructions only. It is not a remote-control channel.

See ~/pro/botfiles/docs/cross-session-orchestration-contract.md for the shared contract.