tmux-mcp-server

# Tmux MCP Server An MCP server that lets AI agents interact with terminal sessions through tmux. ## Running the Server ```bash go run ./cmd/tmux-mcp-server ``` The server communicates via stdio and provides tools for managing tmux sessions. ## Usage The server provides these tools: - `start_session` - Create a new tmux session - `send_commands` - Send commands and keystrokes to a session - `view_session` - Capture the current screen content - `list_sessions` - Show all active sessions - `join_session` - Join an existing session - `close_session` - End a session ### Example: Editing a file with vim ```json { "name": "start_session", "arguments": { "session_name": "edit_work", "command": "vim README.md" } } ``` ```json { "name": "send_commands", "arguments": { "session_name": "edit_work", "commands": [ "i", "Hello world!", "<ESC>", ":wq", "<ENTER>" ] } } ``` The `send_commands` tool takes an array where plain strings are typed literally and `<COMMAND>` format handles special keys like `<ENTER>`, `<ESC>`, `<TAB>`, etc. ## Development This project uses [Hermit](https://cashapp.github.io/hermit/) for managing development dependencies. Hermit ensures consistent development environments across different machines. ``` . bin/activate-hermit ``` ## Requirements - Go 1.24.2+ - tmux