tmux-observer-friendly

Manage tmux sessions by replacing panes and windows to preserve observer connections.

2|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/tankygranny05/agent-box --skill tmux-observer-friendly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux-observer-friendly
Source: https://github.com/tankygranny05/agent-box/tree/main/agent-box/seed/codex-skills/tmux-observer-friendly
Command: npx skills add https://github.com/tankygranny05/agent-box --skill tmux-observer-friendly

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill ensures that when creating or restarting tmux sessions, attached observers are not disconnected, providing a seamless experience for collaborative or monitored work.

Core Features & Use Cases

  • Preserves Observer Connections: Avoids kicking users by never killing the tmux session itself.
  • Forceful Pane Replacement: Restarts workloads by creating new panes and forcefully terminating old processes within them.
  • Deterministic Session State: Converges to exactly one session, one window, and one pane for a predictable user experience.
  • Use Case: A developer needs to restart a long-running process in a tmux session that several colleagues are observing. This skill allows the restart without disrupting their view.

Quick Start

Use the tmux-observer-friendly skill to set up a session named 'Hermione' in the '~/TheSwarm/Armada' directory, resuming session 'ba73acbe-6a42-4317-a634-33948601db8d'.

Frequently Asked Questions about tmux-observer-friendly

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

FAQPage Schema
How do I restart a process in a tmux session without disconnecting attached observers?

Restarting a long-running process without disconnecting tmux observers requires replacing panes instead of killing the session. This approach forcefully terminates old processes within new panes while keeping attached users connected.

How does tmux session management maintain a deterministic state for consistent user experience?

Tmux session management maintains a deterministic state by converging to exactly one session, one window, and one pane. This predictable structure ensures consistent user experience during collaborative work and monitored sessions.

Why does restarting a tmux session kick off attached users and how can I avoid it?

Restarting a tmux session kicks off attached users because killing the session disconnects everyone. Avoid this by using pane replacement to restart workloads, which preserves the session and keeps observers connected.

Can I run commands in a specific tmux pane while keeping the session alive for collaborators?

Yes, you can run commands in a specific tmux pane while keeping the session alive. The process handles session creation, window cleanup, pane splitting, and command execution within the target pane without killing the session.

What is the best way to manage tmux sessions for collaborative development with multiple observers?

The best way to manage tmux sessions for collaborative development is to enforce a deterministic state of one session, one window, and one pane. This approach replaces panes forcefully and avoids session termination to maintain observer connections.

Do I need to manually clean up tmux windows when restarting a long-running process?

No, you do not need to manually clean up tmux windows when restarting a long-running process. The management skill handles window cleanup, pane splitting, and session creation automatically to converge on a deterministic state.