tmux SKILL.md skillA

tmux from spoon94/skill-vault is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add spoon94/skill-vault/tmux@git:20260614.43ccc06

Pins git:20260614.43ccc06 in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

spoon94/skill-vault

Path

tmux/SKILL.md

Versions recorded

1

Latest version

git:20260614.43ccc06, committed Jun 14, 2026

Size

11,154 bytes

Repository stars

5

License

MIT

以脚本方式驱动 tmux：创建后台会话、用 send-keys 向运行中的程序发命令、用 capture-pane 读输出。用于自动化 REPL/SSH/调试器、并发跑多个长生命周期服务、跨调用保持 shell 状态、或让用户 attach 到自动化现场——普通 Bash 拿不到 PTY 时使用。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# tmux 自动化技能

本技能教 Claude 如何用 tmux 在自动化场景里**驱动交互式程序**。重点不是手按键绑定，而是用 `tmux` 子命令以脚本方式创建会话、发命令、读输出。

## 心智模型

```
程序  ⊂  面板 (pane, %X)  ⊂  窗口 (window, @X)  ⊂  会话 (session, $X)  ⊂  客户端
```

- 一个**面板**里跑一个程序，提供完整 PTY。
- **窗口**是一组面板的容器，占满终端。
- **会话**是一组窗口，可被多个客户端 attach 共享。
- **服务器**进程在后台维护所有状态；只要服务器没被 kill，会话就一直在。

每种对象都有稳定的**唯一 ID**：会话 `$N`、窗口 `@N`、面板 `%N`。**永远用 ID 定位**——索引 (`0`、`1.2`) 在窗口被创建/关闭时会变，ID 不会。

---

## 何时该用本技能

满足下列任一条即可：

1. 要向已经启动的程序**发命令**（python REPL、psql、gdb、ssh 远端 shell、claude/codex CLI 等）。普通 Bash 启动后无法再向 stdin 投递输入，tmux 可以。
2. 程序拒绝在非 TTY 下工作，或在管道里行为变差（丢色、不刷新、缓冲变怪、curses 错乱）。tmux 提供真 PTY。
3. 需要**多个并发长生命周期服务**，且要分别向它们发命令、分别读输出（前端 dev、后端、worker、日志监控）。
4. 想让**用户随时 attach** 看 Claude 当前操作的现场，或在 Claude 离开后接管。
5. 需要在**跨多次 Claude 工具调用之间保留**同一个 shell/程序的状态（环境变量、cd 后的目录、virtualenv、登录的 ssh 连接）。

不满足以上任何一条时，普通的 Bash 调用就够了，没必要套 tmux。

---

## 黄金法则

**永远先抓 ID，再用 ID 操作。** 创建任何对象时都加 `-d -P -F '#{...}'`，把 stdout 拿到的 ID 存进 shell 变量，后续命令一律用 `-t $ID`。

```bash
# 幂等防御：同名会话已存在则先清掉，避免 new-session 失败
tmux has-session -t '=claude-work' 2>/dev/null && tmux kill-session -t '=claude-work'

# -d 不 attach；-P 打印目标；-F 指定打印格式
S=$(tmux new-session -d -P -F '#{session_id}' -s claude-work)
…

Read the whole file at its exact version.

How to install

mdr add spoon94/skill-vault/tmux@sha256:13a58fc83b69ebfd

[![mdr](https://markdownregistry.com/badge/art_tsmspogk5c7mmvno.svg)](https://markdownregistry.com/a/art_tsmspogk5c7mmvno)

Versions

The registry has recorded 1 version of this file, committed on Jun 14, 2026.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_tsmspogk5c7mmvno
GET https://markdownregistry.com/api/v1/resolve?ref=spoon94/skill-vault/tmux
GET https://markdownregistry.com/api/v1/blob/13a58fc83b69ebfdacecd0a63b544e27be7681ff8097b2fca9a9d341dd572756

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from spoon94/skill-vault

Every file in spoon94/skill-vault

Other files named tmux

Browse by kind, by grade A, or by owner.