foxctl-tmux
CommunityGuide room traffic in tmux and zellij.
System Documentation
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.
Dependency Matrix
Required Modules
None requiredComponents
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: foxctl-tmux Download link: https://github.com/joshka0/foxctl/archive/main.zip#foxctl-tmux Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.