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 untuk mencantumkan sesi, menangkap output panel, atau mencari panel untuk teks tertentu.
  • Kelola struktur tmux — Ganti nama sesi, ubah ukuran panel, pilih tata letak, atau pindahkan jendela antar sesi.
  • Jalankan perintah di panel — Buat sesi/jendela, pisahkan panel, kirim penekanan tombol, atau jalankan perintah shell.
  • Kontrol proses panel — Tempel teks atau buffer, salurkan output panel, atau atur variabel lingkungan dan opsi.
  • Hancurkan objek tmux — Bersihkan scrollback panel, matikan sesi/jendela/panel, atau hapus buffer.
  • Sembunyikan riwayat shell — Buat sesi atau jendela dengan kontrol riwayat tanpa disk untuk pengujian yang lebih bersih.

Dokumentasi

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

Server ini memetakan hierarki objek tmux — sesi, jendela, panel — ke dalam alat MCP yang dikelompokkan berdasarkan operasi yang diminta. Server memberlakukan grup yang dipilih pada batas alat MCP.

[!warning] Peringatan Pra-alpha. API dapat berubah. Masukan diterima.

Dengan uvx terinstal:

$ claude mcp add tmux -- uvx libtmux-mcp

Mulai cepat

Mulai cepat

Alat

Alat

Prompt

Prompt

Sumber daya

Sumber daya

Model kepercayaan

Model kepercayaan

Pengaturan klien

Klien MCP

Yang dapat Anda lakukan

Periksa periksa

Minta status tmux dan keluaran terminal.

list_sessions · capture_pane · capture_since · snapshot_pane · get_pane_info · find_pane_by_position · search_panes · wait_for_text · display_message · call_read_tools_batch

Kelola kelola

Ubah struktur atau presentasi tmux.

rename_session · resize_pane · select_layout · select_pane · move_window · enter_copy_mode · load_buffer · wait_for_channel

Jalankan jalankan

Mulai atau kendalikan proses panel, atau simpan status yang dapat mengontrol eksekusi selanjutnya.

create_session · create_window · split_window · respawn_pane · send_keys · send_keys_batch · run_command · paste_text · paste_buffer · pipe_pane · set_option · set_environment

Hapus hapus

Hapus objek tmux atau scrollback yang disimpan. Tidak dapat dibatalkan.

clear_pane · kill_session · kill_window · kill_pane · kill_server · delete_buffer

Contoh: jaga hasil uji 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.

[!note] Prompt Buat sesi tmux bernama "checks" dengan kontrol riwayat shell tanpa-disk upaya terbaik, jalankan pytest -q di panel awalnya, dan tunjukkan 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 penimpaan. 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; kontrol ini tidak membuat perintah menjadi rahasia. Lihat Penekanan riwayat untuk perilaku khusus shell, Konfigurasi untuk default server, dan Model kepercayaan untuk permukaan observasi lainnya.

Jelajahi semua alat →

Model mental

  • Hierarki objek — sesi berisi jendela, jendela berisi panel (Konsep)
  • Perangkat alat — periksa, kelola, jalankan, hapus; apa yang dikelompokkan masing-masing (Model kepercayaan)
  • tmux adalah sumber kebenaran — server membaca darinya dan menulis ke dalamnya, tidak pernah menyimpan cache atau mengabstraksi