What problem does it solve?
foxctl-tmux resolves confusion during collaborative agent sessions by mapping legacy room viewing and tmux mux commands to the current room viewer layer, ensuring operators route room traffic correctly across tmux/zellij panes.
Core Features & Use Cases
- Compatibility alias: Treat foxctl-tmux as the historical entry point while steering users to the current foxctl-room-view and foxctl-room-agent skills for viewer and participant behavior, respectively.
- Correct pane binding: Clarifies that zellij or tmux panes must be explicitly bound to room membership (not inferred from shared session names), including repair flows via rebind when panes move.
- Stable message format: Enforces a deterministic header format for send operations so replies remain parseable and human-readable without relying on fragile prose.
- Safe context promotion guidance: Recommends promoting derived facts only (e.g., via ContextWiki/Obsidian flow) rather than raw pane dumps after reviewing tmux exchanges.
Use case: you reopen an existing zellij session and need to ensure each pane is properly joined to the correct room/role so agents can exchange messages and produce durable knowledge reliably.
Quick Start
Ask foxctl-tmux to show the correct pane-to-room binding steps for your current tmux or zellij setup and how to send a review message using the tmux-bridge format.