# @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