cmux-mcp v1.0.0

MCP server that gives AI agents full control of your cmux terminal.

Highlights

CLI-based architecture — Uses cmux send, cmux read-screen, cmux send-key via Unix socket. No AppleScript.
Background operation — Works when cmux is unfocused. No focus stealing.
Smart completion detection — Monitors TTY CPU activity to know when commands finish.
Token efficient — Read only the lines you need, not the entire scrollback.

Tool	Description
`write_to_terminal`	Send commands to cmux terminal
`read_terminal_output`	Read last N lines of terminal output
`send_control_character`	Send Ctrl+C, Ctrl+Z, Escape, etc.

git clone https://github.com/daegweon/cmux-mcp.git
cd cmux-mcp && npm install && npm run build

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "cmux-mcp": {
      "command": "node",
      "args": ["/path/to/cmux-mcp/build/index.js"]
    }
  }
}