tmux_monitoring

Monitor tmux sessions for process completion and status updates.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/alangeb/tau --skill tmux-monitoring
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux_monitoring
Source: https://github.com/alangeb/tau/tree/main/src/skills/tmux_monitoring
Command: npx skills add https://github.com/alangeb/tau --skill tmux-monitoring

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the challenge of reliably tracking long-running background processes in terminal sessions, preventing silent failures and ensuring accurate completion detection.

Core Features & Use Cases

  • Smart Polling: Automatically adjusts polling intervals based on task duration to balance system load and responsiveness.
  • Completion Detection: Uses multi-keyword pattern matching to identify success, failure, or error states in real-time.
  • Use Case: When running a long test suite in a background tmux session, this skill monitors the output for specific keywords like FAILED or SUCCESS and notifies the agent immediately upon completion or timeout.

Quick Start

Use the tmux_monitoring skill to poll the background session named test-run for completion using the standard error and success keywords.

Frequently Asked Questions about tmux_monitoring

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

FAQPage Schema
How do I monitor a long-running terminal process in a tmux session for completion?

Long-running background processes in tmux sessions can be monitored using configurable polling intervals that capture session output. This skill detects process completion by matching success, failure, or error keywords, notifying the agent immediately upon completion or timeout.

What is the best way to detect when a background test suite finishes in tmux?

The best way to detect when a background test suite finishes in tmux is to use multi-keyword pattern matching on the session output. This identifies specific keywords like FAILED or SUCCESS, ensuring accurate completion detection without silent failures.

Do I need tmux installed to track background session status updates?

Yes, you need tmux installed on the host system to track background session status updates. The monitoring mechanism requires tmux to execute session capture and perform status checks for process completion and output analysis.

How does smart polling work for background task management in terminal sessions?

Smart polling for background task management works by automatically adjusting polling intervals based on task duration. This mechanism balances system load and responsiveness while continuously tracking session output to identify terminal states.

Can I configure custom success and failure keywords for tmux session monitoring?

Yes, you can configure custom success and failure keywords for tmux session monitoring. The completion detection mechanism uses multi-keyword pattern matching to identify specific success, failure, or error states in the terminal output as they occur.

What happens if a background terminal process becomes idle or times out?

If a background terminal process becomes idle or times out, the monitoring skill identifies the idle timeout state and notifies the agent immediately. This prevents silent failures by tracking session output and recognizing terminal inactivity.