Skills
.Work. You
Rest

foxctl-room-view

Community

Debug room viewer panes with confidence

Software Engineering#debugging#tmux#zellij#operator tooling#pty inspection#multi-agent rooms#delivery tracing
Authorjoshka0
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps you separate viewer/presentation-layer issues (tmux/zellij panes and PTY output handling) from room delivery/runtime problems, so you can quickly identify why what you see is wrong—or why delivery fails.

Core Features & Use Cases

  • Pane & PTY inspection: Inspect viewer placement and read PTY output for a specific pane target to validate what the participant runtime is actually emitting.
  • Viewer-layer manipulation: Create viewer panes, relabel/adjust viewer placement, and perform one-off manual “pokes” into panes for controlled debugging.
  • Transport vs presentation debugging: Use room status and room-scoped event timelines as the source of truth, while treating mux/viewer behavior as an attachment layer rather than delivery authority.
  • Operational debugging boundaries: Provide clear rules for when to debug the viewer versus when to debug room transport, membership, delivery traces, or loop state.

Quick Start

Run foxctl room status <room-id>, then use foxctl mux list and foxctl mux read <target> --lines 80 to confirm viewer placement and PTY output for the participant.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 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-room-view
Download link: https://github.com/joshka0/foxctl/archive/main.zip#foxctl-room-view

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.