tmux-tools

List tmux panes, capture pane text, and create text/PNG snapshots.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/kvcop/ai-kb-assistant --skill tmux-tools
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux-tools
Source: https://github.com/kvcop/ai-kb-assistant/tree/main/.codex/skills/tmux-tools
Command: npx skills add https://github.com/kvcop/ai-kb-assistant --skill tmux-tools

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a secure and reliable way to monitor and interact with tmux sessions remotely, preventing accidental disconnections or data loss during critical operations.

Core Features & Use Cases

  • Remote Monitoring: View the current state of tmux panes and sessions without disrupting them.
  • Data Capture: Extract text or create snapshots (text/PNG) of tmux panes for logging or sharing.
  • Controlled Interaction: Safely send commands to tmux panes when explicitly instructed, with strong safety defaults.
  • Use Case: You're running a long-duration data processing job in a tmux session on a remote server. You can use this skill to periodically check its output and ensure it's running as expected, or to capture the final logs.

Quick Start

List all available tmux panes to identify the one you need to interact with.

Frequently Asked Questions about tmux-tools

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

FAQPage Schema
How do I monitor a remote tmux session without disrupting the running process?

You can monitor a remote tmux session by listing active panes and capturing their text output. This read-only approach ensures you can check the state of long-running jobs without risking accidental disconnections or data loss.

Can I capture the text output of a specific tmux pane from a remote server?

Yes, you can capture the text output of a specific tmux pane remotely. The skill allows you to extract text or create text snapshots of individual panes for logging, sharing, or reviewing terminal output without interfering with the active session.

How do I safely send commands to a tmux pane on a remote server?

To safely send commands to a remote tmux pane, you must use explicit dangerous flags and provide user confirmation. This controlled interaction mechanism prevents accidental execution of destructive actions during remote terminal automation.

Does this tool support taking PNG snapshots of tmux panes?

Yes, this tool supports creating PNG snapshots of tmux panes. You can generate visual captures of your terminal state alongside text snapshots, providing a reliable way to log and share the exact output of your remote sessions.

What is the safest way to interact with tmux sessions during long-duration data processing?

The safest way to interact with tmux during long-duration processing is using read-only operations to check pane states and capture output. The skill prioritizes these safe defaults, requiring explicit confirmation only for potentially destructive actions like sending keys.

Why do I need to provide explicit confirmation when sending keys to a remote tmux session?

Explicit confirmation is required when sending keys to a remote tmux session to prevent accidental data loss or disconnections. This safety mechanism ensures that potentially destructive actions are only executed when intentionally authorized by the user.