A specialized skill for managing and interacting with Claude Code instances running inside tmux sessions using native CLI commands.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install claude-tmux
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install claude-tmux using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is claude-tmux?
The claude-tmux skill enables AI agents to seamlessly interact with Claude Code sessions hosted within tmux environments. By utilizing standard tmux commands rather than relying on external scripts, this skill provides a robust and portable way to monitor and prompt Claude across different project sessions. It is designed to be a core part of the Openclaw Skills collection for developers who need to bridge the gap between their terminal-based AI assistants and their broader automation workflows.
This skill excels at identifying specific Claude panes, capturing recent conversation history, and injecting new prompts directly into the terminal. Whether you are managing multiple projects or just want to automate the maintenance of your Claude context, this tool integrates directly into your existing CLI setup to ensure consistency and speed.
claude-tmux Use Cases
- Monitoring Claude Code outputs across multiple project-specific tmux sessions without switching windows.
- Automating the /compact command to maintain Claude context efficiency during long development tasks.
- Programmatically sending prompts to an active Claude session from an external agent or script.
- Debugging Claude interactions by retrieving raw scrollback buffers for deep technical analysis.
How claude-tmux Works
- The skill identifies the target tmux session and locates a pane specifically titled 'claude' to ensure command accuracy.
- It captures the recent pane buffer (typically the last 200 lines) to parse the current state of the conversation.
- Using the capture-pane command, it identifies the latest user prompt and Claude response based on standard visual markers.
- Prompts or commands are injected into the session via the tmux send-keys function, followed by a simulated Enter key.
- The skill optionally polls the buffer to wait for a response, ensuring the agent receives the full output before proceeding.
claude-tmux Setup
To prepare your environment for this skill, ensure your tmux panes are correctly labeled so they can be discovered by the Openclaw Skills framework:
# Name your window 'claude' within a session
tmux rename-window -t <session_name> claude
# Or set a specific pane title
tmux select-pane -T claude
# Verify the pane is discoverable via CLI
tmux list-panes -a -F '#{session_name}:#{window_index}.#{pane_index} #{pane_title}' | grep -i claude
claude-tmux Data Schema & Taxonomy
| Component | Description |
|---|---|
| Session Name | The unique tmux session identifier (e.g., 'backend-api'). |
| Target Pane | The specific window and pane index where Claude is running. |
| Prompt Marker | The Unicode character ❯ used to identify user inputs. |
| Response Marker | The Unicode character ⏺ used to identify Claude output. |
| Scrollback Buffer | The number of lines (200-400) captured for context retrieval. |
claude-tmux Advanced Features
- Custom Socket Support: Prefix commands with custom tmux sockets using the -S flag for remote or restricted environments.
- Automated Polling: Includes intelligent wait loops that monitor the buffer for new Claude output with configurable timeouts.
- Multi-Session Coordination: Ability to switch between and manage several independent Claude Code instances simultaneously using the Openclaw Skills logic.
- Native Integration: Operates entirely through pure tmux commands, ensuring zero dependencies and high compatibility across different terminal setups.
SKILL.md
Loading
Related Openclaw Skills
AgentVibes Clawdbot local-gen-tts
A high-performance TTS integration that offloads voice generation from your server to remote devices like Android or Linux via SSH.
AgentVibes local-gen-tts for Clawdbot
A low-latency, remote Text-to-Speech integration that allows Clawdbot to speak through local devices using AgentVibes.
AgentVibes Clawdbot Skill: Local TTS Integration
A professional integration that enables remote Text-to-Speech generation for Clawdbot responses using AgentVibes over SSH.
tmux-terminal
A powerful skill for controlling interactive terminal sessions and TUI applications using tmux.
Serper Clone
A self-hosted, Serper-compatible search API powered by SearXNG that provides unlimited web, news, and academic search capabilities.
PayClaw
PayClaw empowers AI agents with UCP-compliant identity badges and single-use virtual Visa cards for secure, human-approved autonomous commerce.
Featured*
