libtmux-mcp server

resmi

Server MCP tmux yang didukung oleh libtmux

Lihat di git-pull.com

Apa yang bisa Anda lakukan dengan Libtmux MCP?

  • Inspect status tmux — Baca detail sesi, jendela, dan panel dengan list_sessions, capture_pane, get_pane_info, atau search_panes.
  • Kirim input ke panel — Ketik perintah atau teks ke panel target menggunakan send_keys, send_keys_batch, run_command, atau paste_text.
  • Buat dan atur sesi — Buat sesi bernama, jendela, dan panel terpisah melalui create_session, create_window, dan split_window.
  • Hancurkan objek tmux — Hentikan sesi, jendela, panel, atau seluruh server dengan kill_session, kill_window, kill_pane, atau kill_server.
  • Sembunyikan riwayat shell — Luncurkan panel dengan suppress_persistent_history untuk menjaga hasil uji coba dan perintah satu kali agar tidak masuk ke riwayat shell permanen.

Dokumentasi

libtmux-mcp¶

Kontrol terminal untuk agen AI, dibangun di atas libtmux dan FastMCP.

Server ini memetakan hierarki objek tmux — sesi, jendela, panel — ke dalam alat MCP. Beberapa alat membaca status. Beberapa mengubahnya. Beberapa menghancurkan. Perbedaannya eksplisit dan ditegakkan.

Peringatan

Pra-alfa. API dapat berubah. Masukan sangat diharapkan.

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

uvx pipx pip install

Konfigurasikan cooldown ?

Lokal Pengguna Proyek

Pengguna Proyek

Pengguna Proyek

Proyek Global

Pengguna Proyek

Dengan uvx terinstal:

$ claude mcp add tmux -- uvx libtmux-mcp

Kembali

Cooldown dependensi

Gunakan kotak centang Konfigurasikan cooldown di atas untuk mengaktifkan atau menonaktifkan. Pengaturan ini memilih bagaimana cooldown berperilaku setelah diaktifkan.

Apa itu cooldown?

Cooldown menunda pengambilan paket yang baru diunggah sehingga komunitas memiliki waktu untuk mendeteksi serangan rantai pasokan sebelum Anda menginstal. Sebagian besar manajer paket tidak menerapkannya secara default — Anda ikut serta melalui pengaturan global di konfigurasi alat Anda.

Pelajari lebih lanjut di cooldowns.dev · Tulisan Datadog Security Labs.

Mulai Cepat

Instal, hubungkan, dapatkan hasil pertama. Di bawah 2 menit.

Mulai Cepat

Alat

Setiap alat, dikelompokkan berdasarkan maksud dan tingkat keamanan.

Alat

Prompt

Empat resep alur kerja yang dirender klien untuk model.

Prompt

Sumber Daya

Tampilan snapshot hierarki tmux melalui URI tmux://.

Sumber Daya

Tingkat Keamanan

Hanya-baca, mengubah, merusak. Ketahui apa yang mengubah status.

Tingkat Keamanan

Pengaturan Klien

Blok konfigurasi untuk Claude Desktop, Claude Code, Cursor, dan lainnya.

Klien MCP

Yang dapat Anda lakukan¶

Periksa hanya-baca¶

Baca status tmux tanpa mengubah apa pun.

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

Tindakan mengubah¶

Buat atau modifikasi objek 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

Hancurkan merusak¶

Hancurkan objek tmux. Tidak dapat dibalikkan.

kill_session · kill_window · kill_pane · kill_server · call_destructive_tools_batch

Contoh: jaga agar uji coba tidak masuk ke riwayat persisten¶

libtmux-mcp menyediakan penekanan riwayat upaya terbaik untuk Bash, Zsh, dan Fish. Panggilan MCP ke run_command menggunakan penekanan perintah ringan secara default. Saat Anda membuat shell baru, pilih kontrol tanpa-disk yang lebih kuat dengansuppress_persistent_history=true.

Prompt

Buat sesi tmux bernama "checks" dengan kontrol riwayat shell tanpa-disk upaya terbaik, jalankan pytest -q di panel awalnya, dan tunjukkan hasilnya.

Agen memanggil create_session dengansuppress_persistent_history=true, menggunakan kembali active_pane_id dariSessionInfo yang dikembalikan, dan memanggilrun_command tanpa penggantian. Opsi spawn yang sama padacreate_window, split_window, ataurespawn_pane hanya berlaku untuk proses yang dimulai oleh panggilan tersebut.

Kontrol ini mengurangi gangguan riwayat; mereka tidak membuat perintah menjadi rahasia. LihatPenekanan riwayat untuk perilaku spesifik shell,Konfigurasi untuk default server, dan Tingkat keamanan untuk permukaan observasi lainnya.

Jelajahi semua alat →

Model mental¶

  • Hierarki objek — sesi berisi jendela, jendela berisi panel (Konsep)
  • Baca vs. ubah — beberapa alat mengamati, beberapa bertindak, beberapa menghancurkan (Tingkat keamanan)
  • tmux adalah sumber kebenaran — server membaca darinya dan menulis kepadanya, tidak pernah menyimpan cache atau mengabstraksi