Notiamo किसी प्रोजेक्ट की खुली टिप्पणियों और कामों पर एक AI एजेंट चला सकता है। एजेंट बदलाव करता है और आपकी टीम का एक व्यक्ति उन्हें मंज़ूर करता है। रन Notiamo के सर्वर पर हो सकता है, या आपके अपने कंप्यूटर पर। यह पेज दूसरे तरीके के बारे में है: रनर, एक छोटा प्रोग्राम जिसे आप अपनी मशीन पर लगाते हैं। यह एजेंसी की टीम के लिए है।
रनर क्या है
रनर उन एजेंट रन का इंतज़ार करता है जिन्हें आपका संगठन Notiamo में कतार में लगाता है। हर रन के लिए वह रिपॉज़िटरी क्लोन करता है (या WordPress साइट से जुड़ता है), रन के निर्देशों के साथ Claude Code शुरू करता है, एजेंट जो करता है वह Notiamo को भेजता है, और रन खत्म होने पर बताता है।
- उसके पास Claude की कोई साख नहीं होती। वह मशीन पर पहले से मौजूद
claudeप्रोग्राम शुरू करता है। रनर के सत्र अपना कॉन्फ़िग फ़ोल्डर इस्तेमाल करते हैं, इसलिए वे आपके अपने सत्रों से अलग रहते हैं। साइन-इन खुद Claude Code का है और Claude Code ही उसे संभालता है। - यह Notiamo के अंदर Claude लॉगिन नहीं है। Notiamo आपका Claude खाता कभी नहीं देखता और न इस्तेमाल करता है। रनर सिर्फ़ आपका अपना Claude Code चलाता है, आपकी मशीन पर, आपके अपने काम के लिए।
इसे लगाएं
आपको चाहिए:
- Node.js 22 या नया;
- Claude Code 2.1.314 या नया;
- git 2.31 या नया;
- Linux और WSL2 पर:
bubblewrapऔरsocat(Debian या Ubuntu:sudo apt install bubblewrap socat)। macOS पर और कुछ लगाने की ज़रूरत नहीं।
फिर:
- Notiamo में सेटिंग › एजेंट रन खोलें। रनर कार्ड पर नया रनर दबाएं और उसे एक नाम दें। टोकन कॉपी करें। वह सिर्फ़ एक बार दिखता है।
- मशीन पर यह चलाएं:
npx @notiamo/runner init
- टोकन पेस्ट करें।
initजांचता है कि Claude Code चलता है, रनर के लिए Claude Code का साइन-इन चलाता है, फिर सेवा लगाकर उसे शुरू करता है। - प्रोजेक्ट पर एजेंट कहाँ चलता है को अपनी मशीन पर सेट करें।
init खत्म होने पर रनर चल रहा होता है। लॉगिन या रीस्टार्ट के बाद वह अपने आप फिर शुरू हो जाता है।
कमांड
| कमांड | क्या करता है |
|---|---|
npx @notiamo/runner init |
रनर सेट करता है: टोकन, Claude Code का साइन-इन, सेवा लगाना और शुरू करना। |
npx @notiamo/runner@latest update |
रनर को नए संस्करण पर ले जाता है। टोकन, नाम और साइन-इन वैसे ही रहते हैं। |
npx @notiamo/runner status |
बताता है कि सेवा लगी है और चल रही है या नहीं, और लॉग की आखिरी पंक्ति दिखाता है। |
npx @notiamo/runner logs |
लॉग की आखिरी 50 पंक्तियां दिखाता है। |
npx @notiamo/runner stop |
अगले लॉगिन या बूट तक सेवा रोक देता है। |
npx @notiamo/runner uninstall |
सेवा हटा देता है। रनर का फ़ोल्डर रहता है। |
npx @notiamo/runner env <projectId> |
वह env फ़ाइल बनाता या दिखाता है जो यह मशीन एक प्रोजेक्ट के रन को देती है। |
npx @notiamo/runner start |
अग्रभूमि में चलता है। सेवा यही चलाती है; आपको इसकी कम ही ज़रूरत पड़ती है। |
सेवा macOS पर launchd एजेंट com.notiamo.runner है, Windows पर Scheduled Task “Notiamo runner” है, और Linux पर systemd यूज़र यूनिट notiamo-runner है।
एक मशीन पर दो रनर
npx @notiamo/runner init --profile staging एक दूसरा, अलग रनर सेट करता है। उसका अपना फ़ोल्डर (~/.notiamo-runner/profiles/staging) और अपनी सेवा होती है। उस रनर के हर कमांड में --profile staging जोड़ें। प्रोफ़ाइल के नाम में अक्षर, अंक और डैश होते हैं, 1 से 32 वर्ण।
एजेंट क्या छू सकता है और क्या नहीं
हर रन को Claude Code की अपनी सेटिंग फ़ाइल मिलती है। तीन चीज़ें एजेंट को उसकी हद में रखती हैं।
फ़ाइल टूल रन के फ़ोल्डर में ही रहते हैं। Claude के अपने फ़ाइल टूल (पढ़ना, बदलना, लिखना, खोजना) रन के फ़ोल्डर से बाहर की हर चीज़ से मना कर देते हैं। जो भी कॉल अनुमति मांगेगी उसे ठुकरा दिया जाता है, क्योंकि जवाब देने के लिए वहां कोई नहीं है।
शेल कमांड ऑपरेटिंग सिस्टम के सैंडबॉक्स में चलते हैं। macOS पर (Seatbelt) और Linux या WSL2 पर (bubblewrap और socat), एजेंट शेल में जो भी कमांड चलाता है वह बंद दायरे में रहता है। सैंडबॉक्स शुरू न हो सके तो रन शुरू नहीं होता।
मशीन की कोई साख एजेंट तक नहीं पहुंचती। Claude Code को पर्यावरण चरों की सिर्फ़ एक छोटी सूची मिलती है (PATH, HOME, USER, LOGNAME, SHELL, LANG, LC_ALL, LC_CTYPE, TERM, TMPDIR, TZ, XDG_*, प्रॉक्सी और सर्टिफ़िकेट की सेटिंग) और साथ में रन के अपने चर। उसे SSH_AUTH_SOCK, GH_TOKEN, GITHUB_TOKEN, NPM_TOKEN, AWS_* या ANTHROPIC_* कभी नहीं मिलते। एजेंट का git कोई ग्लोबल या सिस्टम git कॉन्फ़िग नहीं देखता।
शेल सैंडबॉक्स क्या होने देता है और क्या नहीं:
- पढ़ना मना: दूसरे प्रोजेक्ट के फ़ोल्डर (उसी समय चल रहे दूसरे रन भी), रनर की अपनी फ़ाइलें, और आपकी क्रेडेंशियल फ़ाइलें और फ़ोल्डर (SSH कुंजियां, क्लाउड लॉगिन, पैकेज रजिस्ट्री लॉगिन, git क्रेडेंशियल)।
- लिखना चालू: सिर्फ़ रन के फ़ोल्डर में और उसके बगल में प्रोजेक्ट के पैकेज कैश फ़ोल्डर में। रन के
.git/hooksऔर.git/configसिर्फ़ पढ़े जा सकते हैं। - नेटवर्क चालू: GitHub, npm, Notiamo, WordPress साइट (WordPress रन के लिए) और वे होस्ट जो आप रनर कार्ड पर एजेंट जिन अतिरिक्त होस्ट तक पहुँच सकता है में जोड़ते हैं। बाकी सब मना है।
एजेंट कभी पुश नहीं करता और उसके पास कोई साख नहीं होती। एजेंट के काम के बाद रन की ब्रांच को रनर खुद पुश करता है।
रन खत्म होने पर रनर वे सारे प्रोसेस रोक देता है जो एजेंट पीछे छोड़ गया, जैसे डेव सर्वर।
macOS पर कीचेन
macOS का सैंडबॉक्स कीचेन को पूरी तरह बंद नहीं करता। इसलिए रनर चलाने वाले यूज़र की कीचेन में कोई GitHub लॉगिन न रखें (मिलने पर init चेतावनी देता है)। सबसे सुरक्षित तरीका है अपनी अलग कीचेन वाला समर्पित macOS यूज़र।
Windows
साधारण Windows में शेल सैंडबॉक्स नहीं है। तब किसी टिप्पणी का टेक्स्ट रन से आपके नाम पर कोई भी कमांड चलवा सकता है। रनर को WSL2 के अंदर चलाएं। साधारण Windows पर रनर तब तक शुरू नहीं होता, जब तक आप उसकी config.json में "allowUnsandboxed": true नहीं जोड़ते; ऐसा सिर्फ़ उस मशीन पर करें जिस पर और कुछ नहीं रखा है।
एक साथ कई रन
रनर कार्ड पर आप एक साथ रन तय करते हैं: 1 से 3। हर रन आपके Claude प्लान का इस्तेमाल करता है, इसलिए संख्या उतनी ही रखें जितनी की गुंजाइश प्लान में है। एक प्रोजेक्ट एक ही समय में दो बार नहीं चलता: उसी प्रोजेक्ट का दूसरा रन पहले के खत्म होने का इंतज़ार करता है।
एक साथ चलने वाले हर रन का अपना स्लॉट फ़ोल्डर होता है। एक रन का सैंडबॉक्स दूसरे स्लॉट नहीं पढ़ सकता।
एक क्लाइंट के लिए रनर
रनर बनाते समय आप उसे इनके लिए चलता है में एक वर्कस्पेस तक सीमित कर सकते हैं। फिर वह सिर्फ़ उसी क्लाइंट के रन लेता है। इसे क्लाइंट के कंप्यूटर पर सेट करने के लिए: वहां Claude Code लगाएं, npx @notiamo/runner init चलाएं, और रनर का टोकन पेस्ट करें। रन का खर्च उस कंप्यूटर का Claude लॉगिन उठाता है, इसलिए उस खाते से साइन इन करें जिसे खर्च उठाना चाहिए।
सेटअप और टेस्ट कमांड
साफ़ क्लोन में कोई पैकेज लगा नहीं होता। एजेंट को बताएं कि उन्हें कैसे लगाना है और टेस्ट कैसे करना है। प्रोजेक्ट की एजेंट सेटिंग खोलें और सेटअप कमांड और टेस्ट कमांड भरें, हर एक एक पंक्ति में।
- एजेंट सेटअप कमांड अपने पहले बदलाव से पहले एक बार चलाता है। उदाहरण:
pnpm install --frozen-lockfile। - एजेंट टेस्ट कमांड हर कमिट से पहले चलाता है। जो बदलाव उसमें फ़ेल हो, उसे ठीक किया जाता है या वापस ले लिया जाता है। उदाहरण:
pnpm typecheck && pnpm lint। - एजेंट दोनों खुद चलाता है, अपने बाकी कमांड वाले उसी सैंडबॉक्स में। पैकेज रजिस्ट्री अनुमत होस्ट में होनी चाहिए। GitHub और
registry.npmjs.orgडिफ़ॉल्ट रूप से वहां हैं। कोई और (PyPI, crates.io, निजी रजिस्ट्री) रनर कार्ड पर एजेंट जिन अतिरिक्त होस्ट तक पहुँच सकता है में जोड़ें। - हर प्रोजेक्ट के क्लोन के बगल में एक पैकेज कैश फ़ोल्डर होता है। npm, pnpm, Yarn, Corepack, Bun, pip, uv और Composer अपना कैश वहीं रखते हैं, क्योंकि सैंडबॉक्स आपके होम फ़ोल्डर की आम जगहें बंद रखता है। फ़ोल्डर प्रोजेक्ट के रन के बीच बना रहता है और क्लोन के साथ चला जाता है। साधारण Windows पर यह नहीं होता।
- टेस्ट कमांड हल्का रखें। जिस टेस्ट को Docker चाहिए वह नहीं चल सकता। जिस टेस्ट को डेटाबेस चाहिए वह तभी चल सकता है जब प्रोजेक्ट की env फ़ाइल आपके चालू रखे किसी डेटाबेस की ओर इशारा करे (नीचे देखें)।
एजेंट “Notiamo agent” के नाम से कमिट करता है, हर चीज़ के लिए एक सादी पंक्ति। रनर Claude Code का “Co-Authored-By” ट्रेलर और “Generated with” पंक्ति बंद कर देता है, इसलिए रिपॉज़िटरी में कोई AI सह-लेखक नहीं दिखता।
आपके अपने प्रोजेक्ट के लिए एक माहौल
GitHub प्रोजेक्ट के रन को एक साफ़ क्लोन मिलता है, और कुछ नहीं। आपके अपने सॉफ़्टवेयर प्रोजेक्ट के टेस्ट को डेटाबेस, फ़ाइल स्टोर, मेल कैचर और .env की भी ज़रूरत पड़ सकती है। रनर मशीन उन्हें एक सादी फ़ाइल से एक प्रोजेक्ट के रन को देती है:
npx @notiamo/runner env <projectId>
<projectId> Notiamo में प्रोजेक्ट पेज के पते का आखिरी हिस्सा है। यह कमांड ~/.notiamo-runner/env/<projectId>.env बनाता है, जिसे सिर्फ़ आप पढ़ सकते हैं, और उसका पथ दिखाता है। हर पंक्ति में एक KEY=VALUE रखें। उस प्रोजेक्ट का अगला रन ये चर अपनी शेल में पाता है, और एजेंट को उनके नाम बताए जाते हैं, मान कभी नहीं। उन्हें हटाने के लिए फ़ाइल हटा दें। फ़ाइल मशीन से बाहर कभी नहीं जाती: Notiamo को पता ही नहीं कि वह मौजूद है।
फ़ाइल होने पर, macOS पर रन की शेल 127.0.0.1 की सेवाओं तक भी पहुंच सकती है: आपका Postgres, फ़ाइल स्टोर, डेव सर्वर। उन्हें आप चालू रखते हैं; एजेंट उन्हें शुरू नहीं कर सकता, और Docker उसकी पहुंच से बाहर रहता है। Linux पर सैंडबॉक्स का अपना नेटवर्क होता है, इसलिए वहां 127.0.0.1 मशीन का नहीं है: सेवाओं को मशीन के नेटवर्क पते पर बाइंड करें और वह होस्ट एजेंट जिन अतिरिक्त होस्ट तक पहुँच सकता है में जोड़ें।
नियम:
- सिर्फ़ डेवलपमेंट और टेस्ट के मान। एजेंट शेल कमांड चलाता है और हर चर पढ़ सकता है। कभी कोई प्रोडक्शन कुंजी नहीं, कभी वह पासवर्ड नहीं जो आप कहीं और इस्तेमाल करते हैं।
PATH,HOME, प्रॉक्सी और सर्टिफ़िकेट के चर,NODE_OPTIONS,NODE_TLS_REJECT_UNAUTHORIZED,NOTIAMO_*,GIT_*,CLAUDE_*औरANTHROPIC_*अनदेखे किए जाते हैं, और लॉग यह बताता है। फ़ाइल यह बदल सकती है कि एजेंट के कमांड को क्या दिखता है, यह नहीं कि Claude Code, Anthropic और Notiamo से कैसे बात करता है।- 6 या ज़्यादा वर्णों के मान उस ट्रांसक्रिप्ट में
[secret]से ढक दिए जाते हैं जो Notiamo को मिलता है। छोटे मान (1,true) नहीं ढके जाते। - जब किसी रनर के प्रोजेक्ट अपनी env फ़ाइल से एक ही डेटाबेस साझा करें, तो एक साथ रन को 1 पर रखें। एक ही समय के दो रन अपने टेस्ट एक ही डेटाबेस पर चलाएंगे।
WordPress साइट
कनेक्शन प्रोजेक्ट के वेबसाइट पहुंच कार्ड पर है: एक एप्लिकेशन पासवर्ड, और चाहें तो SSH या FTP। रनर पहली बार जुड़ने पर SSH सर्वर की कुंजी याद रखता है और बाद में दूसरी कुंजी दिखाने वाले सर्वर को मना कर देता है। रन ऐसे चलता है:
- पहले बैकअप। SSH के साथ रनर डेटाबेस एक्सपोर्ट करता है और उसे संपीड़ित करके Notiamo पर अपलोड करता है, अधिकतम 200 MB। Notiamo इसे 30 दिन तक रखता है। सिर्फ़ FTP या API के साथ बैकअप नहीं होता।
- एजेंट नीचे दी अनुमति सूची के अनुसार काम करता है।
- बाद में साइट की जांच। रनर साइट खोलता है और जांचता है कि वह अब भी जवाब देती है।
- फ़ेल होने पर बहाली। जांच फ़ेल हो तो रनर डेटाबेस बहाल कर देता है।
एजेंट wp-cli से क्या चला सकता है, समूह के हिसाब से (प्रोजेक्ट पर सेट होता है):
- सामग्री:
post *,term *,menu *,media import,option get,option update। - डेटाबेस:
search-replace(सिर्फ़ पुराना और नया टेक्स्ट; यह users या options टेबल को कभी नहीं छूता),cache flush,rewrite flush,transient delete। - प्लगइन और थीम:
pluginऔरtheme,list,activate,deactivate,updateके साथ। - जानकारी:
core version,site list,db size। - फ़ाइलें: कोई wp-cli कमांड नहीं; एजेंट अपने फ़ाइल टूल इस्तेमाल करता है। वे स्टाइल, स्क्रिप्ट और ऐसी दूसरी फ़ाइलें लिखते हैं जिन्हें सर्वर नहीं चलाता।
- PHP फ़ाइलें (डिफ़ॉल्ट रूप से बंद): फ़ाइल टूल PHP भी लिख सकते हैं। PHP फ़ाइल वह कोड है जो आपके सर्वर पर चलता है, और WordPress रन में मंज़ूरी का कोई चरण नहीं होता: बदलाव तुरंत लाइव हो जाता है। इसे सिर्फ़ उस साइट के लिए चालू करें जहां आप टिप्पणी लिख सकने वाले हर व्यक्ति पर भरोसा करते हैं।
- कभी नहीं, जब तक आप “सब कुछ अनुमति दें” न चुनें:
eval,eval-file,shell,user *,db query|import|reset|drop|export,plugin install,theme install,core update|download।
क्या कहां रखा जाता है
सब कुछ ~/.notiamo-runner में रहता है।
| पथ | इसमें क्या है |
|---|---|
config.json |
Notiamo का पता, रनर का नाम और रनर टोकन। सिर्फ़ आप पढ़ सकते हैं। |
claude/ |
रनर के लिए Claude Code का कॉन्फ़िग फ़ोल्डर: उसका साइन-इन और सत्र। |
projects/ |
आपके प्रोजेक्ट की कामकाजी कॉपियां, हर स्लॉट में हर प्रोजेक्ट का एक फ़ोल्डर। जो प्रोजेक्ट रनर कार्ड पर तय दिनों तक इस्तेमाल नहीं हुआ, वह हटा दिया जाता है; अगला रन उसे फिर क्लोन करता है। |
git/ |
आपकी रिपॉज़िटरी की रनर की अपनी कॉपियां। एजेंट इस फ़ोल्डर को न पढ़ सकता है न लिख सकता है। |
env/ |
आपकी बनाई env फ़ाइलें, हर प्रोजेक्ट की एक। |
runs/ |
चल रहे हर रन की Claude Code सेटिंग। कोई गुप्त बात नहीं। रन खत्म होने पर हटा दी जाती है। |
runner.log |
रनर ने क्या किया, बिना किसी गुप्त बात के। |
state.json |
चल रहे रन की आईडी। रीस्टार्ट के बाद हर एक Notiamo को फ़ेल बताया जाता है। |
रन के गुप्त मान (WordPress पासवर्ड, रन के अपने टोकन) रन के साथ Notiamo से आते हैं और सिर्फ़ मेमोरी में रहते हैं। एजेंट को वे पर्यावरण चरों के रूप में मिलते हैं, फ़ाइल में कभी नहीं। एजेंट जो प्रिंट करता है, ट्रांसक्रिप्ट अपलोड होने से पहले उसमें से वे साफ़ कर दिए जाते हैं।
रनर मशीन की git साख कभी इस्तेमाल नहीं करता। हर रन को Notiamo से एक GitHub टोकन मिलता है जो एक घंटे और सिर्फ़ रन की रिपॉज़िटरी के लिए चलता है। रनर उसे मेमोरी में रखता है और अपने fetch और push के लिए इस्तेमाल करता है। पुल रिक्वेस्ट Notiamo खोलता और मर्ज करता है।
रनर रोकें
रनर कार्ड पर, रनर को रोकने के लिए बंद करें दबाएं, या हटाने के लिए हटाएं। हटाए गए रनर का टोकन तुरंत काम करना बंद कर देता है।