Plannotator: कोड लिखने से पहले अपने कोडिंग एजेंट का प्लान कैसे रिव्यू करें और उस पर नोट्स लगाएं

Plannotator आपके कोडिंग एजेंट का प्लान ब्राउज़र में खोलता है, ताकि कोड लिखे जाने से पहले आप उस पर निशान लगाकर फ़ीडबैक भेज सकें। यहां इंस्टॉल का तरीका, कमांड और प्राइवेसी की बारीक बातें हैं।

Graphic of a browser window with a marked-up plan and comment bubbles, illustrating the Plannotator tool for reviewing coding agent plans.

आपके कोडिंग एजेंट ने अभी-अभी बारह स्टेप का प्लान बताया है और आपके प्रोजेक्ट को दोबारा लिखना शुरू करने से पहले आपकी हां चाहता है। आप टर्मिनल में उस पर सरसरी नज़र डालते हैं, “looks good” (ठीक लग रहा है) टाइप करते हैं और उम्मीद करते हैं कि स्टेप नौ आपकी कोई पसंदीदा चीज़ डिलीट न कर दे।

Plannotator एक ओपन-सोर्स टूल है जो इस सरसरी नज़र की जगह एक ठीक-ठाक रिव्यू सेशन देता है: प्लान आपके ब्राउज़र में खुलता है, आप उस पर लाइन-दर-लाइन कमेंट करते हैं और आपके नोट्स सीधे एजेंट के पास वापस जाते हैं। कोई भी कोड लिखे जाने से पहले इसे सेट अप करने और इस्तेमाल करने का तरीका यह है।

आपको क्या चाहिए

  • एक सपोर्टेड कोडिंग एजेंट। README में Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp और Pi के नाम हैं।
  • एक टर्मिनल और एक ब्राउज़र। README के शब्दों में Plannotator “a local, browser-based review surface” (ब्राउज़र में चलने वाली एक लोकल रिव्यू स्क्रीन) है।
  • Git, क्योंकि Plannotator के इंस्टॉलेशन डॉक्स के मुताबिक इंस्टॉलर को skills के लिए इसकी ज़रूरत होती है।

Plannotator मुफ़्त है, इसका डुअल लाइसेंस Apache 2.0 या MIT है, और 15 नवंबर 2026 तक इसके GitHub रिपो (backnotprop/plannotator) पर करीब 11,400 स्टार हैं। इसे 28 दिसंबर 2025 को बनाया गया था, और इसकी सबसे नई रिलीज़ v0.28.65 उसी दिन पब्लिश हुई थी। नीचे दी गई कमांड 15 नवंबर 2026 के README और डॉक्स से कॉपी की गई हैं और उन्हीं पेजों से मिलाई गई हैं; शेल लाइनें सिंटैक्स चेक पास करती हैं, लेकिन इस लेख के लिए हमने Plannotator इंस्टॉल नहीं किया।

स्टेप 1: प्रोग्राम इंस्टॉल करें

macOS, Linux या WSL पर:

टर्मिनल
curl -fsSL https://plannotator.ai/install.sh | bash

Windows PowerShell पर:

कोड
irm https://plannotator.ai/install.ps1 | iex

डॉक्स के मुताबिक इंस्टॉलर plannotator कमांड जोड़ता है, डाउनलोड को उसके SHA-256 चेकसम से जांचता है, और जो एजेंट उसे मिलते हैं उनके लिए hooks और बुनियादी skills इंस्टॉल करता है। पहली बार चलाने पर यह पूछता है कि क्या अतिरिक्त skills जोड़नी हैं; डिफ़ॉल्ट जवाब ‘नहीं’ है। जांच लें कि सब ठीक से हुआ:

कोड
plannotator --version

अगर किसी स्क्रिप्ट को सीधे अपने शेल में पाइप करने से आपको घबराहट होती है, तो डॉक्स में सिर्फ़ बाइनरी वाला इंस्टॉल (--minimal) और किसी वर्ज़न को पिन करके उसका स्रोत वेरिफ़ाई करने का तरीका भी दिया गया है।

