अपना एजेंट कनेक्ट करें

AWR आपका एजेंट नहीं चलाता। एजेंट क्लाइंट (Codex, Claude Code, Kimi, Cursor, Grok) अपने टूल के साथ काम करता है; AWR उसी इनिशियलाइज़ किए गए प्रोजेक्ट के लिए मौजूदा प्रोजेक्ट तथ्य, कार्य कॉन्टेक्स्ट, क्लेम और पुनर्प्राप्ति योग्य सत्र स्मृति उपलब्ध कराता है। AWR सत्र रिकॉर्ड में प्रोवाइडर और मॉडल लेबल केवल मेटाडेटा हैं — वे क्लाइंट को कभी लॉन्च या कॉन्फ़िगर नहीं करते।

हर समर्थित क्लाइंट एक ही पैटर्न का पालन करता है:

किसी AWR चेकआउट से दोनों एक्ज़िक्यूटेबल बनाएँ:

cargo build --locked -p awr-cli -p awr-mcp

लक्ष्य प्रोजेक्ट को उसके समीक्षा किए गए स्रोत मैनिफ़ेस्ट से इनिशियलाइज़ करें (देखें Quickstart), फिर क्लाइंट में awr-mcp सर्वर पंजीकृत करें, और --project को प्रोजेक्ट के निरपेक्ष पथ की ओर इशारा करें। प्रत्येक सर्वर एक कैनोनिकल प्रोजेक्ट रूट से बँधता है; अलग-अलग प्रोजेक्टों के सर्वरों को अलग नाम दें।
कनेक्शन सत्यापित करें — डिस्क पर कॉन्फ़िग फ़ाइल लाइव कनेक्शन नहीं है — और कोई भी काम शुरू करने से पहले स्थिति पढ़कर प्रोजेक्ट की पहचान की पुष्टि करें।
साझा सत्र लाइफ़साइकल चलाएँ: सत्र शुरू या फिर से शुरू करें, कॉन्टेक्स्ट पढ़ें, हैंडऑफ़ से पहले चेकपॉइंट करें, रुकने पर समाप्त करें। देखें CLI और MCP टूल।

नीचे के सेक्शन प्रत्येक क्लाइंट के मर्ज पथ, कॉन्फ़िगरेशन और चेतावनियाँ देते हैं। जहाँ कोई क्लाइंट स्वचालित लाइफ़साइकिल हुक दर्ज करता है, उन्हें तब तक असत्यापित मानें जब तक आपने वास्तविक ट्रिगर और रसीद न देख ली हो; मैन्युअल चेकपॉइंट/रिज़्यूम प्रवाह हमेशा काम करता है।

Codex

Codex केवल भरोसेमंद प्रोजेक्ट के लिए प्रोजेक्ट कॉन्फ़िगरेशन लोड करता है; एक ही होस्ट पर इसके CLI, डेस्कटॉप और IDE क्लाइंट MCP कॉन्फ़िगरेशन साझा करते हैं। दो विकल्पों में से एक चुनें: MCP कॉन्फ़िगरेशन टेम्पलेट को प्रोजेक्ट की .codex/config.toml में मर्ज करें (उसके दो पथ बदलते हुए, मौजूदा कॉन्फ़िगरेशन संरक्षित रखते हुए), या यूज़र स्तर पर पंजीकृत करें:

codex mcp add awr -- /absolute/path/to/awr-mcp \
  --project /absolute/path/to/initialized/project
codex mcp get awr --json

क्लाइंट के /mcp व्यू में कनेक्टेड awr सर्वर की पुष्टि करें और काम से पहले प्रोजेक्ट की पहचान सत्यापित करें; कॉन्फ़िगर किया गया सर्वर सक्रिय कनेक्शन का प्रमाण नहीं है। अपेक्षित रीड टूल: awr_project_status, awr_work_ready, awr_work_get, awr_context_compile, awr_search। म्यूटेशन टूल: awr_work_transition, awr_event_append, awr_evidence_record। सर्वर को मॉडल API कुंजी की आवश्यकता नहीं है।

