tmux-processes

Manage long-lived development processes in tmux sessions with lifecycle controls.

53|7|Updated Jun 28, 2025
One-click install
npx skills add https://github.com/0xBigBoss/claude-code --skill tmux-processes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux-processes
Source: https://github.com/0xBigBoss/claude-code/tree/main/.claude/skills/tmux-processes
Command: npx skills add https://github.com/0xBigBoss/claude-code --skill tmux-processes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides patterns and guidance for managing long-running processes inside tmux to keep development work flowing without losing context across sessions.

Core Features & Use Cases

  • Session management and naming: derive a project-scoped tmux session and organize multiple windows for server, watcher, and logs.
  • Idempotent startup: safely start processes only if not already running, avoiding duplicates.
  • Lifecycle controls: stop, restart, and attach to sessions with predictable behavior.
  • Quick wins: open a dev server window, a tests window, and a logs window with minimal commands.

Quick Start

Open a tmux session named after your project and start the dev workflow: tmux new-session -d -s "$SESSION" -n server tmux send-keys -t "$SESSION:server" 'npm run dev' Enter If the session already exists, attach to it: tmux attach -t "$SESSION"

Frequently Asked Questions about tmux-processes

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

FAQPage Schema
How do I manage long-running dev servers and file watchers in tmux without losing context?

You can manage long-running dev servers and watchers in tmux by automating session lifecycle controls. This approach derives a project-scoped session name from your project root, enabling idempotent starts to safely launch processes only if they are not already running.

How do I prevent duplicate processes when starting a dev server in a tmux session?

To prevent duplicate processes when starting a dev server in a tmux session, use idempotent startup patterns. This lifecycle management technique checks if the target session already exists before sending commands, avoiding duplicate server instances and maintaining predictable behavior.

Can I organize multiple windows for server, watcher, and logs within a single tmux project session?

Yes, you can organize multiple windows for server, watcher, and logs within a single tmux session. This lifecycle pattern enables dynamic window creation and status monitoring, allowing you to open distinct windows for different development tasks with minimal commands.

What is the best way to name tmux sessions for multi-window development workflows?

The best way to name tmux sessions for multi-window workflows is by enforcing session naming from the project root. This project-scoped naming convention ensures predictable lifecycle controls for starting, stopping, reusing, and attaching to your development sessions.

Do I need any extra dependencies besides tmux to automate process lifecycle controls?

No, you do not need any extra dependencies besides tmux to automate process lifecycle controls. This approach requires only tmux and standard shell commands to manage long-lived development processes, enforcing session naming and providing reliable start, stop, and restart functionality.

How do I restart or stop long-lived development processes in tmux?

To restart or stop long-lived development processes in tmux, use dedicated lifecycle controls. These shell command patterns target your project-scoped tmux session by name, providing predictable behavior for stopping, restarting, and reusing active development workflows without losing context.