foxctl-tmux

Community

Guide room traffic in tmux and zellij.

Authorjoshka0
Version1.0.0
Installs0

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 required

Components

scripts

💻 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.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.