README.md•1.85 kB
# @audibleblink/tmux-mcp-server
An MCP (Model Context Protocol) server for managing local tmux sessions. Enables AI assistants to interact with tmux for terminal multiplexing, session management, and command execution.
## Installation
```bash
npm install -g @audibleblink/tmux-mcp-server
```
Or run directly with npx:
```bash
npx @audibleblink/tmux-mcp-server
```
## Requirements
- Node.js >= 18
- tmux installed and available in PATH
## Usage
### With Claude Desktop
Add to your Claude Desktop config (`~/.config/claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"tmux": {
"command": "npx",
"args": ["-y", "@audibleblink/tmux-mcp-server"]
}
}
}
```
### With OpenCode
Add to your OpenCode config (`~/.config/opencode/config.json`):
```json
{
"mcp": {
"servers": {
"tmux": {
"type": "local",
"command": ["npx", "-y", "@audibleblink/tmux-mcp-server"]
}
}
}
}
```
### Standalone
```bash
tmux-mcp-server
```
## Available Tools
### Session Management
- `tmux_list_sessions` - List all active tmux sessions
- `tmux_create_session` - Create a new tmux session
- `tmux_kill_session` - Kill a tmux session
- `tmux_rename_session` - Rename an existing session
### Window Management
- `tmux_list_windows` - List windows in a session
- `tmux_create_window` - Create a new window
- `tmux_kill_window` - Kill a window
- `tmux_select_window` - Switch to a window
- `tmux_rename_window` - Rename a window
### Pane Management
- `tmux_list_panes` - List panes in a window
- `tmux_split_window` - Split window into panes
- `tmux_kill_pane` - Kill a pane
- `tmux_select_pane` - Switch to a pane
- `tmux_resize_pane` - Resize a pane
### Interaction
- `tmux_send_keys` - Send keys/commands to a pane
- `tmux_capture_pane` - Capture pane content/output
## License
WTFPL