स्टेप 2: अपने एजेंट को कनेक्ट करें

Claude Code में एक अतिरिक्त स्टेप करना होता है। Claude Code के अंदर यह चलाएं:

कोड
/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator

फिर Claude Code को रीस्टार्ट करें। README के मुताबिक Codex और Gemini CLI को और कुछ नहीं चाहिए (Gemini के लिए वर्ज़न 0.36.0 या उससे नया चाहिए), OpenCode को opencode.json में "plugin": ["@plannotator/opencode@latest"] चाहिए, और Pi के लिए pi install npm:@plannotator/pi-extension इस्तेमाल होता है। अगर hooks और skills आपके लिए नए हैं, तो हमारी Claude Code एजेंट skills गाइड सारे हिस्से समझाती है।

स्टेप 3: अपने एजेंट से प्लान लिखवाएं

इसके लिए आपको कोई कमांड टाइप नहीं करनी। README कहता है कि प्लान मोड हर एजेंट के hooks से जुड़ा होता है, इसलिए अगली बार जब आपका एजेंट कोई प्लान पूरा करेगा, रिव्यू स्क्रीन अपने आप खुल जाएगी।

पर्दे के पीछे README के मुताबिक यह होता है:

  1. एजेंट अपना प्लान पूरा करता है और प्लान मोड से बाहर निकलने की इजाज़त मांगता है (README इस स्टेप को ExitPlanMode कहता है)।
  2. एक hook चलता है और एक लोकल सर्वर प्लान को आपके ब्राउज़र में खोल देता है।
  3. आप नोट्स लगाते हैं, फिर मंज़ूर या नामंज़ूर करते हैं।
  4. अगर आप नामंज़ूर करते हैं, तो व्यवस्थित फ़ीडबैक एजेंट के पास जाता है और वह प्लान में बदलाव करता है। एक प्लान डिफ़ दिखाता है कि क्या बदला।

Plannotator की साइट कहती है कि आप सेक्शन पर कमेंट कर सकते हैं, टेक्स्ट को हटाने के लिए मार्क कर सकते हैं या उसकी जगह नया टेक्स्ट लिख सकते हैं, फिर उस फ़ीडबैक के साथ मंज़ूर या नामंज़ूर कर सकते हैं।

अपेक्षित नतीजा: ब्राउज़र का एक टैब जिसमें आपका प्लान दिख रहा हो, नोट्स लगाने के लिए तैयार।

स्टेप 4: जो चीज़ें पहले से हैं, उन पर नोट्स लगाएं

Plannotator सिर्फ़ प्लान तक सीमित नहीं है। ये कमांड README से ली गई हैं:

कोड
/plannotator-last
/plannotator-annotate README.md
/plannotator-annotate src/
/plannotator-review

पहली कमांड आपके एजेंट के आखिरी मैसेज पर नोट्स लगाती है। दूसरी और तीसरी किसी फ़ाइल या फ़ोल्डर पर निशान लगाने के लिए हैं। आखिरी कमांड आपके अनकमिटेड बदलावों के लिए पुल-रिक्वेस्ट जैसा डिफ़ व्यूअर खोलती है, और इसकी जगह आप GitHub PR या GitLab मर्ज रिक्वेस्ट का URL भी दे सकते हैं। Codex पर स्लैश की जगह $plannotator-* skills इस्तेमाल करें।

यह आपके डेटा के साथ क्या करता है