Codex एकमात्र ऐसा क्लाइंट है जिसमें स्वचालित लाइफ़साइकिल हुक के लिए इंस्टॉलर है: --accept से पहले सटीक कॉन्फ़िगरेशन का प्रीव्यू देखने के लिए awr client install इस्तेमाल करें। इंस्टॉलेशन मौजूदा हुक संरक्षित रखती है और उनके भरोसे को कभी स्वतः स्वीकार नहीं करती। Codex SessionStart (startup|resume|clear|compact), PreCompact (manual|auto) और SessionEnd (सलाहकार, छोटा टाइमआउट) दर्ज करता है। क्लाइंट में वास्तविक ट्रिगर डिलीवरी सत्यापित करें — तब तक हैंडऑफ़ या कम्पैक्शन से पहले मैन्युअल रूप से चेकपॉइंट करें।

Claude Code

Claude Code एक नामित नियंत्रित एडाप्टर (एडाप्टर id claude_code) के माध्यम से जुड़ता है। यह ऑटो-स्टार्टेबल नहीं है: AWR आपके लिए Claude Code लॉन्च नहीं करेगा, और न ही उसे अपने आप रोकेगा — वे कदम आपके ही पास रहते हैं। एडाप्टर जो समर्थन करता है वह है स्थिति पढ़ना, रीकनेक्ट/रिज़्यूम, और परिणाम फ़ॉरेंसिक।

ऑपरेटर पथ:

Claude Code स्वयं शुरू करें।
जेनेरिक क्लाइंट और नेटिव वार्तालाप ID के साथ उसे AWR से बाँधें:

awrj client bind --client generic --external-session claude:<native-id> \
  --work "$AWR_WORK" --session "$AWR_SESSION"

जब आपको AWR अवलोकन चाहिए, तो साझा CLI की एक्सटर्नल एक्ज़िक्यूशन रिपोर्ट के माध्यम से फ़ेज़ रिपोर्ट करें।
पुनः प्रयास पर, कुछ भी नया शुरू करने से पहले उसी एक्ज़िक्यूशन पहचान को दोबारा कनेक्ट करें।

Kimi

यह गाइड Kimi Code 0.41.0 को लक्ष्य करती है (निरीक्षण 2026-09-08); पुराने kimi-cli रिलीज़ अलग कॉन्फ़िगरेशन पथ और फ़्लैग इस्तेमाल करते हैं, इसलिए पहले kimi --version और kimi --help जाँचें। AWR CLI को कॉल करने के लिए Kimi के टर्मिनल टूल का उपयोग करें, और वैकल्पिक रूप से इस सर्वर को प्रोजेक्ट की .kimi-code/mcp.json (यूज़र स्तर: ~/.kimi-code/mcp.json) में मर्ज करके उसी प्रोजेक्ट को stdio MCP पर जोड़ें — अन्य प्रविष्टियाँ संरक्षित रखते हुए:

{
  "mcpServers": {
    "awr": { "command": "/absolute/path/to/awr-mcp",
      "args": ["--project", "/absolute/path/to/initialized/project"],
      "cwd": "/absolute/path/to/initialized/project" }
  }
}

प्रोजेक्ट कॉन्फ़िगरेशन को वर्कस्पेस ट्रस्ट चाहिए। कॉन्फ़िगरेशन के लिए /mcp-config और कनेक्शन स्थिति देखने के लिए /mcp इस्तेमाल करें; कॉन्फ़िगरेशन संपादित करके जोड़े गए सर्वर नए बनाए गए सत्रों में जुड़ते हैं। awr_project_status से प्रोजेक्ट की पहचान की पुष्टि करें। Kimi सत्र मेटाडेटा के लिए प्रोवाइडर लेबल moonshot है।

