tmux

tmux terminal multiplexer. Use for terminal sessions.

7 stars

byG1Joshi

View on GitHub Installation ↓

Best use case

tmux is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

tmux terminal multiplexer. Use for terminal sessions.

Teams using tmux should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/tmux/SKILL.md --create-dirs "https://raw.githubusercontent.com/G1Joshi/Agent-Skills/main/skills/tools/tmux/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/tmux/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How tmux Compares

Feature / Agent	tmux	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

tmux terminal multiplexer. Use for terminal sessions.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Tmux

Tmux decouples your terminal session from the window. Detach, go home, SSH in, attach, and your cursor is exactly where you left it. v3.5 adds extended keys.

## When to Use

- **Remote Work**: Mandatory for SSH. If connection drops, your run continues.
- **Pair Programming**: Two users can attach to the same session.
- **Layouts**: Run Editor, Server, and Logs in one window.

## Core Concepts

### Session / Window / Pane

Hierarchy: Session > Windows (Tabs) > Panes (Splits).

### Prefix Key

Default `Ctrl+b`. Most users remap to `Ctrl+a`.

### Plugins (TPM)

Tmux Plugin Manager. `tmux-resurrect` saves state across reboots.

## Best Practices (2025)

**Do**:

- **Use True Color**: Ensure `termguicolors` works in Vim inside Tmux.
- **Use `tmux-sensible`**: Sets sane defaults (utf8, history limit).
- **Script Layouts**: Use `tmuxinator` to launch standard workspace layouts.

**Don't**:

- **Don't nest tmux**: Running tmux inside tmux is a path to madness.

## References

- [Tmux Wiki](https://github.com/tmux/tmux/wiki)