tmux · volcengine — Claude Code skill: control terminal sessions
Control interactive CLIs in tmux by sending input and reading pane output. Useful for monitoring terminal tasks or running coding agents in separate sessions.
AGPL-3.0 152 installs ★ 42,570 updated 2026-10-25
npx skills add volcengine/OpenViking --skill tmux -a claude-codeWhat tmux does
The skill creates and locates tmux sessions, sends commands or key presses, and reads text from a pane. Its wait-for-text.sh helper checks for a pattern in terminal output; find-sessions.sh searches one socket or scans across sockets.
You can run Codex or Claude Code agents in separate sessions and check whether a shell prompt has returned. For parallel fixes, the instructions recommend separate git worktrees. Use tmux for interactive TTY processes; non-interactive background work should run through exec instead.
The tmux binary must be on PATH, and the skill is intended for macOS and Linux. On Windows, it requires WSL with tmux installed inside it, so a Windows shell alone will not run these sessions.
What it helps with
- Send commands to an interactive CLI session
- Read recent text from a terminal pane
- Wait until a prompt or pattern appears
- Run coding agents in separate tmux sessions
- Find sessions attached to a socket
Example prompts for the agent
- Start an interactive Python session in tmux and show its output.
- Run two Codex agents in separate sessions and check whether they have finished.
- Find tmux sessions on this socket and read the latest pane output.
How to install tmux
1Skills CLI (Vercel)
npx skills add volcengine/OpenViking --skill tmux -a claude-code2Manually: put the files in place
~/.claude/skills/tmux/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tmux/
1Skills CLI (Vercel)
npx skills add volcengine/OpenViking --skill tmux -a codex2Manually: put the files in place
.agents/skills/tmux/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add volcengine/OpenViking --skill tmux -a cursor2Manually: put the files in place
.cursor/skills/tmux/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install volcengine/OpenViking bot/workspace/skills/tmux2Manually: put the files in place
.github/skills/tmux/SKILL.md1Skills CLI (Vercel)
npx skills add volcengine/OpenViking --skill tmux -a gemini-cli2Platform CLI
gemini skills install https://github.com/volcengine/OpenViking --path bot/workspace/skills/tmuxManually: put the files in place
.devin/skills/tmux/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add volcengine/OpenViking --skill tmux -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about tmux
How do I install tmux in Claude Code?
Run npx skills add volcengine/OpenViking --skill tmux -a claude-code. The skill file is at ~/.claude/skills/tmux/SKILL.md.
What does the tmux skill do?
It controls interactive terminal processes through tmux: sending input, reading pane output, and tracking coding agents running in sessions.
Which systems can run the tmux skill?
It supports macOS and Linux and requires tmux on PATH. On Windows, use WSL with tmux installed there.
Similar skills
All skills for Agent setup: memory, context, orchestration →tmux by other authors comes first.