Kimi के अपने kimi --continue, kimi --session <kimi-conversation-id> और /compact उसके वार्तालाप पर काम करते हैं; उनके ID, AWR ID से अलग हैं। कम्पैक्ट के बाद, उसी सक्रिय AWR सत्र के लिए कॉन्टेक्स्ट कम्पाइल करें — स्पष्ट AWR resume केवल वास्तविक हैंडऑफ़ के लिए है। Kimi SessionStart, SessionEnd, PreCompact और PostCompact हुक दर्ज करता है, लेकिन यह इंटीग्रेशन कोई स्वचालित एडाप्टर इंस्टॉल नहीं करता; मैन्युअल चेकपॉइंट प्रक्रिया इस्तेमाल करें।

Cursor

Cursor 3.18.9 के साथ जाँचा गया (2026-09-17)। Cursor के लिए awr client install न चलाएँ (Unsupported), और bind को --client cursor न दें (InvalidInput) — नीचे दी गई जेनेरिक क्लाइंट पहचान इस्तेमाल करें। stdio टेम्पलेट को प्रोजेक्ट .cursor/mcp.json या यूज़र ~/.cursor/mcp.json में मर्ज करें:

{
  "mcpServers": {
    "awr": { "type": "stdio", "command": "/absolute/path/to/awr-mcp",
      "args": ["--project", "/absolute/path/to/initialized/project"] }
  }
}

Cursor की stdio फ़ील्ड तालिका को "type": "stdio" चाहिए और यह cwd स्वीकार नहीं करती। AWR को केवल निरपेक्ष command और --project चाहिए। विंडो रीलोड करें और स्टार्टअप विफलता पर Output → MCP Logs जाँचें; जब दोनों कॉन्फ़िग फ़ाइलें मौजूद हों, तो Customize में पुष्टि करें कि Agent Window किससे जुड़ा। दो चेतावनियाँ:

समूहित टूल। वर्तमान स्रोत ट्री में, डिफ़ॉल्ट tools/list फ़्लैट टूल नामों के बजाय आठ डोमेन टूल (awr_query, awr_context, awr_work, awr_evidence, awr_session, awr_continuity, awr_change, awr_compaction) लौटाता है। awr_query से स्थिति प्रोब करें:

{"child_tool": "awr_project_status", "arguments": {}}

फ़्लैट नाम कॉल योग्य बने रहते हैं लेकिन डिफ़ॉल्ट कैटलॉग में नहीं होते; केवल तभी AWR_MCP_TOOL_EXPOSURE_MODE=flat सेट करें जब आपका Cursor बिल्ड डोमेन के माध्यम से रूट न कर सके। पैकेज्ड रिलीज़ समूहित awr_query प्रस्तुत नहीं करतीं — इस मार्ग के लिए स्रोत ट्री से बिल्ड करें, और पहले अपने बिल्ड का टूल कैटलॉग जाँचें।

Cloud Agents किसी लैपटॉप के awr-mcp या 127.0.0.1 तक नहीं पहुँच सकते; उन्हें सर्वर-साइड प्रोजेक्ट रूट वाला एक पहुँच योग्य HTTPS फ्रंट डोर चाहिए। AWR की साझा HTTP सेवा बियरर टोकन इस्तेमाल करती है (Cursor OAuth नहीं):

{
  "mcpServers": {
    "awr": { "url": "http://127.0.0.1:8080/mcp",
      "headers": { "Authorization": "Bearer ${env:AWR_ENGINEERING_TOKEN}" } }
  }
}

पहचान के लिए, नेटिव वार्तालाप ID के साथ जेनेरिक क्लाइंट बाँधें, और ID खाली होने पर विफल हों ताकि आप कभी शाब्दिक cursor: न बाँधें:

: "${HOST_CONVERSATION_ID:?set the native host conversation ID first}"
AWR_EXTERNAL="cursor:${HOST_CONVERSATION_ID}"
awrj client bind --client generic --external-session "$AWR_EXTERNAL" \
  --work "$AWR_WORK" --session "$AWR_SESSION"

