libtmux-mcp server

offiziell

Von libtmux betriebener tmux MCP-Server

Auf git-pull.com ansehen

Was kann man mit Libtmux MCP machen?

  • Tmux-Status prüfen — Sitzungs-, Fenster- und Bereichsdetails mit list_sessions, capture_pane, get_pane_info oder search_panes auslesen.
  • Eingabe an Bereiche senden — Befehle oder Text in einen Zielbereich eingeben mit send_keys, send_keys_batch, run_command oder paste_text.
  • Sitzungen erstellen und anordnen — Benannte Sitzungen, Fenster und geteilte Bereiche über create_session, create_window und split_window starten.
  • Tmux-Objekte zerstören — Sitzungen, Fenster, Bereiche oder den gesamten Server mit kill_session, kill_window, kill_pane oder kill_server beenden.
  • Shell-Verlauf unterdrücken — Bereiche mit suppress_persistent_history starten, um Testläufe und einmalige Befehle aus dem persistenten Shell-Verlauf herauszuhalten.

Dokumentation

libtmux-mcp¶

Terminalsteuerung für KI-Agenten, aufgebaut auf libtmux und FastMCP.

Dieser Server bildet die Objekthierarchie von tmux — Sessions, Fenster, Panes — auf MCP-Tools ab. Einige Tools lesen den Zustand. Einige verändern ihn. Einige zerstören. Die Unterscheidung ist explizit und wird erzwungen.

Warnung

Pre-alpha. APIs können sich ändern. Feedback ist willkommen.

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

uvx pipx pip install

Cooldowns konfigurieren ?

Lokal Benutzer Projekt

Benutzer Projekt

Benutzer Projekt

Projekt Global

Benutzer Projekt

Mit installiertem uvx:

$ claude mcp add tmux -- uvx libtmux-mcp

Zurück

Abhängigkeits-Cooldowns

Verwenden Sie das Kontrollkästchen Cooldowns konfigurieren oben, um sie zu aktivieren oder zu deaktivieren. Diese Einstellungen legen fest, wie sich Cooldowns verhalten, sobald sie aktiviert sind.

Was sind Cooldowns?

Cooldowns verzögern die Übernahme neu hochgeladener Pakete, damit die Community Zeit hat, Supply-Chain-Angriffe zu erkennen, bevor Sie installieren. Die meisten Paketmanager wenden standardmäßig keinen Cooldown an — Sie aktivieren ihn über eine globale Einstellung in der Konfiguration Ihres Tools.

Weitere Informationen unter cooldowns.dev · Datadog Security Labs Artikel.

Schnellstart

Installieren, verbinden, ein erstes Ergebnis erhalten. In unter 2 Minuten.

Schnellstart

Tools

Jedes Tool, gruppiert nach Absicht und Sicherheitsstufe.

Tools

Prompts

Vier Workflow-Rezepte, die der Client für das Modell darstellt.

Prompts

Ressourcen

Snapshot-Ansichten der tmux-Hierarchie über tmux:// URIs.

Ressourcen

Sicherheitsstufen

Readonly, verändernd, destruktiv. Wissen, was den Zustand ändert.

Sicherheitsstufen

Client-Einrichtung

Konfigurationsblöcke für Claude Desktop, Claude Code, Cursor und andere.

MCP-Clients

Was Sie tun können¶

Schreibgeschützt inspizieren¶

Den tmux-Zustand lesen, ohne etwas zu ändern.

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

Verändernd handeln¶

tmux-Objekte erstellen oder ändern.

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

Destruktiv zerstören¶

tmux-Objekte abreißen. Nicht umkehrbar.

kill_session · kill_window · kill_pane · kill_server · call_destructive_tools_batch

Beispiel: Testläufe aus dem persistenten Verlauf fernhalten¶

libtmux-mcp bietet eine bestmögliche Verlaufsunterdrückung für Bash, Zsh und Fish. MCP-Aufrufe an run_command verwenden standardmäßig eine leichtgewichtige Befehlsunterdrückung. Wenn Sie eine neue Shell erstellen, können Sie mitsuppress_persistent_history=true stärkere No-Disk-Kontrollen aktivieren.

Prompt

Erstellen Sie eine tmux-Session namens „checks“ mit bestmöglichen No-Disk-Shell-Verlaufskontrollen, führen Sie pytest -q in ihrem ersten Pane aus und zeigen Sie mir das Ergebnis.

Der Agent ruft create_session mitsuppress_persistent_history=true auf, verwendet active_pane_id aus dem zurückgegebenenSessionInfo wieder und ruftrun_command ohne Überschreibung auf. Dieselbe Spawn-Option aufcreate_window, split_window oderrespawn_pane gilt nur für den Prozess, den dieser Aufruf startet.

Diese Kontrollen reduzieren Verlaufsrauschen; sie machen Befehle nicht geheim. SieheVerlaufsunterdrückung für shell-spezifisches Verhalten,Konfiguration für den Server-Standard und Sicherheitsstufen für andere Beobachtungsoberflächen.

Alle Tools durchsuchen →

Mentales Modell¶

  • Objekthierarchie — Sessions enthalten Fenster, Fenster enthalten Panes (Konzepte)
  • Lesen vs. Verändern — einige Tools beobachten, einige handeln, einige zerstören (Sicherheitsstufen)
  • tmux ist die Quelle der Wahrheit — der Server liest daraus und schreibt hinein, speichert niemals zwischen oder abstrahiert