libtmux-mcp server

resmi

Server MCP tmux yang didukung oleh libtmux

Lihat di git-pull.comCoba MCP iniDisponsori

Apa yang bisa Anda lakukan dengan Libtmux MCP?

  • Periksa status tmux — Minta snapshot hanya-baca dari sesi, jendela, atau panel melalui list_sessions, capture_pane, atau get_pane_info.
  • Jalankan perintah di panel — Minta asisten untuk mengeksekusi perintah shell atau mengirimkan penekanan tombol dengan run_command atau send_keys, termasuk operasi batch.
  • Kelola objek tmux — Buat, pisahkan, ubah ukuran, atau pilih jendela dan panel menggunakan alat seperti create_window, split_window, atau select_pane.
  • Hancurkan sumber daya tmux — Hentikan sesi, jendela, panel, atau seluruh server dengan alat destruktif seperti kill_session atau kill_server.
  • Sembunyikan riwayat shell — Mulai sesi atau jendela dengan suppress_persistent_history=true untuk menjaga uji coba tidak masuk ke riwayat shell persisten.

Dokumentasi

libtmux-mcp

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

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

Peringatan

Pra-alpha. API dapat berubah. Masukan dipersilakan.

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

uvx pipx pip install

Konfigurasikan pembatasan (cooldown)?

Lokal Pengguna Proyek

Pengguna Proyek

Pengguna Proyek

Proyek Global

Pengguna Proyek

Dengan uvx terinstal:

$ claude mcp add tmux -- uvx libtmux-mcp

Kembali

Pembatasan ketergantungan

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

Apa itu pembatasan?

Pembatasan menunda pengambilan paket yang baru diunggah sehingga komunitas memiliki waktu untuk melihat 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.

Memulai Cepat

Instal, sambungkan, dapatkan hasil pertama. Kurang dari 2 menit.

Memulai Cepat

Alat

Setiap alat, dikelompokkan berdasarkan tujuan dan tingkat keamanan.

Alat

Prompts

Empat resep alur kerja yang dirender klien untuk model.

Prompts

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 lain-lain.

Klien MCP

Apa 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 · display_message · call_readonly_tools_batch

Tindakan (mengubah)

Buat atau ubah 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)

Bongkar objek tmux. Tidak dapat dibalik.

kill_session · kill_window · kill_pane · kill_server · call_destructive_tools_batch

Contoh: menjaga uji coba berjalan keluar dari 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 dengan suppress_persistent_history=true.

Prompt

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

Agen memanggil create_session dengan suppress_persistent_history=true, menggunakan kembali active_pane_id dari SessionInfo yang dikembalikan, dan memanggil run_command tanpa menimpa. Opsi spawn yang sama pada create_window, split_window, atau respawn_pane hanya berlaku untuk proses yang dimulai oleh panggilan tersebut.

Kontrol ini mengurangi kebisingan riwayat; mereka tidak membuat perintah menjadi rahasia. Lihat Penekanan 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 ke dalamnya, tidak pernah menyimpan cache atau mengabstraksi