tmux-monitor

Inspect tmux sessions, processes, ports, and generate status reports.

19|6|Updated Mar 25, 2025

Search Tags:#tmux #ports #dev-environment #tmuxwatch #session-status #tmux-monitor #agent-monitor

One-click install

npx skills add https://github.com/stevengonsalvez/agents-in-a-box --skill tmux-monitor

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: tmux-monitor
Source: https://github.com/stevengonsalvez/agents-in-a-box/tree/main/toolkit/claude-code-4.5/skills/tmux-monitor
Command: npx skills add https://github.com/stevengonsalvez/agents-in-a-box --skill tmux-monitor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tmux, jq, lsof, tmuxwatch, and includes scripts (resource) components.

What problem does it solve?

This Skill provides comprehensive visibility into all tmux sessions, running processes, and spawned agents. It helps you quickly answer "what's running?" without manually inspecting every session.

Core Features & Use Cases

Session Discovery: Find and categorize all tmux sessions
Process Inspection: Identify servers, dev environments, and agents
Port Mapping: Show which ports are in use and by what
Status Reporting: Generate detailed reports with recommendations
tmuxwatch Integration: Use tmuxwatch for enhanced real-time monitoring
Metadata Extraction: Read session metadata from .tmux-dev-session.json and agent JSON files

Quick Start

Run the tmux-monitor script to generate a report for all active tmux sessions. Example: bash toolkit/claude-code-4.5/skills/tmux-monitor/scripts/monitor.sh