simple-tmux

Create detached tmux windows, send commands, and capture pane output.

Updated Jul 10, 2022
One-click install
npx skills add https://github.com/samuerio/.dotfiles --skill simple-tmux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: simple-tmux
Source: https://github.com/samuerio/.dotfiles/tree/main/agents/skills/simple-tmux
Command: npx skills add https://github.com/samuerio/.dotfiles --skill simple-tmux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spawns and manages multiple concurrent processes inside a tmux session, enabling long-running tasks to run in the background without blocking your main workflow.

Core Features & Use Cases

  • Create a new detached tmux window with a meaningful name to run a task in isolation.
  • Send commands to a specific tmux window/pane and keep logs accessible from the main session.
  • Inspect output via capture-pane or listing windows to monitor progress without switching context.
  • Use case: Start a dev server in one window, run a watcher in another, and tail logs in a third, all within a single tmux session.

Quick Start

Create a new detached tmux window named my-task and start your command there.

Frequently Asked Questions about simple-tmux

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

FAQPage Schema
How do I run multiple long-running tasks in the background using tmux?

To run multiple long-running tasks in the background using tmux, you can create detached windows for each process. This allows isolated commands to execute concurrently while keeping your main terminal workflow unblocked.

How do I monitor logs from a server process without switching terminal contexts?

You can monitor logs without switching terminal contexts by using capture-pane to inspect output from specific tmux panes. This keeps background server logs accessible from your main session without disrupting the active window.

Can I run a dev server and a watcher in isolated tmux windows at the same time?

Yes, you can run a dev server and a watcher concurrently by creating isolated detached tmux windows. Each task receives commands independently, allowing parallel execution within a single terminal session.

What is the best way to manage parallel multiprocess tasks in a terminal session?

The best way to manage parallel multiprocess tasks is using a terminal multiplexer to create isolated windows. This method enables independent process execution, output capture, and quick context switching without process interference.

Do I need to install any dependencies to manage tmux sessions for background tasks?

No external dependencies are required to manage tmux sessions for background tasks. The environment verification and session management are handled directly through native tmux commands.

When should I not use tmux for managing concurrent server processes?

You should not use tmux for managing concurrent server processes if your task requires persistent daemon-level orchestration outside a user session. Tmux is best suited for interactive terminal workflows rather than headless system services.