terminal-multiplexer

Manage background tmux sessions for long-running terminal commands.

7|1|Updated Jul 27, 2021
One-click install
npx skills add https://github.com/podcodar/webapp --skill terminal-multiplexer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: terminal-multiplexer
Source: https://github.com/podcodar/webapp/tree/main/.agents/skills/terminal-multiplexer
Command: npx skills add https://github.com/podcodar/webapp --skill terminal-multiplexer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you start, manage, and monitor long-running terminal jobs reliably so they continue running even if you disconnect from a session.

Core Features & Use Cases

  • Background session management: Create named tmux sessions that keep processes alive across disconnects.
  • Parallel command execution: Run multiple workers or builds simultaneously using separate sessions/windows.
  • Output capture for progress checks: Retrieve pane output to verify status and debug background work.
  • Use Case: Run a development server and a build process at the same time, then check their logs later without losing progress.

Quick Start

Start a detached tmux session named "server" that runs your site locally in the background by asking the AI to execute: tmux new-session -d -s server "bun run dev".

Frequently Asked Questions about terminal-multiplexer

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

FAQPage Schema
How do I keep background processes running after SSH disconnect?

To keep background processes running after SSH disconnect, you can use a terminal multiplexer like tmux to create detached sessions. Processes inside these named sessions continue executing independently, allowing you to reconnect and inspect captured output later.

How do I run parallel builds in separate terminal sessions?

You can run parallel builds in separate terminal sessions by creating multiple detached tmux sessions. This allows simultaneous execution of workers or build processes, with output captured per pane to verify status and debug background work.

What is the best way to monitor long-running development servers remotely?

The best way to monitor long-running development servers remotely is using tmux capture-pane to retrieve pane output. This captures progress and debugging logs from the background session without interrupting the running process.

Do I need tmux installed to manage remote terminal sessions?

Yes, you need tmux installed to manage remote terminal sessions with this approach. The Skill requires tmux to be available and uses its session naming and send-keys features for deterministic control over background jobs.

Why does my build process stop when I disconnect from SSH?

Your build process stops when you disconnect from SSH because it is tied to the active terminal session. Using a terminal multiplexer like tmux creates a detached session that keeps the process alive across network drops and disconnects.