MCP server libtmux
Коммит 12 нояб. 2026 г.Позволяет ИИ-агентам управлять сессиями, окнами и панелями tmux, выполняя команды, считывая вывод терминала и оркестрируя среду терминала.
Также известен как tmux-python/libtmux-mcp
- Звёзды
- 14
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 12 нояб. 2026 г.
- Лицензия
- MIT
Что такое libtmux MCP?
Позволяет ИИ-агентам управлять сессиями, окнами и панелями tmux, выполняя команды, считывая вывод терминала и оркестрируя среду терминала.
Сводка сгенерирована из README проекта
О libtmux MCP server
libtmux-mcp позволяет управлять средами терминала и длительными процессами прямо из ИИ-агента. Этот MCP server служит мостом между клиентами Model Context Protocol и tmux, позволяя агентам создавать сессии, управлять окнами и контролировать отдельные панели. Он разработан для разработчиков, использующих такие инструменты, как Claude Desktop, Claude Code, Codex CLI или Gemini CLI, чтобы предоставить их ИИ-ассистентам возможность прямого взаимодействия с терминалом.
Пользователи могут развернуть сервер локально с помощью uvx или добавить его в конфигурацию своего клиента. Сервер включает специализированные инструменты для сложной оркестрации терминала, такие как run_command для выполнения shell-команд с получением кода завершения, wait_for_text для мониторинга вывода без постоянного опроса и capture_since для чтения только новых строк терминала. Он также предлагает управление панелями через такие инструменты, как split_window, resize_pane и send_keys_batch для взаимодействия с текстовыми пользовательскими интерфейсами.
Данная реализация ориентирована на эффективность и безопасность. Она использует подавление истории, чтобы команды агента не сохранялись в истории shell, и включает защитные механизмы, предотвращающие случайное завершение агентом своей собственной хост-сессии. Разработчики могут дополнительно настраивать возможности агента с помощью переменной окружения LIBTMUX_TOOLSETS, чтобы включать или исключать определенные группы инструментов, такие как inspect, manage, execute или teardown.
Что вы можете с ним делать
- 1Автоматизированное выполнение тестовПопросите агента создать новую сессию tmux и запустить определенный набор тестов, отслеживая результаты.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийtmux-python/libtmux-mcp is public and reachablegithub.com/tmux-python/libtmux-mcp ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-11-12github.com/tmux-python/libtmux-mcp ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHublibtmux-mcp
A Model Context Protocol server for tmux, built on libtmux.
[!WARNING] Alpha. Releases carry an
-alphaprerelease tag. The API is not settled, and any release may change or remove exported identifiers without a deprecation period. Pin an exact version. Not recommended for production.
Give your AI agent hands inside the terminal — create sessions, run commands, read output, orchestrate panes.
Tools
| Module | Tools |
|---|---|
| Server | list_servers, list_sessions, create_session, kill_server, get_server_info |
| Batch | call_read_tools_batch |
| Session | list_windows, get_session_info, create_window, rename_session, select_window, kill_session |
| Window | list_panes, get_window_info, split_window, rename_window, select_layout, resize_window, move_window, kill_window |
| Pane | run_command, send_keys, send_keys_batch, paste_text, capture_pane, capture_since, snapshot_pane, search_panes, find_pane_by_position, get_pane_info, wait_for_text, wait_for_channel, signal_channel, display_message, select_pane, swap_pane, resize_pane, set_pane_title, clear_pane, pipe_pane, enter_copy_mode, exit_copy_mode, respawn_pane, kill_pane |
| Options | show_option, set_option |
| Environment | show_environment, set_environment |
| Buffers | load_buffer, paste_buffer, show_buffer, delete_buffer |
| Hooks | show_hooks, show_hook |
Quickstart
Requirements: Python 3.11+, tmux >= 3.2a on $PATH.
The distribution is libtmux-mcp, the import is libtmux_mcp, and the
installed executable is libtmux-mcp.
Install and run:
$ uvx libtmux-mcp
Claude Code
$ claude mcp add tmux -- uvx libtmux-mcp
Codex CLI
$ codex mcp add tmux -- uvx libtmux-mcp
Gemini CLI
$ gemini mcp add tmux uvx -- libtmux-mcp
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"tmux": {
"command": "uvx",
"args": ["libtmux-mcp"]
}
}
}
More clients and JSON config: client setup docs
What it feels like
You: Create a session called "api" and run
pytest tests/api/ -xin it.Agent: Created session
apiwith windowtests. Running pytest now. Here's the output — 14 passed, 2 failed. The failures are intest_auth.py::test_token_refreshandtest_auth.py::test_expired_session. Want me to open those files?
The agent manages tmux directly. No copy-pasting terminal output. No switching windows to check on long-running processes.
When the server earns its keep
For a single tmux send-keys, the server doesn't. It earns its keep
the moment the agent has to wait, inspect, or avoid damaging the
terminal it is using — pytest finishing, a dev server printing its
port, a deploy log settling. The difference then is not more access
to tmux, but a better place to put the control loop.
The server-side moves are:
Running. run_command
sends an authored shell command, waits for deterministic completion,
and returns exit status plus tail-preserved output as one typed value.
The command and its completion signal reach the shell as one
space-prefixed event, so best-effort
history suppression
keeps agent-generated input out of shell history by default. The
alternative — hand-rolled send-keys plus wait-for plus a pane
capture — leaves every typed command, signal included, in shell
history.
Driving. send_keys_batch
sends several ordered raw-input operations for TUIs and persistent
shell interaction. It is deliberately not a workflow DSL; command
completion stays in run_command, and repeated observation stays in
capture_since.
Waiting. wait_for_text
blocks inside the server until a condition fires for output the agent
does not author. The alternative is the model polling capture-pane
in a loop, paying both context tokens and round-trip latency for every
turn.
Reading. snapshot_pane
returns content, cursor, copy-mode state, and scroll offset as one
typed value. The alternative is several tmux invocations stitched
together with regex.
Observing. capture_since
returns a cursor with the current pane content, then returns only
newly written or rewritten rows on follow-up calls. The alternative is
re-sending the same scrollback to the model on every check.
Guarding. The server detects the agent's own pane across sockets
and declines to end its own — kill_session
on itself fails loudly instead of silently terminating the host
environment the agent is running in. LIBTMUX_TOOLSETS
(inspect, manage, execute, teardown) drops whole toolsets from the
client's tool list before any prompt is built. The sets are unordered, so
inspect,teardown is a legal surface. Dropping one is inventory and MCP
tool-call configuration, not containment: an enabled execute tool can type
the equivalent of anything it hides.
Documentation
Full docs, guides, and tool reference: libtmux-mcp.git-pull.com
Development
Clone and install:
$ git clone https://github.com/tmux-python/libtmux-mcp.git
$ cd libtmux-mcp
$ uv sync --all-extras --dev
Run the server locally:
$ uv run libtmux-mcp
Run tests:
$ uv run pytest
See CONTRIBUTING.md for the gates, and WRITING.md for how this project writes prose, docstrings, and MCP tool descriptions.
Related projects
- libtmux — Python API for tmux
- tmuxp — tmux session manager
- The Tao of tmux — the book
Attribution
Please use the following BibTeX template to cite libtmux-mcp in scientific discourse:
@misc{libtmux-mcp,
author = {Tony Narlock},
year = {2026},
note = {https://libtmux-mcp.git-pull.com},
title = {libtmux-mcp: MCP server for tmux}
}
License
MIT
Вопросы о libtmux MCP
Готов ли этот сервер к использованию в продакшене?
Нет, сервер находится в стадии Alpha, что означает, что API еще не стабилизирован, а в релизах могут без уведомления меняться или удаляться идентификаторы.
Может ли агент выполнять команды, не засоряя историю shell?
Да, инструмент run_command по умолчанию использует подавление истории, чтобы команды, сгенерированные агентом, не попадали в историю shell.