Topics¶
Explore libtmux-mcp’s core ideas and design at a high level.
Source layout, request flow, and extension points.
tmux hierarchy, MCP protocol, and the mental model.
Three-tier safety system for controlling tool access.
Best-effort Bash, Zsh, and Fish history controls and their limits.
Symptom-based guide for common issues.
Which wait to reach for, why they are bounded, and what was rejected.
Things that will bite you if you don’t know about them.
Write effective instructions for AI agents using tmux tools.
MCP protocol utilities¶
How libtmux-mcp maps to three optional utility capabilities from the Model Context Protocol specification.
Argument auto-complete — what FastMCP derives automatically and what libtmux-mcp does not yet wire up.
Server-to-client log forwarding and the libtmux_mcp.* logger
hierarchy.
Protocol cursors, search_panes paging, and
capture_since
observation cursors.