libtmux-mcp server

libtmux-mcp¶

AI एजेंटों के लिए टर्मिनल नियंत्रण, libtmux और FastMCP पर निर्मित।

यह सर्वर tmux के ऑब्जेक्ट पदानुक्रम — सत्र, विंडो, पेन — को MCP उपकरणों में मैप करता है। कुछ उपकरण स्थिति पढ़ते हैं। कुछ इसे बदलते हैं। कुछ नष्ट करते हैं। यह अंतर स्पष्ट और लागू है।

चेतावनी

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

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

uvx pipx pip install

कूलडाउन कॉन्फ़िगर करें ?

स्थानीय उपयोगकर्ता परियोजना

उपयोगकर्ता परियोजना

उपयोगकर्ता परियोजना

परियोजना वैश्विक

उपयोगकर्ता परियोजना

uvx स्थापित होने पर:

$ claude mcp add tmux -- uvx libtmux-mcp

वापस

निर्भरता कूलडाउन

कूलडाउन सक्षम या अक्षम करने के लिए ऊपर कूलडाउन कॉन्फ़िगर करें चेकबॉक्स का उपयोग करें। ये सेटिंग्स चुनती हैं कि सक्षम होने पर कूलडाउन कैसे व्यवहार करता है।

कूलडाउन क्या हैं?

कूलडाउन नए अपलोड किए गए पैकेजों को लेने में देरी करते हैं ताकि समुदाय को आपके इंस्टॉल करने से पहले आपूर्ति-श्रृंखला हमलों को पहचानने का समय मिल सके। अधिकांश पैकेज प्रबंधक डिफ़ॉल्ट रूप से एक लागू नहीं करते हैं — आप अपने उपकरण के कॉन्फ़िग में एक वैश्विक सेटिंग के माध्यम से ऑप्ट इन करते हैं।

अधिक जानें cooldowns.dev · Datadog Security Labs writeup पर।

---

त्वरित शुरुआत

इंस्टॉल करें, कनेक्ट करें, पहला परिणाम प्राप्त करें। 2 मिनट से कम में।

त्वरित शुरुआत

उपकरण

प्रत्येक उपकरण, इरादे और सुरक्षा स्तर के अनुसार समूहीकृत।

उपकरण

प्रॉम्प्ट

चार वर्कफ़्लो रेसिपी जो क्लाइंट मॉडल के लिए प्रस्तुत करता है।

प्रॉम्प्ट

संसाधन

tmux:// URI के माध्यम से tmux पदानुक्रम के स्नैपशॉट दृश्य।

संसाधन

सुरक्षा स्तर

केवल-पढ़ने, बदलने वाले, विनाशकारी। जानें कि क्या स्थिति बदलता है।

सुरक्षा स्तर

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

Claude Desktop, Claude Code, Cursor, और अन्य के लिए कॉन्फ़िग ब्लॉक।

MCP क्लाइंट

---

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

केवल-पढ़ने का निरीक्षण करें¶

बिना कुछ बदले tmux स्थिति पढ़ें।

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

बदलने की क्रिया करें¶

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

विनाशकारी रूप से नष्ट करें¶

tmux ऑब्जेक्ट को ध्वस्त करें। वापस नहीं लाया जा सकता।

kill_session · kill_window · kill_pane · kill_server · call_destructive_tools_batch

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

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

प्रॉम्प्ट

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

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

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

सभी उपकरण ब्राउज़ करें →

---

मानसिक मॉडल¶

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

---