Topics¶
Explore libtmux-mcp’s core ideas and design at a high level.
Architecture
Source layout, request flow, and extension points.
Concepts
tmux hierarchy, MCP protocol, and the mental model.
Safety Tiers
Three-tier safety system for controlling tool access.
Troubleshooting
Symptom-based guide for common issues.
Gotchas
Things that will bite you if you don’t know about them.
Agent Prompting
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.
Completion
Argument auto-complete — what FastMCP derives automatically and what libtmux-mcp does not yet wire up.
Logging
Server-to-client log forwarding and the libtmux_mcp.* logger
hierarchy.
Pagination
Protocol-level cursors vs tool-level offset / limit (as in
search_panes).