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 پر مزید کچھ لگانے کی ضرورت نہیں۔

پھر:

  1. Notiamo میں ترتیبات › ایجنٹ رنز کھولیں۔ رنرز کارڈ پر نیا رنر دبائیں اور اسے نام دیں۔ ٹوکن کاپی کریں۔ یہ صرف ایک بار دکھایا جاتا ہے۔
  2. مشین پر یہ چلائیں:
npx @notiamo/runner init
  1. ٹوکن پیسٹ کریں۔ init جانچتا ہے کہ Claude Code کام کرتا ہے، رنر کے لیے Claude Code کا سائن اِن چلاتا ہے، پھر سروس لگاتا ہے اور اسے شروع کرتا ہے۔
  2. پروجیکٹ پر ایجنٹ کہاں چلتا ہے کو اپنی مشین پر سیٹ کریں۔

جب 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 پر کی چین (keychain)

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 سرور کی کلید یاد رکھتا ہے اور بعد میں دوسری کلید دکھانے والے سرور کو رد کر دیتا ہے۔ رن اس طرح چلتا ہے:

  1. کام سے پہلے بیک اپ۔ SSH کے ساتھ رنر ڈیٹابیس ایکسپورٹ کر کے کمپریس شدہ شکل میں Notiamo پر اپ لوڈ کرتا ہے، زیادہ سے زیادہ 200 MB۔ Notiamo اسے 30 دن تک رکھتا ہے۔ صرف FTP یا API کے ساتھ بیک اپ نہیں ہوتا۔
  2. ایجنٹ نیچے دی گئی اجازت فہرست کے اندر کام کرتا ہے۔
  3. کام کے بعد سائٹ کی جانچ۔ رنر سائٹ کھولتا ہے اور دیکھتا ہے کہ وہ اب بھی جواب دیتی ہے۔
  4. ناکامی پر بحالی۔ اگر جانچ ناکام ہو تو رنر ڈیٹابیس بحال کر دیتا ہے۔

ایجنٹ 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 ٹوکن ملتا ہے جو ایک گھنٹے کے لیے اور صرف رن کی ریپوزٹری کے لیے کام کرتا ہے۔ رنر اسے میموری میں رکھتا ہے اور اپنے فیچ اور پش کے لیے استعمال کرتا ہے۔ پل ریکوئسٹ Notiamo کھولتا اور مرج کرتا ہے۔

رنر کو روکیں

رنرز کارڈ پر رنر کو روکنے کے لیے غیر فعال کریں دبائیں، یا ہٹانے کے لیے حذف کریں۔ حذف کیے گئے رنر کا ٹوکن فوراً کام کرنا بند کر دیتا ہے۔