Ruby MCP guides

Edit this page on GitHub

libtmux-mcp 0.1.0.alpha.1 · Source

Select the tmux serverLink to section

Start tmux on an application-owned named socket, then configure the MCP server with the same name. --socket-name selects tmux; --endpoint only assigns the public alias used in discovery and resource URIs.

$ tmux -L libtmux-docs new-session -d -s agent

$ libtmux-mcp \
    --socket-name libtmux-docs \
    --endpoint local

Use --socket PATH instead when the application owns an explicit socket path. The process serves MCP on standard input and output. End of input closes retained protocol clients without stopping the borrowed tmux daemon.

Enable observationLink to section

Screen capture and waits are absent from the default catalog. Add each one explicitly:

$ libtmux-mcp \
    --socket-name libtmux-docs \
    --enable-tool tmux_capture \
    --enable-tool tmux_wait

tmux_wait can observe screen text or a process exit. Strong process tracking requires tmux 3.3 or newer and a supported native identity backend. A refusal means the required evidence is unavailable; it is not a successful wait.

Enable mutationsLink to section

Repeat --enable-tool for tmux_create, tmux_send, or tmux_close. Creation accepts command argument arrays. Sending text and sending named keys are separate variants. A dispatch receipt does not claim that the pane program completed.

Source-owned MCP guide