Cursor .cursor/hooks.json में sessionStart, sessionEnd और preCompact हुक दर्ज करता है, लेकिन उस डायलेक्ट के लिए कोई इंस्टॉलर नहीं है — जब तक आपके पास लाइव हुक ट्रिगर और चेकपॉइंट रसीद न हो, मैन्युअल रूप से चेकपॉइंट करें।

Grok

Grok Build 1.0.13 के साथ जाँचा गया (2026-09-08)। AWR CLI को कॉल करने के लिए Grok के टर्मिनल टूल का उपयोग करें, या प्रोजेक्ट डायरेक्टरी से उसका stdio MCP क्लाइंट जोड़ें:

cd /absolute/path/to/initialized/project
grok mcp add --scope project awr -- /absolute/path/to/awr-mcp \
  --project /absolute/path/to/initialized/project
grok mcp doctor awr --json

add --scope project .grok/config.toml लिखता या अपडेट करता है (फ़्लैग न देने पर यूज़र स्कोप डिफ़ॉल्ट है); यदि awr पहले से किसी दूसरे प्रोजेक्ट को संदर्भित करता है तो अलग सर्वर नाम इस्तेमाल करें। समकक्ष तालिका यह है:

[mcp_servers.awr]
command = "/absolute/path/to/awr-mcp"
args = ["--project", "/absolute/path/to/initialized/project"]

Grok Build में /mcps से कनेक्शन देखें और ताज़ा करें, फिर awr_project_status कॉल करें और प्रोजेक्ट की पहचान सत्यापित करें। प्रोजेक्ट ट्रस्ट एक अलग पूर्व-आवश्यकता है: अविश्वसनीय फ़ोल्डर सर्वर को अप्रारंभित छोड़ देता है, इसलिए पहले क्लाइंट के सामान्य ट्रस्ट वर्कफ़्लो में प्रोजेक्ट की समीक्षा करें। Grok सत्र मेटाडेटा के लिए प्रोवाइडर लेबल xai है।

Grok की नेटिव वार्तालाप निरंतरता AWR सत्र रिकवरी से अलग है:

grok --cwd "$AWR_PROJECT" --continue
grok --cwd "$AWR_PROJECT" --resume <grok-conversation-id>

Grok का --session-id नया वार्तालाप बनाता है — यह न तो AWR ID है और न resume फ़्लैग। नेटिव कम्पैक्शन के बाद, उसी सक्रिय AWR सत्र के लिए कॉन्टेक्स्ट कम्पाइल करें; स्पष्ट AWR resume प्रवाह केवल वास्तविक हैंडऑफ़ के लिए इस्तेमाल करें।

Grok Build अपने हुक सिस्टम में सत्र और कम्पैक्ट इवेंट दर्ज करता है, लेकिन यहाँ कोई स्वचालित एडाप्टर इंस्टॉल नहीं होता; जब तक आपने वास्तविक ट्रिगर और रसीद सत्यापित न कर ली हो, मैन्युअल चेकपॉइंट प्रक्रिया इस्तेमाल करें। Grok web के कस्टम कनेक्टर को एक पहुँच योग्य MCP URL चाहिए — लोकल एक्ज़िक्यूटेबल पथ उस URL के रूप में दर्ज नहीं किया जा सकता; AWR की साझा HTTP सेवा वह भूमिका निभा सकती है, लेकिन उसे डिप्लॉय करना और कनेक्टर की प्रमाणीकरण आवश्यकताएँ पूरी करना एक अलग कदम है जिसे यह गाइड सत्यापित नहीं करती।

अगले कदम

MCP टूल — कनेक्ट होने के बाद आपका क्लाइंट जो पूरी टूल सतह कॉल कर सकता है।
दैनिक वर्कफ़्लो — start-work-checkpoint-resume लूप, चाहे आप कोई भी क्लाइंट इस्तेमाल करें।