README कहता है कि Plannotator “does not collect usage telemetry or analytics” (इस्तेमाल से जुड़ी टेलीमेट्री या एनालिटिक्स इकट्ठा नहीं करता), और प्लान, डिफ़ व नोट्स डिफ़ॉल्ट रूप से लोकल ही रहते हैं। इसमें कुछ अपवाद भी बताए गए हैं जो जानने लायक हैं:

  • हर रिव्यू स्क्रीन लोड होते समय GitHub पर सबसे नई रिलीज़ चेक करती है। README कहता है कि फ़िलहाल इस चेक को बंद करने का कोई विकल्प नहीं है।
  • “Ask AI” सवाल और उससे जुड़ा संदर्भ आपके सेट किए गए प्रोवाइडर को भेजता है।
  • प्लान शेयर करने पर एक लिंक बनता है। README के मुताबिक छोटे शेयर बिना एन्क्रिप्शन के लिंक के अंदर ही पैक कर दिए जाते हैं, इसलिए जिसके पास भी लिंक है वह उन्हें पढ़ सकता है। बड़े शेयर अपलोड से पहले एन्क्रिप्ट किए जाते हैं, और होस्ट किए गए पेस्ट 7 दिन बाद एक्सपायर हो जाते हैं।

आम गड़बड़ियां और उनके हल

  • plannotator: command not found। नया टर्मिनल खोलें। डॉक्स कहते हैं कि आपका PATH बदल गया हो सकता है।
  • SSH पर या कंटेनर में रिव्यू पेज लोड नहीं होता। README के मुताबिक SSH पर Plannotator फ़िक्स्ड पोर्ट 19432 पर चला जाता है, और आपकी ~/.ssh/config के लिए लाइन LocalForward 19432 localhost:19432 है। कंटेनर में, या किसी दूसरे पोर्ट के लिए, PLANNOTATOR_REMOTE=1 और PLANNOTATOR_PORT=9999 सेट करें, फिर उस पोर्ट को फ़ॉरवर्ड करें। SSH नया है? हमारी SSH keys गाइड देखें।
  • रिमोट मोड पूरी तरह खुला रहता है। README चेतावनी देता है कि रिमोट मोड में सर्वर बिना लॉगिन के 0.0.0.0 पर सुनता है, इसलिए जो भी उस पोर्ट तक पहुंच सकता है वह इसे इस्तेमाल कर सकता है। जिन नेटवर्क पर आपको भरोसा नहीं, उनके लिए पोर्ट बंद रखें।
  • कोई विंडो दिखती ही नहीं। PLANNOTATOR_BROWSER=none कोई ब्राउज़र नहीं खोलता, और सेशन का URL हमेशा प्रिंट होता है।
  • Claude अब आपका इंतज़ार नहीं करता। README के मुताबिक Claude Code 2.1.287 या उससे नए वर्ज़न पर Claude अपनी बारी खत्म कर देता है और आपका फ़ैसला बाद में एक मैसेज के रूप में पहुंचता है। पुराना तरीका वापस लाने के लिए PLANNOTATOR_CLAUDE_MOD=0 सेट करें।
  • प्लगइन अपडेट नहीं हो रहा। claude plugin marketplace update plannotator चलाएं, फिर claude plugin update plannotator@plannotator, फिर रीस्टार्ट करें।
  • आप इसे हटाना चाहते हैं। पहले plannotator uninstall --dry-run से देख लें, फिर plannotator uninstall चलाएं। डिफ़ॉल्ट रूप से यह आपके प्लान और हिस्ट्री को बचाकर रखता है।

सार

जो प्लान आप सच में पढ़ते हैं, वह उस डिफ़ से सस्ता पड़ता है जिसे बाद में सुलझाना पड़े। अगर आप अपने एजेंट को ब्राउज़र भी चलाने देते हैं, तो हमारा Chrome DevTools MCP सेटअप देखें।

स्रोत

लिंक आखिरी बार 15 नवंबर 2026 को जांचे गए।

लेखक: Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

Mindloop Experience के बारे में

प्रतिक्रियाएँ

प्रतिक्रिया लिखें

Mindloop Experience से और

Mindloop Experience के सभी लेख

आप 50 बार तक ताली बजा सकते हैं।