tmux-sessions

Manages and automates named tmux sessions for workflows across multiple projects.

30|5|Updated Jul 25, 2025
One-click install
npx skills add https://github.com/phuetz/code-buddy --skill tmux-sessions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux-sessions
Source: https://github.com/phuetz/code-buddy/tree/main/.codebuddy/skills/bundled/tmux-sessions
Command: npx skills add https://github.com/phuetz/code-buddy --skill tmux-sessions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers manage and automate multiple tmux sessions, reducing context switching and improving parallel workstreams.

Core Features & Use Cases

  • Session orchestration: create, attach, detach, and kill named sessions to keep tasks organized.
  • Parallel workflows: run and monitor multiple sessions side-by-side for tests, servers, and logs.
  • Lifecycle templates: reusable patterns for common dev setups (server, test, log-monitor).

Quick Start

Run the following to create a background development server in a named tmux session: tmux new-session -d -s dev-server Attach to the session: tmux attach -t dev-server Start a watcher in a second session: tmux new-session -d -s logs Send commands to the background session: tmux send-keys -t dev-server 'npm run dev' Enter Clean up: tmux kill-session -t dev-server tmux kill-session -t logs

Frequently Asked Questions about tmux-sessions

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

FAQPage Schema
How do I manage multiple tmux sessions across different projects?

You can manage multiple tmux sessions by creating, attaching, detaching, and killing named sessions to run background servers and monitor logs side-by-side. This orchestration keeps parallel workstreams organized across different projects.

How do I send commands to a background tmux session?

You send commands to a background tmux session using the send-keys command with the target session name. For example, use `tmux send-keys -t dev-server 'npm run dev' Enter` to execute commands within a detached session without attaching to it.

What is the best way to run parallel workflows like servers and log monitors in tmux?

The best way to run parallel workflows in tmux is by creating detached named sessions for each task, such as one for a dev server and another for logs. This allows you to monitor tests, servers, and logs side-by-side without context switching.

Do I need tmux installed on my host system to automate session workflows?

Yes, you need tmux installed on your host system to automate session workflows. The skill requires the tmux multiplexer to be present on the host to execute commands for quick session creation, attachment, and lifecycle control.

How do I create and attach to a detached tmux session for a background server?

To create a detached tmux session for a background server, run `tmux new-session -d -s dev-server`. You can later attach to this running session using the command `tmux attach -t dev-server` to view its output.

How do I kill a specific tmux session to clean up background processes?

To kill a specific tmux session and clean up background processes, use the command `tmux kill-session -t <session-name>`. This terminates the targeted session and ends the parallel workflows running inside it.