Notiamo يقدر يشغّل وكيل ذكاء اصطناعي على التعليقات والمهام المفتوحة في مشروع. الوكيل بيعمل التعديلات، وواحد من فريقك بيوافق عليها. التشغيل ممكن يحصل على سيرفرات Notiamo، أو على جهاز إنت مالكه. الصفحة دي عن الطريقة التانية: المشغّل، وهو برنامج صغير بتركّبه على جهازك. وهو لفريق الوكالة.
المشغّل ده إيه
المشغّل بيستنى تشغيلات الوكيل اللي مؤسستك بتحطها في الطابور في Notiamo. وفي كل تشغيل بينسخ المستودع (أو بيتصل بموقع WordPress)، ويشغّل Claude Code بتعليمات التشغيل ده، ويبعت لـ Notiamo اللي الوكيل بيعمله، ويبلّغ لما يخلص.
- مابيشيلش أي بيانات دخول لـ Claude. بيشغّل برنامج
claudeالموجود أصلًا على الجهاز. وجلسات المشغّل بتستخدم فولدر إعدادات خاص بيها، فبتفضل بعيدة عن جلساتك. أما تسجيل الدخول نفسه فهو بتاع Claude Code، وClaude Code هو اللي بيحتفظ بيه. - مش تسجيل دخول لـ Claude جوه Notiamo. 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 |
بيشتغل في المقدمة. الخدمة هي اللي بتشغّل ده؛ ونادرًا ما هتحتاجه. |
الخدمة هي launchd agent اسمه com.notiamo.runner على macOS، ومهمة مجدولة (Scheduled Task) اسمها “Notiamo runner” على Windows، ووحدة مستخدم systemd اسمها notiamo-runner على Linux.
مشغّلين على جهاز واحد
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) والمضيفين اللي بتزوّدهم تحت مضيفين إضافيين الوكيل يقدر يوصلهم في كارت المشغّلات. وأي حاجة غير كده مرفوضة.
الوكيل عمره ما بيعمل push ومعاه أي بيانات دخول. المشغّل هو اللي بيعمل push للبرانش بتاع التشغيل بعد ما الوكيل يخلّص شغله.
لما التشغيل بيخلص، المشغّل بيوقّف كل عملية الوكيل سابها وراه، زي سيرفر التطوير.
الكيتشين (keychain) على macOS
على macOS الساندبوكس مابيقفلش الكيتشين بالكامل. علشان كده ماتسيبش أي تسجيل دخول لـ GitHub في كيتشين المستخدم اللي بيشغّل المشغّل (init بيحذّرك لو لقى واحد). أأمن إعداد هو مستخدم macOS مخصوص له كيتشين لوحده.
Windows
Windows العادي مفيهوش ساندبوكس للشيل. ساعتها نص في تعليق ممكن يخلّي التشغيل ينفّذ أي أمر باسمك. شغّل المشغّل جوه WSL2. على Windows العادي المشغّل مش بيبدأ إلا لو ضفت "allowUnsandboxed": true في ملف config.json بتاعه؛ اعمل كده بس على جهاز مفيهوش أي حاجة تانية.
كذا تشغيل في نفس الوقت
في كارت المشغّلات بتضبط عمليات التشغيل في نفس الوقت: من 1 لـ 3. كل تشغيل بيستهلك من باقة Claude بتاعتك، فخلّي العدد في حدود اللي الباقة تستحمله. ومشروع واحد عمره ما بيشتغل مرتين في نفس الوقت: التشغيل التاني على نفس المشروع بيستنى الأول.
كل تشغيل في نفس الوقت له فولدر خانة (slot) خاص بيه. وساندبوكس أي تشغيل مايقدرش يقرا الخانات التانية.
مشغّل لعميل واحد
لما بتعمل مشغّل، تقدر تحصره في مساحة عمل واحدة تحت بيشتغل لـ. وساعتها مابياخدش غير تشغيلات العميل ده. وعلشان تجهّزه على جهاز العميل: ركّب Claude Code هناك، وشغّل npx @notiamo/runner init، والصق توكن المشغّل. تسجيل الدخول لـ Claude على الجهاز ده هو اللي بيدفع تكلفة التشغيلات، فسجّل دخول بالحساب اللي المفروض يدفع.
أوامر التجهيز والاختبار
النسخة النظيفة المنسوخة مفيهاش باكدجات متركّبة. قول للوكيل يركّبها إزاي ويختبر إزاي. افتح إعدادات الوكيل بتاعة المشروع واملا أمر التجهيز وأمر الاختبار، سطر واحد لكل واحد.
- الوكيل بيشغّل أمر التجهيز مرة واحدة، قبل أول تعديل. مثال:
pnpm install --frozen-lockfile. - الوكيل بيشغّل أمر الاختبار قبل كل commit. التعديل اللي بيفشل فيه بيتصلّح أو بيتلغي. مثال:
pnpm typecheck && pnpm lint. - الوكيل بيشغّل الاتنين بنفسه، في نفس الساندبوكس بتاع باقي أوامره. ولازم سجل الباكدجات يكون ضمن المضيفين المسموحين. GitHub و
registry.npmjs.orgموجودين افتراضيًا. زوّد أي سجل تاني (PyPI أو crates.io أو سجل خاص) تحت مضيفين إضافيين الوكيل يقدر يوصلهم في كارت المشغّلات. - كل مشروع له فولدر كاش للباكدجات جنب نسخته المنسوخة. npm وpnpm وYarn وCorepack وBun وpip وuv وComposer بيحتفظوا بالكاش بتاعهم هناك، لأن الساندبوكس بيقفل الأماكن المعتادة في الفولدر الرئيسي بتاعك. الفولدر بيفضل بين تشغيلات المشروع وبيروح مع النسخة المنسوخة. وهو مش موجود على Windows العادي.
- خلّي أمر الاختبار خفيف. الاختبار اللي محتاج Docker مايقدرش يشتغل. والاختبار اللي محتاج قاعدة بيانات مايشتغلش إلا لو ملف env بتاع المشروع بيشاور على قاعدة بيانات إنت مسيبها شغّالة (شوف تحت).
الوكيل بيعمل commit باسم “Notiamo agent”، سطر بسيط واحد لكل بند. والمشغّل بيوقّف سطر “Co-Authored-By” وسطر “Generated with” بتوع Claude Code، فالمستودع مابيظهرش فيه أي مشارك ذكاء اصطناعي.
بيئة لمشاريعك الخاصة
التشغيل على مشروع GitHub بياخد نسخة نظيفة ومفيش حاجة غيرها. أما في مشروع برمجي بتاعك، فالاختبارات ممكن كمان تحتاج قاعدة بيانات، ومخزن ملفات، وحاجة تلقط الإيميلات، وملف .env. وجهاز المشغّل بيديهم لتشغيلات مشروع واحد عن طريق ملف عادي:
npx @notiamo/runner env <projectId>
<projectId> هو آخر جزء في عنوان صفحة المشروع في Notiamo. الأمر بيعمل ~/.notiamo-runner/env/<projectId>.env، ومقروء ليك إنت بس، وبيطبع مساره. حط KEY=VALUE واحد في كل سطر. التشغيل الجاي للمشروع ده بياخد المتغيرات في الشيل بتاعه، والوكيل بيتقاله أسماءها، مش قيمها أبدًا. امسح الملف علشان تشيلها. الملف عمره ما بيسيب الجهاز: Notiamo مايعرفش إنه موجود.
ولما الملف يكون موجود، الشيل بتاع التشغيل ممكن كمان يوصل لخدمات على 127.0.0.1 على macOS: 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) فلأ. - سيب عمليات التشغيل في نفس الوقت على 1 لما مشاريع مشغّل واحد بتتشارك قاعدة بيانات عن طريق ملف env بتاعها. تشغيلين في نفس الوقت هيعملوا اختباراتهم على نفس قاعدة البيانات.
مواقع WordPress
الاتصال بيكون في كارت الوصول للموقع في المشروع: باسورد تطبيق، واختياريًا SSH أو FTP. المشغّل بيحفظ مفتاح سيرفر SSH في أول اتصال، وبيرفض أي سيرفر يعرض مفتاح تاني بعد كده. والتشغيل بيمشي كده:
- نسخة احتياطية قبل الشغل. مع SSH المشغّل بيصدّر قاعدة البيانات وبيرفعها لـ Notiamo مضغوطة، بحد أقصى 200 ميجا. Notiamo بيحتفظ بيها لمدة 30 يوم. ومع FTP أو الـ API بس مفيش نسخة احتياطية.
- الوكيل بيشتغل ضمن قايمة السماح اللي تحت.
- فحص الموقع بعد الشغل. المشغّل بيفتح الموقع ويتأكد إنه لسه بيرد.
- استرجاع لو فشل. لو الفحص فشل، المشغّل بيسترجع قاعدة البيانات.
اللي الوكيل ممكن يشغّله بـ wp-cli، لكل مجموعة (بتتظبط على المشروع):
- المحتوى:
post *وterm *وmenu *وmedia importوoption getوoption update. - قاعدة البيانات:
search-replace(النص القديم والنص الجديد بس؛ ومش بيلمس جداول المستخدمين أو الخيارات أبدًا) و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 هو اللي بيفتح الـ pull request وبيدمجه.
وقّف مشغّل
في كارت المشغّلات، اضغط وقّف علشان توقّف مشغّل مؤقتًا، أو امسح علشان تشيله. توكن المشغّل الممسوح بيبطّل يشتغل فورًا.