libtmux-mcp server
About
tmux MCP server powered by libtmux
Details
- Author
- Unknown
- Categories
- Developer Tools, Infrastructure, Other
Jump to
- Inspect tmux state read-only— Ask tolist_sessions,capture_pane, orsearch_panesto view sessions, windows, and panes without modifying anything.
- Drive terminal interactions— Usesend_keys,run_command, orpaste_textto type commands, execute programs, and paste content into panes.
- Manage tmux layout— Create or split windows withcreate_windowandsplit_window, then navigate viaselect_paneorselect_window.
- Tear down tmux objects— Kill sessions, windows, panes, or the entire server withkill_session,kill_window,kill_pane, orkill_server.
- Batch related operations— Combine multiple read-only or mutating calls in one request viacall_readonly_tools_batchorcall_mutating_tools_batch.
- Suppress shell history— Create sessions or windows withsuppress_persistent_history=trueto keep test commands out of persistent shell history.
Terminal control for AI agents, built onlibtmuxandFastMCP.
This server maps tmux’s object hierarchy — sessions, windows, panes — into MCP tools. Some tools read state. Some mutate it. Some destroy. The distinction is explicit and enforced.
[!warning] WarningPre-alpha.APIs may change.Feedback welcome.
$ claude mcp add tmux -- uvx libtmux-mcp
Read tmux state without changing anything.
list_sessions·capture_pane·capture_since·snapshot_pane·get_pane_info·find_pane_by_position·search_panes·wait_for_text·display_message·call_readonly_tools_batch
create_session·send_keys·send_keys_batch·run_command·paste_text·create_window·split_window·select_pane·select_window·move_window·resize_pane·pipe_pane·set_option·call_mutating_tools_batch
kill_session·kill_window·kill_pane·kill_server·call_destructive_tools_batch
Example: keep test runs out of persistent history
libtmux-mcp provides best-effort history suppression for Bash, Zsh, and Fish. MCP calls torun_commanduse lightweight command suppression by default. When you create a new shell, opt into stronger no-disk controls withsuppress_persistent_history=true.
[!note] Prompt Create a tmux session called “checks” with best-effort no-disk shell-history controls, runpytest -qin its initial pane, and show me the result.
The agent callscreate_sessionwithsuppress_persistent_history=true, reusesactive_pane_idfrom the returnedSessionInfo, and callsrun_commandwithout an override. The same spawn option oncreate_window,split_window, orrespawn_paneapplies only to the process that call starts.
These controls reduce history noise; they do not make commands secret. SeeHistory suppressionfor shell-specific behavior,Configurationfor the server default, andSafety tiersfor other observation surfaces.
- Object hierarchy— sessions contain windows, windows contain panes (Concepts)
- Read vs. mutate— some tools observe, some act, some destroy (Safety tiers)
- tmux is the source of truth— the server reads from it and writes to it, never caches or abstracts
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Execute shell commands without permission prompts.
Execute bash commands on the host machine.
Execute shell commands with structured output via a powerful CLI server.
A secure MCP server for executing controlled command-line operations with comprehensive security features.
MCP server for controlling cmux (Ghostty-based terminal) via native CLI. Send commands, read output, send control characters — all in background via Unix socket.
Execute pre-approved shell commands securely on a server.
A secure MCP server for executing terminal commands with controlled directory access and command permissions.
A shell command / terminal executor with async support
A high-performance MCP server for the headless terminal (ht), implemented in Rust.
Execute terminal commands through a secure shell interface using an AI assistant.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
