libtmux-mcp server

libtmux-mcp¶

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

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

चेतावनी

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

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

uvx pipx pip install

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

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

उपयोगकर्ता प्रोजेक्ट

उपयोगकर्ता प्रोजेक्ट

प्रोजेक्ट ग्लोबल

उपयोगकर्ता प्रोजेक्ट

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

$ claude mcp add tmux -- uvx libtmux-mcp

पीछे

डिपेंडेंसी कूलडाउन

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

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

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

cooldowns.dev पर और जानें · Datadog Security Labs रिपोर्ट।

---

त्वरित आरंभ

इंस्टॉल करें, कनेक्ट करें, पहला परिणाम पाएँ। 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 · 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 के साथ मजबूत नो-डिस्क नियंत्रणों का विकल्प चुनें।

प्रॉम्प्ट

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

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

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

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

---

मानसिक मॉडल

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

---