mcp-tmux-server

# MCP tmux Terminal Server An MCP server that provides interactive tmux terminal sessions for Claude Code. Run background tasks in tmux sessions that you can attach to and interact with directly. ## Features - **Project-based Sessions**: One tmux session per project (folder), multiple tasks as panes - **Interactive Background Tasks**: Commands run in tmux panes you can attach to - **Full Terminal Access**: Attach with `tmux attach -t claude-<project>` for full control - **Output Monitoring**: Claude Code can capture and monitor terminal output - **Send Input**: Send commands or special keys (Ctrl+C, etc.) to specific tasks - **Task Management**: List, monitor, and kill individual tasks or entire project sessions ## Architecture ``` Project: myapp/ ├── Session: claude-myapp │ ├── Pane 1: backend (python manage.py runserver) │ ├── Pane 2: frontend (npm run dev) │ └── Pane 3: tests (pytest --watch) ``` All tasks for a project share one tmux session with multiple panes. ## Prerequisites - Python >= 3.10 - tmux installed on your system: - macOS: `brew install tmux` - Linux: `apt install tmux` or `yum install tmux` ## Installation ### From PyPI (recommended) ```bash pip install mcp-tmux-server ``` Or with pipx for isolated installation: ```bash pipx install mcp-tmux-server ``` ### From source ```bash git clone https://github.com/GrigoriLab/mcp-tmux-server.git cd mcp-tmux-server poetry install ``` ## Register with Claude Code If installed via pip/pipx: ```bash claude mcp add --transport stdio --scope user tmux-terminal -- mcp-tmux ``` If installed from source: ```bash claude mcp add --transport stdio --scope user tmux-terminal -- \ poetry --directory /path/to/mcp-tmux-server run mcp-tmux ``` ### Verify Registration ```bash claude mcp list ``` ## Available Tools ### `run_in_terminal` Start a command in a new pane within the project's session. **Parameters:** | Name | Type | Required | Description | |------|------|----------|-----------…