# Ryan's Tmux MCP Server

MCP server for tmux operations that provides comprehensive control over tmux sessions, windows, and panes.

## Installation

1. Install the package:
```bash
cd /home/ryan/devel/ryan-tmux
pip install -e .
```

2. Add to your Claude desktop app's `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "ryan-tmux": {
      "command": "ryan-tmux-mcp"
    }
  }
}
```

**Note:** If you installed in a virtual environment, use the full path to the executable:
```json
{
  "mcpServers": {
    "ryan-tmux": {
      "command": "/path/to/your/project/venv/bin/ryan-tmux-mcp"
    }
  }
}
```

## Available Commands

- `list-sessions` - List all tmux sessions
- `find-session` - Find sessions by pattern
- `list-panes` - List panes (optionally filtered by session)
- `capture-panes` - Capture content from multiple panes
- `arrange-panes` - Arrange panes with layouts
- `list-windows` - List windows in a session
- `capture-pane` - Capture specific pane content
- `create-session` - Create new sessions
- `execute-command` - Send commands to panes
- `set-prompt` - Set custom prompts
- `get-command-result` - Execute and capture command results
- `decorate-pane` - Add titles to panes

## Usage Examples

After installation, you can use these commands in Claude:

- "List all my tmux sessions"
- "Capture the content from pane kam:0.0" 
- "Create a new session called 'work'"
- "Send 'ls -la' to pane kam:0.0"
- "Arrange the panes in session 'kam' with tiled layout"