tmux-bridge

Route legacy tmux/zellij room viewer commands to current guidance.

3|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/joshka0/foxctl --skill tmux-bridge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux-bridge
Source: https://github.com/joshka0/foxctl/tree/main/configs/skills-pack/tmux-bridge
Command: npx skills add https://github.com/joshka0/foxctl --skill tmux-bridge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

tmux-bridge solves the confusion and workflow breakage caused by older tmux/zellij “room viewer” conventions by providing a compatibility alias that routes users to the current guidance while preserving the existing operator workflows.

Core Features & Use Cases

  • Compatibility alias: Keeps legacy room viewer naming working without changing the underlying mental model of room execution and messaging.
  • Safe manual interaction guardrails: Enforces a read-before-act cycle so users must mark a target pane as safe before sending, typing, or pressing keys.
  • Stable reply framing: Preserves a consistent header format for manual replies to agent panes, improving traceability and operator clarity.
  • Operational guidance for pane collaboration: Directs users to prefer canonical rooms/view commands and to avoid polling agent panes for replies, using bridge messages instead.

Quick Start

Use tmux-bridge to view or coordinate an agent pane by following the current room viewer instructions via foxctl-room-view.

Frequently Asked Questions about tmux-bridge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate multiple agent panes safely in tmux or zellij?

To coordinate agent panes safely in tmux or zellij, use a compatibility interface that enforces a read-before-act cycle, requiring you to mark a target pane as safe before sending messages or pressing keys.

What is the read-before-act workflow for tmux pane messaging?

The read-before-act workflow for tmux pane messaging requires operators to observe and verify a target pane's status before manually typing, pressing keys, or sending messages to prevent workflow breakage and unintended actions.

Can I use legacy room viewer conventions to observe agent panes across tmux sessions?

Yes, you can use legacy room viewer conventions to observe agent panes across tmux sessions. A compatibility alias routes existing operator workflows to current guidance while preserving the original room execution mental model.

Does tmux-bridge work with zellij terminals for multi-agent coordination?

Yes, tmux-bridge works with zellij terminals for multi-agent coordination. It provides a compatibility interface for the room viewer layer that applies to operator workflows observing agent pane placement across both tmux sessions and zellij terminals.

Why should I use bridge messages instead of polling agent pane scrollback for replies?

You should use bridge messages instead of polling pane scrollback because operational guidance directs users to prefer canonical room status and foxctl mux list views, ensuring stable reply framing and improved traceability.

What is the best way to maintain consistent reply headers when messaging agent panes?

The best way to maintain consistent reply headers when messaging agent panes is to use a stable bridge message header format, which preserves consistent framing for manual replies and improves operator clarity and traceability.