libtmux-mcp server

Terminal control for AI agents, built on libtmux and FastMCP.

यह सर्वर tmux की ऑब्जेक्ट पदानुक्रम — सत्र, विंडो, पैन — को MCP टूल्स में मैप करता है, जो उनके द्वारा अनुरोधित ऑपरेशन के आधार पर समूहीकृत होते हैं। सर्वर चयनित समूहों को MCP टूल सीमा पर लागू करता है।

[!warning] चेतावनी प्री-अल्फा। API बदल सकते हैं। प्रतिक्रिया का स्वागत है।

uvx इंस्टॉल होने पर:

$ claude mcp add tmux -- uvx libtmux-mcp

---

त्वरित प्रारंभ

त्वरित प्रारंभ

टूल्स

टूल्स

प्रॉम्प्ट्स

प्रॉम्प्ट्स

संसाधन

संसाधन

विश्वास मॉडल

विश्वास मॉडल

क्लाइंट सेटअप

MCP क्लाइंट्स

---

आप क्या कर सकते हैं

निरीक्षण करें

tmux स्थिति और टर्मिनल आउटपुट का अनुरोध करें।

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

प्रबंधित करें

tmux संरचना या प्रस्तुति बदलें।

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

निष्पादित करें

पैन प्रक्रियाएँ शुरू या चलाएँ, या ऐसी स्थिति संग्रहीत करें जो बाद के निष्पादन को नियंत्रित कर सके।

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

टियरडाउन

tmux ऑब्जेक्ट या संग्रहीत स्क्रॉलबैक हटाएँ। प्रतिवर्ती नहीं।

clear_pane · kill_session · kill_window · kill_pane · kill_server · delete_buffer

उदाहरण: परीक्षण रन को स्थायी इतिहास से बाहर रखें

libtmux-mcp Bash, Zsh, और Fish के लिए सर्वोत्तम-प्रयास इतिहास दमन प्रदान करता है। run_command के लिए MCP कॉल डिफ़ॉल्ट रूप से हल्के कमांड दमन का उपयोग करते हैं। जब आप एक नया शेल बनाते हैं, तो suppress_persistent_history=true के साथ मजबूत नो-डिस्क नियंत्रण चुनें।

[!note] प्रॉम्प्ट "checks" नामक एक tmux सत्र बनाएँ जिसमें सर्वोत्तम-प्रयास नो-डिस्क शेल-इतिहास नियंत्रण हों, उसके प्रारंभिक पैन में pytest -q चलाएँ, और मुझे परिणाम दिखाएँ।

एजेंट create_session को suppress_persistent_history=true के साथ कॉल करता है, लौटाए गए SessionInfo से active_pane_id का पुन: उपयोग करता है, और run_command को बिना ओवरराइड के कॉल करता है। create_window, split_window, या respawn_pane पर समान स्पॉन विकल्प केवल उस प्रक्रिया पर लागू होता है जिसे वह कॉल शुरू करता है।

ये नियंत्रण इतिहास शोर को कम करते हैं; वे कमांड को गुप्त नहीं बनाते। शेल-विशिष्ट व्यवहार के लिए इतिहास दमन, सर्वर डिफ़ॉल्ट के लिए कॉन्फ़िगरेशन, और अन्य अवलोकन सतहों के लिए विश्वास मॉडल देखें।

सभी टूल ब्राउज़ करें →

---

मानसिक मॉडल

• ऑब्जेक्ट पदानुक्रम — सत्रों में विंडो होती हैं, विंडो में पैन होते हैं (अवधारणाएँ)
• टूलसेट — निरीक्षण, प्रबंधन, निष्पादन, टियरडाउन; प्रत्येक क्या समूहित करता है (विश्वास मॉडल)
• tmux सत्य का स्रोत है — सर्वर उससे पढ़ता है और उसमें लिखता है, कभी कैश या सार नहीं करता

---