libtmux-mcp server

официальный

MCP-сервер tmux на базе libtmux

Смотреть на git-pull.com

Что можно делать с Libtmux MCP?

  • Inspect tmux state — Чтение деталей сессий, окон и панелей с помощью list_sessions, capture_pane, get_pane_info или search_panes.
  • Send input to panes — Ввод команд или текста в целевую панель с использованием send_keys, send_keys_batch, run_command или paste_text.
  • Create and arrange sessions — Создание именованных сессий, окон и разделённых панелей через create_session, create_window и split_window.
  • Destroy tmux objects — Удаление сессий, окон, панелей или всего сервера с помощью kill_session, kill_window, kill_pane или kill_server.
  • Suppress shell history — Запуск панелей с suppress_persistent_history, чтобы тестовые прогоны и разовые команды не попадали в постоянную историю оболочки.

Документация

libtmux-mcp¶

Управление терминалом для AI-агентов, построенное на libtmux и FastMCP.

Этот сервер отображает объектную иерархию tmux — сессии, окна, панели — в инструменты MCP. Одни инструменты читают состояние. Другие изменяют его. Третьи разрушают. Различие явное и строго соблюдается.

Предупреждение

Пре-альфа. API могут меняться. Приветствуются отзывы.

Claude Code Claude Desktop Codex CLI Gemini CLI Cursor Grok CLI Antigravity

uvx pipx pip install

Настроить периоды ожидания ?

Локальный Пользователь Проект

Пользователь Проект

Пользователь Проект

Проект Глобальный

Пользователь Проект

С установленным uvx:

$ claude mcp add tmux -- uvx libtmux-mcp

Назад

Периоды ожидания зависимостей

Используйте флажок Настроить периоды ожидания выше, чтобы включить или отключить. Эти настройки определяют поведение периода ожидания после его включения.

Что такое периоды ожидания?

Периоды ожидания задерживают установку недавно загруженных пакетов, чтобы у сообщества было время обнаружить атаки на цепочку поставок до того, как вы установите пакет. Большинство менеджеров пакетов не применяют их по умолчанию — вы включаете их через глобальную настройку в конфигурации вашего инструмента.

Узнайте больше на cooldowns.dev · Datadog Security Labs writeup.

Быстрый старт

Установите, подключитесь, получите первый результат. Меньше чем за 2 минуты.

Быстрый старт

Инструменты

Каждый инструмент, сгруппированный по назначению и уровню безопасности.

Инструменты

Подсказки

Четыре рецепта рабочих процессов, которые клиент отображает для модели.

Подсказки

Ресурсы

Снимки иерархии tmux через URI tmux://.

Ресурсы

Уровни безопасности

Только чтение, изменение, разрушение. Знайте, что изменяет состояние.

Уровни безопасности

Настройка клиента

Блоки конфигурации для Claude Desktop, Claude Code, Cursor и других.

MCP Клиенты

Что вы можете делать¶

Инспектировать только чтение¶

Читать состояние tmux, ничего не изменяя.

list_sessions · capture_pane · capture_since · snapshot_pane · get_pane_info · find_pane_by_position · search_panes · wait_for_text · wait_for_content_change · display_message · call_readonly_tools_batch

Действовать с изменением¶

Создавать или изменять объекты tmux.

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

Разрушать деструктивно¶

Уничтожать объекты tmux. Необратимо.

kill_session · kill_window · kill_pane · kill_server · call_destructive_tools_batch

Пример: исключение тестовых запусков из постоянной истории¶

libtmux-mcp предоставляет максимально возможное подавление истории для Bash, Zsh и Fish. Вызовы MCP к run_command по умолчанию используют легковесное подавление команд. При создании новой оболочки включите более строгие элементы управления без записи на диск с помощью suppress_persistent_history=true.

Подсказка

Создайте сессию tmux с именем «checks» с максимально возможными элементами управления историей оболочки без записи на диск, запустите pytest -q в её начальной панели и покажите мне результат.

Агент вызывает create_session с suppress_persistent_history=true, повторно использует active_pane_id из возвращённого SessionInfo и вызывает run_command без переопределения. Та же опция запуска на create_window, split_window или respawn_pane применяется только к процессу, который запускает этот вызов.

Эти элементы управления уменьшают шум в истории; они не делают команды секретными. См. Подавление истории для поведения, специфичного для оболочки, Конфигурация для настроек сервера по умолчанию и Уровни безопасности для других поверхностей наблюдения.

Просмотреть все инструменты →

Ментальная модель¶

  • Объектная иерархия — сессии содержат окна, окна содержат панели (Концепции)
  • Чтение против изменения — одни инструменты наблюдают, другие действуют, третьи разрушают (Уровни безопасности)
  • tmux — источник истины — сервер читает из него и пишет в него, никогда не кэширует и не абстрагирует