Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add volcengine/OpenViking --skill tmux -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/tmux/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tmux/

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.

tmux openclaw Lets an agent work with live tmux sessions: read pane output, send keys and text, wait for a prompt line to show up. CX Codex +1 8,500installs tmux mitsuhiko Runs interactive CLI sessions inside tmux using an isolated socket. Helpful when an agent must feed keystrokes into Python or lldb and scrape pane output. CX Codex +1 425installs tmux-terminal mikeyobrien The tmux-terminal skill uses tmux to send keystrokes, read terminal output, and keep CLI processes running between steps. Use it with interactive TUIs or long-running commands. CX Codex +1 ★ 3,206repo stars tmux-status haxybaxy tmux-status appends status icons to tmux window titles based on Claude Code state. It lets you see when the agent is working or waiting for approval without switching windows. ★ 6repo stars using-tmux-for-interactive-commands obra using-tmux-for-interactive-commands teaches an agent to drive vim, REPLs and interactive git rebase through detached tmux sessions. Useful when plain bash just hangs. CX Codex +1 515installs tmux-cli pchalasani The tmux-cli skill lets an agent work with CLI agents and scripts in other tmux panes. Use it for shell commands, exit-code checks, and pane-to-pane communication. CX Codex +1 ★ 2,039repo stars smux ShawnPana smux controls tmux panes and manages communication between AI agents via tmux-bridge. Useful when multiple agents or background tasks run in parallel panes. CX Codex +1 2,900installs control-cli cursor control-cli — a skill for Claude Code, Codex, Cursor, and other agents that builds a local harness to drive and profile an interactive CLI or TUI. CX Codex +1 2,700installs

From the same set4

Project sponsors

Companies that keep this analytics open