One-click install
npx skills add https://github.com/roerohan/skills --skill tmux-roerohan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux
Source: https://github.com/roerohan/skills/tree/main/tmux
Command: npx skills add https://github.com/roerohan/skills --skill tmux-roerohan

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill solves the common issue of AI agents running long-running development commands (such as dev servers, file watchers, database consoles, and log tailing) directly in the OpenCode shell, which clutters the terminal, loses output when sessions end, and makes it difficult to manage multiple concurrent processes.

Core Features & Use Cases

  • Managed Tmux Panes: Run long-running commands in named, isolated tmux panes to keep your OpenCode terminal clean and preserve process output.
  • Pane Registry: Track all managed panes in a local registry to avoid duplicate processes, reuse existing running panes, and restart services reliably.
  • Helper Scripts: Use pre-built scripts for pane layout arrangement, log reading, input sending, graceful shutdown, and waiting for service readiness.
  • Use Case: When working on a fullstack application with a web server, API, and background worker, use this Skill to run each service in its own named tmux pane, arrange them side-by-side, and monitor logs from any pane without switching terminal contexts.

Quick Start

Use the tmux skill to start your web development server in a named tmux pane so you can monitor its logs and send input to it without blocking your OpenCode terminal.

Frequently Asked Questions about tmux

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

FAQPage Schema
How do I manage multiple dev servers without cluttering my terminal?

You can manage multiple dev servers by running them in isolated, named tmux panes to keep your terminal clean and preserve process output. A registry tracks pane metadata to avoid duplicate processes and enable reliable service restarts.

How do I monitor logs from long-running processes in separate panes?

You can monitor logs from long-running processes using helper scripts that capture output from named tmux panes. This allows you to read logs and send input to any service without switching terminal contexts or losing session history.

What's the best way to run fullstack development workflows with concurrent processes?

The best way to run fullstack workflows is by executing each concurrent service, such as web servers and background workers, in its own named tmux pane. Helper scripts arrange panes side-by-side and handle graceful shutdown for all processes.

Do I need lsof and tmux installed to manage background dev commands?

Yes, you need both tmux and lsof installed to manage background dev commands. Tmux provides the isolated panes for running processes, while lsof helps check service readiness and manage port usage.

Can I reuse an existing running pane instead of starting a duplicate dev server?

Yes, you can reuse an existing running pane because the Skill maintains a local registry of managed panes. This registry tracks metadata to avoid duplicate processes and allows you to reliably interact with or restart services already running.

How do I gracefully shut down concurrent dev servers running in tmux?

You can gracefully shut down concurrent dev servers using pre-built helper scripts designed for pane shutdown. These scripts manage the termination of services across your tmux session while relying on the pane registry for tracking.