الوثائق
Palgu هو الـ superharness الهندسي المتكامل لوكلاء البرمجة في فريقك. يكتب المطورون الكود باستخدام palgu. يمر كل طلب عبر واجهة برمجة تطبيقات Palgu، حيث يتحكم فريقك في توجيه النماذج والميزانيات والسياسات، مع سجل تدقيق مركزي.
دليل البدء
ثبّت palgu ووكيل البرمجة بأمر واحد، ثم سجّل الدخول. يفتح الأمر login المتصفح لاعتماد الجهاز الذي يحصل على مفتاحه الخاص (يمكنك الاعتماد من أي متصفح، لذا يعمل عبر SSH)، ثم يبدأ جلسة برمجة في هذا المجلد (--no-start يسجّل الدخول فقط). تتطلب البرمجة Node.js 20 أو أحدث.
curl -fsSL https://api.palgu.ai/install.sh | bash palgu login # sign in, then Palgu starts here palgu -p "explain this repo" # a first task, then exit palgu # coding session in this directory palgu help # the everyday commands
يتطلب Node.js 20 أو أحدث. يضيفه المثبّت إن لم يكن موجودًا.
irm https://api.palgu.ai/install.ps1 | iex # PowerShell, no admin rights palgu login # sign in, then Palgu starts here palgu -p "explain this repo" # a first task, then exit palgu # coding session in this directory palgu help # the everyday commands
يتطلب Node.js 20 أو أحدث. يضيفه المثبّت إن لم يكن موجودًا.
يتطلب نظام Windows تثبيت Git for Windows وNode.js 20+ (winget install Git.Git OpenJS.NodeJS.LTS).
هل أنت جديد هنا؟ سجّل حسابك أولاً (عبر رمز لمرة واحدة يصلك بالبريد الإلكتروني؛ وبذلك تُنشأ مؤسستك). تتوفر في صفحة التنزيل نسخة Studio أيضاً. Studio لنظامي macOS وWindows.
استخدام Palgu داخل Claude Code
palgu أداة برمجة مستقلة بسطر الأوامر، ولم تعد تغيّر إعدادات Claude Code أو Codex. لاستخدام Palgu من داخل Claude Code، ثبّت Mixture of Models mod مفتوح المصدر: تبقى جلستك على اشتراك Claude الخاص بك وتمر الأدوار التي يوجّهها الـ mod عبر Palgu. راجع Mixture of models.
claude plugin marketplace add alinaqi/mixture-of-models-claude-mod
claude plugin install mixture-of-models@mixture-of-models-claude-mod
/palgu login # inside Claude Code: sign in to Palgu
أدوات أخرى
تحتوي البوابة على نقطتي نهاية: واحدة أصلية لـ Anthropic على /anthropic/v1/messages وأخرى متوافقة مع OpenAI على /v1/chat/completions. وجّه أي أداة إلى إحداهما باستخدام مفتاح srt_ من لوحة التحكم. شرح خطوة بخطوة لكل أداة: استخدم Palgu مع أدواتك.
أدوات بنمط Anthropic
ANTHROPIC_BASE_URL=https://api.palgu.ai/anthropic ANTHROPIC_API_KEY=srt_xxx_yyy
aider / العملاء المتوافقون مع OpenAI
OPENAI_BASE_URL=https://api.palgu.ai/v1 OPENAI_API_KEY=srt_xxx_yyy
الطلبات الطويلة
الاستدعاء غير المتدفق الذي لم يُجب بعد 45 ثانية يتلقى HTTP 200 مبكرًا حتى يبقى الاتصال مفتوحًا. إذا فشل بعد ذلك، مثلًا بانتهاء المهلة 504، يصل الخطأ في نص الاستجابة، مع الحالة الحقيقية في error.status. تحقّق من وجود error في نص كل استجابة، وأرسل "stream": true للاستدعاءات التي قد تطول.
{"error": {"message": "...", "type": "server_error", "code": null, "status": 504}}
الرجوع إلى نموذج مشابه
ينتمي كل نموذج إلى فئة: premium أو frontier أو workhorse أو fast أو image أو internal. عندما يكون النموذج الذي يخدم طلبًا موجَّهًا مثقلًا أو متوقفًا (الخطأ 429 أو 5xx أو خطأ في الاتصال أو انتهاء المهلة أو رد فارغ) قبل أن يبدأ الرد، يرسل Palgu الطلب إلى النموذج السليم التالي في قائمة البدائل الخاصة به، ثم إلى أرخص النماذج الأخرى في فئته. لا تُضاف النماذج المميزة أبدًا كبديل تلقائي، ولا يُحوَّل رد بدأ بثه إلى نموذج آخر.
- X-Palgu-Fallback: auto: الرجوع إلى بديل كما هو موضح أعلاه. النموذج المثبَّت (x-srooter-pin) يرجع أيضًا إلى بديل عندما يكون مثقلًا، ولا يرجع أبدًا عندما يكون الخطأ في الطلب نفسه (الخطأ 400 أو 422 أو خطأ في طول السياق).
- X-Palgu-Fallback: off: لا رجوع إلى بديل في هذا الطلب، ويُعاد خطأ النموذج نفسه دون تغيير.
- X-Palgu-Fallback-Models: glm-5.3,class:fast: قائمة البدائل لهذا الطلب فقط. تظل سياسة النماذج في مؤسستك سارية.
- class:fast كاسم للنموذج (أو للتثبيت): يرد أرخص نموذج سليم في تلك الفئة، وبقية الفئة هي بدائله.
يذكر كل رد النموذج الذي أجاب: X-Palgu-Requested-Model وX-Palgu-Served-Model، وبعد الرجوع إلى بديل X-Palgu-Fallback-Reason (مثل upstream_429 أو upstream_5xx أو timeout). يعرض GET /v1/models/health فئة كل نموذج، وهل هو سليم لمؤسستك الآن، وuntil ما دامت دائرته مفتوحة.
curl https://api.palgu.ai/v1/chat/completions -i \
-H "Authorization: Bearer $SROOTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Palgu-Fallback: auto" \
-d '{"model":"class:frontier","messages":[{"role":"user","content":"hello"}]}'
استخدم Palgu مع أدواتك
اكتب الكود في تطبيقات Palgu الخاصة، حيث يمر كل طلب عبر Palgu، أو احتفظ بالأداة التي تستخدمها واربطها. تستخدم الأدوات التي تقبل عنوانًا أساسيًا (base URL) البوابة على https://api.palgu.ai/v1 مع مفتاح Palgu (srt_) من صفحة مفاتيح API.
| الأداة | طريقة الاتصال | الأنسب لـ |
|---|---|---|
| palgu (CLI) | وكيل البرمجة الخاص بـ Palgu. يمر كل طلب عبر Palgu. | البرمجة في الطرفية مع التوجيه والميزانيات والسياسة والتدقيق والذاكرة الخاصة بفريقك |
| Palgu Studio | تطبيق سطح المكتب. يمر كل طلب عبر Palgu. | مهام متوازية، ومراجعة جماعية، ومعرفة برمجية في نافذة واحدة |
| Claude Code | إضافة Mixture of Models. تبقى الأدوار الحرجة ضمن اشتراك Claude الخاص بك؛ ويعمل الباقي على Palgu. | الاحتفاظ بـ Claude Code واستهلاك قدر أقل من رصيدك في Claude |
| Codex | مزود Palgu وملف تعريف في إعدادات Codex (Responses API) باستخدام مفتاح Palgu. | تشغيل Codex على نماذج Palgu، ضمن سياسة فريقك |
| Cursor | عنوان URL الأساسي لـ OpenAI ومفتاح Palgu في إعدادات Cursor. | المحادثة داخل المحرر باستخدام نماذج Palgu |
| aider والأدوات الأخرى المتوافقة مع OpenAI | عنوان URL الأساسي لـ OpenAI ومفتاح Palgu. | أي أداة تقبل عنوان OpenAI الأساسي (base URL) |
palgu، واجهة سطر أوامر Palgu (CLI)
وكيل البرمجة الخاص بـ Palgu داخل الطرفية (terminal). يمر كل طلب عبر Palgu، لذا تنطبق قواعد التوجيه والميزانيات والسياسات والتدقيق والمعرفة البرمجية والذاكرة على كل شيء.
الإعداد
curl -fsSL https://api.palgu.ai/install.sh | bash # Windows: see Getting started palgu login # sign in in the browser; starts a session here palgu -p "explain this repo" # one task, then exit
تحقق من عمله
يفحص الأمر palgu doctor تسجيل الدخول والمفتاح والبوابة، ويخبرك بما يجب إصلاحه.
القيود
- يتطلب Node.js 20 أو أحدث (يضيفه برنامج التثبيت).
- هل تريد تشغيل مهمة على خطة برمجة تدفع ثمنها بالفعل؟ راجع اشتراكاتك الخاصة.
Palgu Studio
تطبيق سطح المكتب: المهام كمحادثات حية، وعمل متوازٍ في أشجار عمل (worktrees) معزولة، ومراجعة جماعية ومعرفة برمجية. يمر كل طلب عبر Palgu، دون أن يتغير شيء في بيئة الطرفية (shell) لديك.
الإعداد
نزّله من صفحة التنزيل، وافتحه وسجّل الدخول. ثم افتح مجلد مشروع وصِف المهمة.
تحقق من عمله
يظهر الحاسوب في صفحة الأجهزة الخاصة بك، وتظهر طلبات مهمتك الأولى في لوحة التحكم.
القيود
- لسطح المكتب فقط: راجع صفحة التنزيل لمعرفة الأنظمة المدعومة.
- المزيد في Palgu Studio.
Claude Code: تعديل مزيج النماذج (Mixture of Models)
تقوم إضافة Mixture of Models mod مفتوحة المصدر (بترخيص MIT) بتقييم كل موجه (prompt) وإبقاء الموجهات الحرجة في جلسة Claude Code الرئيسية الخاصة بك. وتُرسل الأدوار الأخرى إلى نماذج يديرها Palgu، ضمن قواعد التوجيه والميزانيات والسياسات والتدقيق الخاصة بمؤسستك. تبقى جلستك الرئيسية على اشتراك Claude الخاص بك: لا يرى Palgu بيانات دخولك إلى Claude ولا يخزنها أو يعيد توجيهها أبدا. المزيد في صفحة مزيج النماذج.
الإعداد
claude --version # mods need 2.1.287 or later; otherwise: claude update claude plugin marketplace add alinaqi/mixture-of-models-claude-mod claude plugin install mixture-of-models@mixture-of-models-claude-mod # then start claude, and inside it: /palgu login # approve the code in your browser; this computer gets its own key
يُحفظ المفتاح في وحدة التخزين الآمنة الخاصة بـ Claude Code ويُدرج في صفحة الأجهزة لديك، حيث يمكنك إبطاله.
تحدد استراتيجيات التوجيه الأدوار التي تغادر Claude والنموذج الذي يتولاها:
- complexity (الافتراضي): حجم الضرر الذي تسببه الإجابة الخاطئة. تبقى مهام الأمان والبنية الهندسية وبيئة الإنتاج وأي إجراء لا رجعة فيه على Claude.
- cost: يرسل مزيدًا من الأدوار إلى نماذج أوفر تكلفة؛ وعند عدم التأكد، يمنح درجة أقل.
- speed: يختار نماذج أسرع للأعمال البسيطة.
- quality: يُبقي مزيدًا من الأدوار على Claude؛ وعند عدم التأكد، يمنح درجة أعلى.
- استراتيجيتك الخاصة: اطلب من Claude استخدام مهارة routing-strategy الخاصة بالتعديل، والتي تسألك عما تريد تحسينه وتكتب الاستراتيجية.
/route strategies # the built-in strategies and yours /route strategy cost # switch; remembered across sessions /route auto # score every prompt (the default) /route off # never route; everything stays on Claude
تحقق من عمله
يعرض الأمر /palgu status حسابك ومؤسستك وخطتك. ويؤكد الأمر /route أن التعديل (mod) نشط ويعرض الوضع الحالي (مثل auto (cost)). كما يظهر سطر أسفل كل إجابة موجّهة يذكر النموذج والدرجة، ويعرض الأمر /route stats مخططًا لأدوارك حسب النموذج.
القيود
- يعمل الدور الموجَّه في جلسة Claude Code منفصلة بلا واجهة مع ملخص قصير لمحادثتك الأخيرة، وليس ذاكرتها الكاملة. وتعود رسائل المتابعة مثل "continue" إلى جلستك الرئيسية.
- تصل الإجابات الموجهة عند انتهاء الدور؛ ولا يتم بثها تدريجيا (streaming).
- لا تعمل الخطافات (hooks) الخاصة بك في الدور الموجه. تمنع الإضافة قراءة ملفات .env والمفاتيح ومجلدات secrets/ هناك باستخدام قواعد أذونات Claude Code.
- الأدوار الموجهة فقط هي التي تمر عبر Palgu، لذا فإن سياساتك وميزانياتك وتدقيقك تغطي تلك الأدوار دون الجلسة الرئيسية.
Codex
تشغيل Codex على نماذج Palgu عبر واجهة Responses API الخاصة بالبوابة، ضمن قواعد التوجيه والميزانيات والسياسات وسجل التدقيق الخاصة بفريقك. ويستخدم مفتاح Palgu، وليس تسجيل دخولك في ChatGPT، وذلك فقط عندما تطلب ملف التعريف palgu.
الإعداد
أنشئ الملف ~/.codex/palgu.config.toml. لا يكتب Palgu هذا الملف أبدًا، ويبقى ملف ~/.codex/config.toml لديك كما هو.
model_provider = "palgu"
model = "<a model your org has enabled>"
[model_providers.palgu]
name = "Palgu"
base_url = "https://api.palgu.ai/v1"
wire_api = "responses"
env_key = "PALGU_API_KEY"
http_headers = { "x-srooter-pin" = "<the same model>" } # serve exactly that model
export PALGU_API_KEY=srt_... # a Palgu key from the API keys page codex --profile palgu # or one task: codex exec --profile palgu "task"
تحقق من عمله
شغّل codex exec --profile palgu "create hello.txt that says hi" في مجلد تجريبي: سيظهر الملف، وسيظهر الطلب في لوحة التحكم الخاصة بك.
القيود
- يقرأ Codex 0.166 أو الأحدث ملفات التعريف من ملفها المستقل. أما الإصدارات الأقدم من Codex فتأخذ الإعدادات نفسها تحت [profiles.palgu] في config.toml.
- لتشغيل Codex على خطة ChatGPT الخاصة بك بدلا من ذلك، تجاهل ملف التعريف (profile)، أو دع Palgu يشغّله نيابة عنك: راجع اشتراكاتك الخاصة.
مع إضافة Mixture of Models: يكتب دليل Codex الخاص بها ملف التعريف palgu نفسه نيابة عنك، ويضيف ذاكرة Palgu إلى كل طلب، ويُكمل الدورة التي تتوقف في منتصف المهمة.
Cursor
محادثة Cursor على نماذج Palgu، مع تطبيق سياسة فريقك وميزانياته وسجل التدقيق على تلك الطلبات.
الإعداد
- افتح إعدادات Cursor، ثم انتقل إلى Models.
- ضمن مفاتيح API، الصق مفتاح Palgu الخاص بك كمفتاح OpenAI API وفعّل Override OpenAI Base URL باستخدام https://api.palgu.ai/v1.
- أضف نموذجًا يحمل اسم أحد النماذج التي فعّلتها مؤسستك، واختره في المحادثة.
تحقق من عمله
اسأل شيئًا في محادثة Cursor مع تحديد ذلك النموذج: سيظهر الطلب في لوحة التحكم لديك.
القيود
- يرسل Cursor هذه الطلبات من خوادمه الخاصة، لذا فهو يعمل مع البوابة السحابية، وليس مع بوابة تعمل على حاسوبك.
- يستمر الإكمال التلقائي عبر Tab وبعض ميزات Cursor الخاصة في استخدام نماذج Cursor.
مع إضافة Mixture of Models: يضيف دليل Cursor الخاص بها البحث في ذاكرة Palgu، ويرسل المهام الفرعية المستقلة إلى نماذج أرخص عبر Palgu، ويُكمل الدورة التي تتوقف في منتصف المهمة.
aider والأدوات الأخرى المتوافقة مع OpenAI
أي أداة تقبل عنوان OpenAI الأساسي (base URL): aider و Cline و Roo Code و Kilo Code و Continue و Zed و OpenHands و OpenCode. اختر المزود المتوافق مع OpenAI (OpenAI Compatible)، واضبط العنوان الأساسي وضع مفتاح Palgu في إعدادات الأداة (وليس في ملف ترفعه إلى المستودع).
الإعداد
export OPENAI_API_BASE='https://api.palgu.ai/v1' export OPENAI_API_KEY=srt_... aider --model openai/<a model your org has enabled>
تحقق من عمله
يستجيب الاستدعاء المباشر، ويذكر كل رد اسم النموذج الذي أجاب في الترويسة X-Palgu-Served-Model:
curl -i https://api.palgu.ai/v1/chat/completions \
-H "Authorization: Bearer $OPENAI_API_KEY" -H "Content-Type: application/json" \
-d '{"model":"<your-model>","messages":[{"role":"user","content":"hello"}]}'
القيود
- يوفر Palgu إكمالات المحادثة وواجهة Responses API على /v1. لا توجد قائمة /v1/models، لذا اكتب اسم النموذج مباشرة في الأداة.
- تعرض صفحة التوجيه النماذج التي يستخدمها فريقك.
مع إضافة Mixture of Models: يتضمن دليل البوابة الخاص بها إعدادات مُختبرة لـ aider وContinue وGoose تتيح لـ Palgu اختيار النموذج لكل طلب.
غير مدعوم أمام Palgu حتى الآن: Windsurf و Gemini CLI و Antigravity. لتشغيل مهمة Palgu على خطة تدفع ثمنها بالفعل (Claude Code و Codex و Kimi Code و OpenCode)، راجع اشتراكاتك الخاصة: تعمل أداة CLI الخاصة بالمزود على جهازك بحسابك المسجل، ولا تمر أبدًا عبر البوابة.
Claude Code وCodex وأدوات أخرى
برمج مع Palgu في palgu، أداة سطر الأوامر الخاصة به، أو في Palgu Studio. لم يعد Palgu يغيّر إعدادات Claude Code أو Codex: فهو لا يكتب في ~/.claude/settings.json ولا في ~/.codex/config.toml، لذا يستمر claude وcodex الخاصان بك في العمل كما ضبطتهما.
Palgu داخل Claude Code
ثبّت Mixture of Models mod مفتوح المصدر. تبقى جلسة Claude Code على اشتراك Claude الخاص بك، وتعمل الأدوار التي يوجّهها الـ mod على نماذج Palgu، وفق سياسة مؤسستك وميزانياتها وتدقيقها. ويمكن للـ mod أيضًا تسليم دور إلى Codex. الإعداد موجود في Mixture of models أدناه.
الربط الذي كتبه إصدار أقدم من Palgu
كان بإمكان إصدار أقدم من Palgu توجيه Claude Code وCodex عبره. يزيل الأمر التالي palgu update أو palgu repair أو palgu login المفاتيح التي كتبها Palgu فقط، ويحتفظ بنسخة احتياطية من الملف ويخبرك بكيفية استعادته. لا تُمَس إعداداتك الخاصة أبدًا. ويعرض palgu clients ما يجده.
توجيه جلسة واحدة، أو إيقاف التوجيه
palgu clients shell # routes only this session; exit to leave palgu disable # new terminals stop routing through Palgu palgu clients disable claude # removes the wiring an older Palgu wrote eval "$(palgu on)" # route this shell in place (off: restore)
فحص سريع للـ API
استبدل النموذج بآخر فعّلته مؤسستك.
source ~/.srooter/config # loads SROOTER_API_KEY (saved by palgu)
curl https://api.palgu.ai/v1/chat/completions \
-H "Authorization: Bearer $SROOTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"<your-model>","messages":[{"role":"user","content":"hello"}]}'
أدوات أخرى
أدوات Cline وRoo Code وKilo Code وContinue وCursor وZed وOpenHands وOpenCode: اختر المزوّد OpenAI Compatible، وعنوان URL الأساسي https://api.palgu.ai/v1، وضع مفتاح srt_ في إعدادات الأداة (وليس في ملف ترفعه إلى المستودع). ولأداة aider:
source ~/.srooter/config # loads SROOTER_API_KEY (saved by palgu)
export OPENAI_API_BASE='https://api.palgu.ai/v1'
export OPENAI_API_KEY="$SROOTER_API_KEY"
aider --model openai/deepseek-pro
الأدوات غير المدعومة أمام Palgu حتى الآن: Windsurf وGemini CLI وAntigravity. مع ذلك، يمكن لـ Palgu تقديم هذه النماذج كواجهات خلفية (backends).
استكشاف الأخطاء وإصلاحها: جلسة لا تمر عبر Palgu
الأعراض: يكتفي الوكيل بوصف التعديلات بدلاً من إجرائها، أو يُظهر سجل التدقيق حركة مرور ضئيلة أو معدومة، أو لا تُطبّق سياساتك. شغّل palgu doctor في تلك الطرفية: سيعرض لك بالضبط ما الذي فشل.
- Claude Code: installed, not routed through Palgu: هذا متوقع. لم يعد Palgu يوجّه Claude Code؛ استخدم palgu، أو Mixture of Models mod داخل Claude Code.
- gateway probe: FAIL (401): مفتاحك غير صالح أو منتهي الصلاحية. شغّل palgu login مجدداً، أو الصق مفتاحاً جديداً باستخدام palgu repair --key-stdin (إدخال مخفي).
- إن وجود غلاف توجيه نماذج محلي يحيل البرمجة إلى أداة CLI أخرى يتعارض مع Palgu؛ لذا أوقف تشغيله في ذلك المستودع. وتعد إضافة mixture-of-models الاستثناء الوحيد، إذ إن الأدوار التي توجهها تمر عبر Palgu بالتصميم.
مزيج النماذج: Claude للأدوار الحرجة، وPalgu للباقي
ألديك اشتراك مدفوع في Claude؟ تُبقي إضافة mixture-of-models مفتوحة المصدر لـ Claude Code جلستك الرئيسية على Claude، وتحيل الأدوار منخفضة المخاطر إلى نماذج أقل تكلفة عبر Palgu. وبذلك تستفيد تلك الأدوار من ميزات التوجيه والميزانيات والسياسات والتدقيق في Palgu، بينما يُخصَّص رصيد استخدامك في Claude للمهام التي تحتاجه فعلاً.
آلية اتخاذ القرار
- يقيّم كل أمر توجيهي. يحدد نطاق التأثير من 1 إلى 10 (حجم الضرر الذي تسببه إجابة خاطئة) ونوع المهمة. يتولى نموذج Ollama محلي التقييم مجاناً، وإلا فيتم عبر Claude Haiku ضمن خطتك.
- يبقي المهام الحرجة على Claude. مهام الأمان، والبنية المعمارية، وحوادث الإنتاج، وكل ما لا يمكن التراجع عنه (بدرجة 8 فأعلى افتراضياً) تعمل في جلستك الرئيسية، تماماً كما كانت من قبل.
- يوجّه الباقي عبر Palgu. يعمل الدور الموجَّه في جلسة Claude Code منفصلة بلا واجهة (headless) تشير بيئتها وحدها إلى Palgu، وذلك على النموذج الذي تختاره استراتيجية التوجيه لديك (التعقيد أو التكلفة أو السرعة أو الجودة أو استراتيجيتك الخاصة؛ يعرضها الأمر /route strategies). ولا يتغير توجيه جلستك الرئيسية أبدًا.
- تراجع آمن عند الفشل. إذا فشلت الجلسة الفرعية، أو أعادت المهمة، أو قدمت ادعاءً غير موثق، أو طلبت منك التدخل، تتولى الجلسة الرئيسية الإجابة عن ذلك الدور بدلاً منها. أما المتابعات مثل "continue" فتعود دائماً إلى الجلسة الرئيسية.
- يعرض مكان تشغيل كل دور. يظهر سطر أسفل كل إجابة يوضح اسم النموذج والدرجة؛ ويعرض الأمر /route stats إحصاءات أدوارك حسب النموذج.
الإعداد مع Palgu
تتطلب الإضافات إصدار Claude Code 2.1.287 أو أحدث. ثبّت الإضافة:
claude --version # 2.1.287 or later; otherwise: claude update
claude plugin marketplace add alinaqi/mixture-of-models-claude-mod
claude plugin install mixture-of-models@mixture-of-models-claude-mod
بعد ذلك، شغّل claude وسجّل الدخول إلى Palgu من داخله. ستعرض الإضافة رابطًا ورمزًا قصيرًا؛ وافق عليه في متصفحك (حيث يختار الحساب الجديد بعد ذلك خطة مدفوعة). يحصل هذا الحاسوب على مفتاحه الخاص، ويكون مدرجًا في صفحة الأجهزة لديك، وتحتفظ به الإضافة في وحدة التخزين الآمنة الخاصة بـ Claude Code.
/palgu login # sign in or sign up, and connect this computer /palgu status # who is signed in, the organisation and its plan /route # where your turns run
مقارنته بالأدوات الأخرى: استخدم Palgu مع أدواتك.
لم يعد Palgu يوجّه جلسة Claude Code الرئيسية إلى بوابة، فلا شيء يلزم التراجع عنه أولًا. إذا كان إصدار أقدم من Palgu قد ربطها، فإن palgu repair يزيل هذا الربط مرة واحدة، مع نسخة احتياطية. المصدر وملاحظات الخصوصية والإعداد الكامل: github.com/alinaqi/mixture-of-models-claude-mod (ترخيص MIT).
اشتراكاتك الخاصة: Claude Code وCodex وKimi Code وOpenCode
هل تدفع بالفعل مقابل خطة برمجة؟ شغّل مهمة Palgu عليها. يشغّل Palgu واجهة سطر الأوامر الخاصة بالمورّد على جهازك، في مجلد المهمة، وبتسجيل دخولك أنت. لا يرى Palgu تسجيل دخولك أو رمزك ولا يخزّنه ولا يمرّره أبدًا، وتتواصل واجهة سطر الأوامر مع مورّدها مباشرة، وليس عبر بوابة Palgu أبدًا. لا تنطبق توجيهات Palgu ومجموعات النماذج والتكلفة لكل رمز على هذا الجزء، لأن خطتك هي التي تدفع وواجهة سطر الأوامر تختار نماذجها.
- Claude Code: palgu --runner claude -p "task". سجّل الدخول مرة واحدة باستخدام claude auth login.
- Codex: palgu --runner codex -p "task". سجّل الدخول مرة واحدة باستخدام codex login.
- Kimi Code: palgu --runner kimi -p "task". سجّل الدخول مرة واحدة باستخدام kimi login.
- OpenCode: palgu --runner opencode -p "task". سجّل الدخول مرة واحدة باستخدام opencode auth login.
palgu runners # what this machine can use: installed, version, login, terms palgu runners --json # the same, for scripts and Palgu Studio palgu --runner auto -p "fix the failing test" # the first one you're logged in to
Cursor: قريبًا بعد اجتياز التحقق من شروط الاستخدام
مشغّل Cursor مدمج، لكنه يبقى معطّلًا إلى أن يؤكد Cursor أنه يجوز لـ Palgu تشغيله بتسجيل دخولك عبر المتصفح. وحتى ذلك الحين، يعرض palgu runners أداة Cursor على أنها معطّلة ويذكر السبب. وعند تفعيله، يشغّل Palgu وضع الطباعة الموثّق في Cursor (cursor-agent -p) مع تفعيل بيئة Cursor المعزولة، فتبقى الأوامر داخل مجلد المهمة، باستخدام تسجيل الدخول عبر المتصفح الذي تجريه بالأمر cursor-agent login. لا يمرّر Palgu أبدًا مفتاح API الخاص بـ Cursor.
OpenCode
OpenCode مفتوح المصدر، والخطة ملك للمزوّد الذي سجّلت الدخول إليه. يشغّله Palgu عندما يكون OpenCode مسجّلًا الدخول إلى ChatGPT Plus/Pro أو GitHub Copilot أو OpenCode Go، إذ يسمح أصحابها باستخدام خططهم في OpenCode. لا تسمح Anthropic باستخدام Claude Pro/Max إلا في تطبيقاتها، لذا إذا كان OpenCode يحمل تسجيل دخول إلى Claude Pro/Max، يعرض palgu runners أن OpenCode معطّل ويذكر السبب. أزل تسجيل الدخول هذا باستخدام opencode auth logout، أو شغّل المهمة على خطة Claude باستخدام palgu --runner claude.
تكون OpenCode معطّلة ما دامت تحتفظ أيضًا بمفتاح API، لأن OpenCode تختار بنفسها أي تسجيل دخول يدفع تكلفة التشغيل: أزل المفتاح باستخدام opencode auth logout. لا تعمل Cursor وOpenCode في CI (عند تعيين CI).
تشغيل Palgu Flow على اشتراكك
يمكن لـ Palgu Flow تشغيل أعمال التنفيذ الخاصة به على خطتك أيضاً. يظل Flow يتولى تخطيط المهمة، وكتابة الاختبارات الفاشلة، وتشغيلها، والتحقق من الملكية والدمج؛ أما الجولات التي تكتب الكود التنفيذي (وتصلحه) فهي وحدها التي تعمل عبر CLI الخاص بك، داخل المجلد المخصص للمسار. يقيّم Flow هذا العمل تماماً كما يقيّم عمله: تغيير أي اختبار، أو تعديل ملفات خارج قائمة المهام، أو إجراء commit يؤدي إلى رفض الجولة. وتبقى الاختبارات والفحوصات والمراجعة والدمج على Palgu.
palgu flow run "add a CSV export" --runner codex palgu flow run "add a CSV export" --runner auto --on-subscription-limit palgu
اجعله الإعداد الافتراضي في ~/.srooter/settings.json، أو لمشروع واحد في .srooter/flow.json: {"flow_roles": {"implementer": {"runner": "codex", "on_subscription_limit": "stop"}}}. يُستخدم ملف المشروع فقط إذا كُتب على جهازك: الملف المتتبَّع عبر git جاء مع المستودع ويتم تجاهله، لذا لا يمكن لأي مستودع استهلاك خطتك. إذا لم تكن أداة CLI مثبّتة أو مسجَّلة الدخول، يوضّح Flow ذلك ويستخدم البوابة. عند نفاد رصيد الخطة، يتوقف التشغيل مؤقتاً حتى يُعاد تعيينها (استأنف عبر palgu flow resume <id>)، أو باستخدام --on-subscription-limit palgu تكمل البوابة التنفيذ. يوضح المسار مكان التشغيل، على سبيل المثال "implementing on codex (your subscription)".
عندما تنفد الخطة، تتوقف المهمة وتعرض وقت إعادة التعيين. مع --on-subscription-limit palgu، يُكمل Palgu المهمة عبر البوابة بدلًا من ذلك ويُعلمك بذلك. يمكن لمؤسستك إيقاف مشغّلات الاشتراكات في سياستها.
بناء تطبيق على Palgu
يمكن لتطبيقك استخدام Palgu كمفتاح وحيد له: يسجل المستخدمون دخولهم باستخدام Palgu، ويوافقون على تطبيقك مرة واحدة، فيستدعي تطبيقك البوابة بمفتاح يقتصر على ما وافقوا عليه فقط. وتُطبَّق ميزانيات مؤسستهم وسياساتها وسجل التدقيق الخاص بها، ويمكنهم إلغاء صلاحية تطبيقك في أي وقت. يعمل كل من Mixture of Models وideavalidator بهذه الطريقة.
1. تسجيل تطبيقك
يسجّل مسؤول المؤسسة التطبيق في صفحة تطبيقاتك ضمن قواعد الفريق، أو عبر POST /admin/org-apps. التطبيق الذي تسجّله يعمل داخل مؤسستك فقط: لا يمكن الموافقة عليه إلا من قِبل أعضائها، ويظهر للآخرين على أنه غير متاح. أما التطبيق المخصّص لكل مؤسسات Palgu فيسجّله مسؤولو Palgu. وأنت تحدّد:
- معرّف العميل: يتكوّن من 3 إلى 32 محرفًا من الحروف a-z والأرقام 0-9 والشرطة (-)، مثل acme-notes. يجب أن يكون المعرّف فريدًا على مستوى Palgu ولا يمكن تغييره لاحقًا. تُرفض المعرّفات التي تبدأ باسم محجوز (palgu، واسم منتجنا السابق، وstudio، وclaude، وanthropic، وopenai، وchatgpt، وcodex، وgemini، وgoogle، وgrok، وxai، وmicrosoft، وgithub، وcursor، وmcp).
- الاسم والناشر: ما يراه المستخدمون على شاشة الموافقة، مثل "Allow Acme Notes by Acme Ltd".
- الصفحة الرئيسية والمستودع والأيقونة: روابط https فقط.
- نطاقات الصلاحية (Scopes): ما يحتاجه تطبيقك من الجدول أدناه. اطلب أقل عدد ممكن منها.
- عام أو سرّي: التطبيق الذي يعمل على أجهزة المستخدمين يكون عاماً (Public) ولا يحصل على مفتاح سرّي. أما التطبيق الذي يعمل من جهة الخادم فيمكن أن يكون سرّياً (Confidential) ويحصل على مفتاح سرّي للعميل (Client secret).
تبدأ التطبيقات الجديدة بحالة unverified: تحذّر شاشة الموافقة المستخدمين وتطلب منهم التأكيد مرتين. كما يظهر على تطبيقات مؤسستك الخاصة تنبيه "مسجّل بواسطة مؤسستك" وتبقى دائماً غير موثّقة؛ إذ لا توثّق Palgu إلا التطبيقات التي تسجّلها للجميع. يمكن للمؤسسة امتلاك 20 تطبيقاً غير ملغى، وتسجيل ما يصل إلى 10 تطبيقات في الساعة.
2. اختيار نطاقات الصلاحية (Scopes)
لا يمكن للمفتاح الذي يتلقاه تطبيقك الوصول إلا إلى نقاط النهاية المحددة في نطاقات صلاحياته. أي مسار آخر يردّ بالرمز 403 مع "error": "insufficient_scope" ونطاق الصلاحية المطلوب، ويضيف Palgu نقاط النهاية الجديدة إلى القائمة بشكل صريح.
v1:chatإرسال طلبات المحادثة إلى النماذج. /v1/chat/completions, /v1/responses, /anthropic/*, POST /v1/pricing/quotev1:researchإجراء بحث ويب مسنَد بالمصادر. /v1/researchcouncilاستشارة مجلس النماذج. /v1/council/*imagesتوليد الصور. محجوز: لا توجد نقطة نهاية بعدprofile:readالاطلاع على اسمك وبريدك الإلكتروني ومؤسستك. GET /meيمكن لأي مفتاح تسجيل خروجه ذاتياً عبر DELETE /me/devices/current.
3. تسجيل دخول المستخدمين عبر تدفق الأجهزة (Device flow)
- أرسل طلباً إلى POST /auth/device/code مع client_id الخاص بك وكائن device (يتضمن name وos وarch وclient_version ومعرّف install_id عشوائي يظل ثابتاً لهذا التثبيت). ستحصل على user_code وverification_uri_complete وinterval.
- اعرض الرمز وافتح الرابط. يسجل المستخدم دخوله عبر palgu.ai/connect، ويرى تطبيقك وناشره ونطاقات صلاحياته، ثم يختار السماح.
- استعلم دورياً عبر POST /auth/token كل interval ثانية. القيمة authorization_pending تعني الاستمرار في الانتظار، وslow_down تعني إضافة 5 ثوانٍ إلى الفترة، بينما تعني access_denied أو expired_token التوقف. ويرسل التطبيق السرّي أيضاً المعامل client_secret.
- تتضمن الاستجابة access_token (وهو مفتاح srt_ خاص بهذا التثبيت)، ونطاق الصلاحية الممنوح scope، وعنوان URL للبوابة، ومؤسسة المستخدم. احفظ المفتاح في سلسلة مفاتيح نظام التشغيل، ولا تضعه أبداً في ملف ترفعه إلى المستودع.
أي معرّف client_id غير معروف أو معلّق أو ملغى يحصل على invalid_client. اترك scope فارغاً للحصول على كل نطاق مسجّل لتطبيقك، أو أرسل scope مفصولاً بمسافات يمثّل مجموعة فرعية منها (على سبيل المثال، تسجيل دخول للقراءة فقط باستخدام profile:read)؛ وعندئذٍ تعرض شاشة الموافقة هذه النطاقات فقط. طلب نطاق لم يُسجَّل به تطبيقك يعيد invalid_scope. وإذا أزال المسؤول ما طلبته قبل أن تستلم المفتاح، فإن الاستطلاع يجيب بـ access_denied: ابدأ تسجيل الدخول من جديد.
البدء السريع: Python
import time, uuid, requests
GW, APP = 'https://api.palgu.ai', 'your-client-id'
device = {'name': 'my-laptop', 'os': 'macOS', 'arch': 'arm64',
'client_version': '0.1.0', 'install_id': str(uuid.uuid4())}
start = requests.post(f'{GW}/auth/device/code',
json={'client_id': APP, 'device': device}).json()
print('Open', start['verification_uri_complete'], 'and approve', start['user_code'])
interval = start['interval']
while True:
time.sleep(interval)
r = requests.post(f'{GW}/auth/token', json={
'grant_type': 'urn:ietf:params:oauth:grant-type:device_code',
'client_id': APP, 'device_code': start['device_code']})
body = r.json()
if r.ok:
break
if body['error'] == 'slow_down':
interval += 5
elif body['error'] != 'authorization_pending':
raise SystemExit(body['error']) # access_denied, expired_token
key = body['access_token'] # store it in the OS keychain
reply = requests.post(f'{GW}/v1/chat/completions',
headers={'Authorization': f'Bearer {key}'},
json={'model': 'glm-5.3',
'messages': [{'role': 'user', 'content': 'hello'}]})
print(reply.json()['choices'][0]['message']['content'])
البدء السريع: TypeScript
const GW = 'https://api.palgu.ai', APP = 'your-client-id'
const post = (path: string, body: object) =>
fetch(GW + path, { method: 'POST', headers: { 'content-type': 'application/json' },
body: JSON.stringify(body) })
const device = { name: 'my-laptop', os: 'macOS', arch: 'arm64',
client_version: '0.1.0', install_id: crypto.randomUUID() }
const start = await (await post('/auth/device/code', { client_id: APP, device })).json()
console.log('Open', start.verification_uri_complete, 'and approve', start.user_code)
let interval = start.interval, key = ''
while (!key) {
await new Promise((r) => setTimeout(r, interval * 1000))
const res = await post('/auth/token', { client_id: APP, device_code: start.device_code,
grant_type: 'urn:ietf:params:oauth:grant-type:device_code' })
const body = await res.json()
if (res.ok) key = body.access_token // keep it in the OS keychain
else if (body.error === 'slow_down') interval += 5
else if (body.error !== 'authorization_pending') throw new Error(body.error)
}
const res = await fetch(GW + '/v1/research', { method: 'POST',
headers: { authorization: 'Bearer ' + key, 'content-type': 'application/json' },
body: JSON.stringify({ query: 'Who sells usage-based billing for AI apps?' }) })
console.log((await res.json()).sources)
4. استدعاء البوابة (Gateway)
- المحادثة (v1:chat): POST /v1/chat/completions المتوافق مع OpenAI، أو /anthropic/v1/messages. يوجّه Palgu كل طلب إلى نموذج تسمح به المؤسسة.
- تثبيت نموذج: أرسل الترويسة x-srooter-pin: <model> للحصول على ذلك النموذج تحديداً بدلاً من التوجيه التلقائي. إذا كانت سياسة المؤسسة لا تسمح به، فستحصل على خطأ 403، ولن يُستبدل بنموذج آخر أبداً.
- البحث (v1:research): إرسال POST /v1/research مع {"query": "..."} يعيد إجابة مرفقة بمصادرها.
- المجلس (Council) (council): يستشير المسار POST /v1/council/deliberate عدة نماذج ويعيد حكم كل نموذج بالإضافة إلى خلاصة رئيس المجلس.
- هوية المستخدم المسجّل (profile:read): GET /me.
حدود معدل الطلبات والميزانيات
يُحتسب كل طلب ضمن استهلاك مؤسسة المستخدم: تنطبق ميزانيتها وحدود معدل الطلبات الخاصة بها على تطبيقك كما تنطبق على أي شيء آخر، ويرى مسؤولوها طلبات تطبيقك وإنفاقه في بند مستقل (GET /admin/apps/usage). المؤسسة التي ينفد رصيدها تحصل على 402 مع billing_error؛ والطلبات الزائدة تحصل على 429 مع Retry-After. تراجع عن الإرسال، واعرض الرسالة للمستخدم، ولا تكرر المحاولة في حلقة متقاربة.
يمكن للمؤسسة أيضاً فرض قيود خاصة بتطبيقك: عدد محدد من الطلبات في الدقيقة وميزانية شهرية، لتلك المؤسسة فقط. عند تجاوز معدل الطلبات، يتلقى تطبيقك 429 مع code: app_rate_limited وRetry-After. وعند تجاوز الميزانية، يتلقى 402 billing_error مع reason: app_budget حتى الشهر التالي أو حتى يرفع المسؤول الحد الأقصى: ولا يتم تقديم أي بديل. يتضمن كلا الخطأين رابط docs يشير إلى هذا القسم.
إلغاء الصلاحية
- يمكن للمستخدم إلغاء صلاحية تطبيقك من صفحة التطبيقات المصرّح لها لديه. يؤدي ذلك إلى تسجيل خروج التطبيق من كل جهاز يستخدمه عليه.
- يمكن لمسؤول المؤسسة حظر تطبيقك على مستوى المؤسسة بأكملها. تتوقف مفاتيحه فوراً وتُرفض أي عمليات تسجيل دخول جديدة هناك.
- يمكن لـ Palgu تعليق أي تطبيق أو إلغاء صلاحيته لجميع المستخدمين.
في كل حالة، يبدأ مفتاحك بالرد بالرمز 401 خلال ثوانٍ. تعامل مع الرمز 401 باعتباره تسجيل خروج: احذف المفتاح المخزّن واعرض على المستخدم تسجيل الدخول مجدداً.
أمثلة تطبيقية
- Mixture of Models (معرّف العميل client_id mixture-of-models، النطاقات scopes v1:chat profile:read routing:read council work:read tickets:read memory:read): تعديل لأداة Claude Code يسجّل الدخول عبر تدفّق الجهاز (device flow)، ثم يرسل أدواره الموجهة إلى /anthropic ويسعّر كل واحد منها عبر /v1/pricing/quote.
- ideavalidator (معرّف العميل client_id ideavalidator، النطاقات scopes v1:chat v1:research profile:read): يسجّل الدخول بالطريقة نفسها، ثم يستدعي /v1/research لإجراء أبحاث سوق موثّقة بالمصادر و/v1/chat/completions مع مخطط JSON لكل مرحلة.
مرجع واجهة برمجة تطبيقات السجل (Registry API)
يُسجَّل كل تغيير في سجل التدقيق. يُعاد سر العميل (client secret) مرة واحدة فقط عند الإنشاء أو التدوير، وتحتفظ Palgu بقيمته المجزأة (hash) فقط. تتطلب مسارات org-apps جلسة لوحة تحكم لمسؤول المؤسسة والترويسة x-csrf-token (من GET /admin/csrf)؛ أما مسارات المنصة فهي مخصّصة لكبار مسؤولي Palgu.
GET /admin/org-apps # org admins: your organization's apps POST /admin/org-apps # register; "confidential": true for a secret PATCH /admin/org-apps/{id} # edit name, publisher, links, scopes POST /admin/org-apps/{id}/status # {"status": "active" | "suspended" | "revoked"} POST /admin/org-apps/{id}/rotate-secret # a new secret; the old one stops now GET /admin/platform/apps # every app POST /admin/platform/apps # register; "confidential": true for a secret PATCH /admin/platform/apps/{id} # edit name, publisher, links, scopes, verified POST /admin/platform/apps/{id}/status # {"status": "active" | "suspended" | "revoked"} POST /admin/platform/apps/{id}/rotate-secret # a new secret; the old one stops now GET /admin/apps/{id}/org-control # org admins: this org's block PUT /admin/apps/{id}/org-control # {"blocked": true} signs the app out of the org GET /admin/apps/usage # org admins: requests and spend per app GET /me/apps DELETE /me/apps/{id} # a user's authorised apps, and revoke
ما الجديد
يوليو 2026 · نموذج جديد
نموذج Kimi K3 (kimi-k3) الرائد من Moonshot متاح الآن للتوجيه
2.8T معلمة، وسياق يصل إلى 1M، وفهم بصري أصيل. في اختبارنا القياسي لبناء الوكلاء، حقق نتيجة 8/8 مع 5/5 في إتقان واجهة المستخدم، معادلاً بذلك Opus و Fable و GPT-5.6-sol. واستخدم أقل عدد من التكرارات بتكلفة ~$3.60/build: أي نصف تكلفة Opus وثلث تكلفة Fable. ومن بين النماذج التسعة التي خضعت للاختبار، يُعد النموذج الأقل تكلفة الذي يحقق 5/5 في تقييم واجهة المستخدم. اطّلع على الاختبار القياسي ←
Palgu Studio، تطبيق سطح المكتب
تطبيق palgu> Studio هو تطبيق macOS للبرمجة عبر Palgu. لا يتطلب أي تعديلات على بيئة العمل، ويعتمد التطوير القائم على الاختبار (TDD) مع التحقق الوظيفي والبصري افتراضيا، ويزود الوكيل بالرسم البياني للكود لتوفير سياق المشروع. يمر كل طلب عبر البوابة (التوجيه، الميزانيات، السياسات، والتدقيق). التطبيق موقع وموثق لمعالجات Apple Silicon وIntel.
↓ تنزيل لنظام Mac
كل شيء في نافذة واحدة
- المهام حدد مشروعاً، وصف ما تريده؛ وسيتولى وكيل تنفيذ المهمة عبر محادثة حية، مع بث تقدمه لحظياً وطلب الإذن قبل عمليات الكتابة وأوامر الطرفية (shell). شغّل عدة مهام بالتوازي (ضمن شجرة عمل مشتركة أو شجرة عمل معزولة worktree).
- الجلسات جلسات الوكيل السابقة مصنفة حسب اليوم؛ استأنف أي جلسة من حيث توقفت.
- المعرفة الرسم البياني للكود Cortex بالإضافة إلى سجلات جلسات Mnemos. يُفهرَس الرسم البياني عند فتح مشروع، ليبدأ الوكيل بخريطة واضحة للكود. يمكنك تحديث Agent Codemap من هنا أيضاً.
- المجلس (Council) تراجع خمسة نماذج التغيير وفق معايير SOLID و C4 و OWASP وهرم الاختبار (Test Pyramid). يمكنك الاطلاع على نتائجها واختلافاتها، والاعتراض على أي نتيجة.
- المراجعات الصق رابط PR من GitHub (أو راجع الفروق المحلية لديك) للحصول على مراجعة موثوقة من المجلس.
- التوجيه اطّلع على النموذج الذي يوجّه إليه كل مستوى والسبب وراء ذلك (للقراءة فقط؛ التعديل متاح عبر لوحة التحكم على الويب).


هل أنت جديد هنا؟ نزّل Studio أو أدوات CLI، ثم سجّل الدخول: يصحبك دليل البدء داخل التطبيق خطوة بخطوة لإنجاز مهمتك الأولى.
واجهة سطر أوامر البرمجة palgu
شغّل palgu لفتح جلسة برمجة في مشروعك، أو palgu -p "…" لتنفيذ مهمة واحدة والخروج. وهو يحل محل claude أو codex في سير عملك. يتصل وكيل البرمجة ببوابة Palgu الخاصة بك فقط، لذا فإن التوجيه والميزانيات والسياسات والتدقيق وcortex تُطبّق على كل طلب. يتحقق palgu من الوكيل مقابل إصدار موقّع قبل كل تشغيل، ويحدثه الأمر palgu update.
palgu # interactive session in this directory palgu -p "summarize src/index.ts" # one task, then exit (CI-friendly) palgu --continue # continue your last session palgu resume [<id>] # continue a paused task (the newest, or <id>; a Flow run id resumes that run) palgu --fast "<task>" # speed mode: the quick profile, checkpoints kept (/fast in a session) palgu --continue-claude # pick up a Claude Code session (--continue-codex: Codex) palgu code [--] <args…> # pass any other agent flag through unchanged palgu review [base] [--yes] # council review; exit 0 approve, 1 changes requested palgu doctor # check the agent, clients and your key
لا يتم أبداً تخمين الكلمات غير المعروفة كأمر توجيهي (prompt): يتوقف الأمر palgu fix the test ويقترح palgu code -p "fix the test". يعرض palgu help الأوامر اليومية، ويعرض palgu help all كل الأوامر، ويقبل كل أمر الخيار --help. تُقرأ الإعدادات من الخيارات (flags)، ثم من متغيرات البيئة (SROOTER_URL وSROOTER_MODEL وSROOTER_PROJECT لمشروع cortex المعتمد كمرجع)، ثم من الملف ~/.srooter/config الذي ينشئه الأمر login.
الأذونات: تعمل أدوات القراءة فقط دائماً؛ بينما تطلب أدوات الكتابة والطرفية (shell) الموافقة أثناء الجلسة ([y] مرة واحدة، [a] دائماً، [n] رفض). وفي التشغيل غير التفاعلي، تُرفض هذه الأدوات ما لم تمرر الخيار --dangerously-allow-all.
وضع السرعة
وضع السرعة مخصص للأعمال الصغيرة منخفضة المخاطر التي تريد إنجازها بسرعة: نموذج أولي أو صفحة أو إصلاح. أضف --fast إلى الأمر الذي تستخدمه أصلًا. لا توجد مصطلحات flow لتتعلمها، والصيغة القديمة palgu flow run --speed-mode "…" لا تزال تعمل.
palgu --fast "add a footer"مهمة واحدة في وضع السرعة ثم الخروج. --speed هو العلم نفسه.palgu -p --fast "fix the date format"الأمر نفسه كتشغيل واحد بلا واجهة (السكربتات وCI).palgu --fastجلسة تفاعلية تعمل مهامها في وضع السرعة./fast [on|off]داخل الجلسة: بدّل وضع السرعة للمهام التالية (بدون وسيط يتم التبديل).palgu resume <flow id>متابعة تشغيل سريع متوقف مؤقتًا (المعرّف في سطر الإيقاف).ما الذي يتغير
- الملف السريع: تمر المهمة بأقل عدد من الخطوات التي لا تزال تبنيها بالاختبارات أولًا، ضمن ميزانية 15 دقيقة (لا يُحتسب وقت انتظارك عند نقطة تحقق).
- نقاط التحقق باقية: في الطرفية يتوقف التشغيل لك عند نقطة التحقق من المواصفات ونقطة التحقق من الخطة. لا يشغّل وضع السرعة الطيار الآلي أبدًا؛ ويتبع تشغيل -p غير التفاعلي القواعد المعتادة (تقرر ذلك السياسة الموقّعة لمؤسستك).
- لا تجاوز للضوابط: يبقى للعمل عالي المخاطر (المصادقة والمدفوعات والبيانات وعمليات النشر) وللحد الأدنى لمؤسستك الأولوية. عندها يقول Palgu speed mode off: high risk (…) أو speed mode off: org minimum standard ويستخدم الملف الأكثر أمانًا.
- الفحص الفاشل يوقف التشغيل مؤقتًا ولا يُفشله: يذكر سطر الإيقاف الخطوة التالية، مثل palgu resume f-20261105-a1b2c3.
مجموعة النماذج المطبقة
يذكر كل تشغيل سريع مجموعة النماذج التي تخدمه، مثل ⚡ speed mode · model group: Speed-first، في البداية وفي ملخص التشغيل، ويذكرها سطر flow roles أيضًا. المجموعة هي مجموعة مشروعك، وإلا فمجموعة فريقك، وإلا فمجموعة مؤسستك، كما هو محدد في Routing؛ وmodel group: none (custom routing) تعني أن التوجيه لا يطابق مجموعة واحدة. لأسرع تشغيل اجمع وضع السرعة مع مجموعة Speed-first.
لتبديل المجموعة لمشروعك، اكتب /group (أو اضغط Ctrl+G) داخل الجلسة. في Studio، استخدم زر Models بجوار زر التشغيل، مثل Models: Cost-first.
المهام من AWG
AWG، أي Agentic Work Graph، قائمة مهام مشتركة بين وكلاء البرمجة والأشخاص: لكل مهمة حالة ومعايير قبول واعتماديات ومسار ومن يتولاها والدليل الذي يثبت إنجازها. إنها قائمة مهام Palgu: يعرض Palgu مهامك على الويب وفي Studio وفي الطرفية، ولا يكتب إليها سوى تشغيلات Flow.
AWG مستضاف، مفعّل افتراضيًا: مساحة عمل واحدة لكل مشروع
تحصل كل مؤسسة على Palgu على AWG مستضاف تديره Palgu، دون أي إعداد: لا خطوة للمسؤول، ولا رمز مميز للصقه، ولا شاشة لربط AWG. يحصل كل مشروع Palgu على مساحة عمل AWG خاصة به، تُنشأ تلقائيًا في أول مرة يُنشأ فيها المشروع أو يُفتح، في Studio (macOS وWindows) أو palgu أو Flow. فتح المشروع مرة أخرى لا ينشئ مساحة ثانية أبدًا، وتحصل المشاريع الحالية على مساحاتها أيضًا. أثناء إنشاء مساحة العمل، تعرض مهام المشروع جارٍ الإعداد ويستمر المشروع في العمل محليًا؛ وإذا كان AWG متوقفًا، تنشئها Palgu لاحقًا. تسجّل Palgu الدخول إلى كل مساحة عمل لكل شخص باستخدام تسجيل دخوله إلى Palgu وبأضيق صلاحية تحتاجها طريقة العرض، لذا يفقد العضو الذي أُزيل من المؤسسة الوصول إلى مهامها.
تعرض الإعدادات، التكاملات، المهام عبارة المهام: AWG المستضاف (افتراضي) وتسرد مساحة عمل كل مشروع مع حالتها وفتح في AWG؛ وتلك التي تعذّر إنشاؤها تحتوي على إعادة المحاولة. لا تخزّن Palgu سوى المعرّفات التي تربط المشروع بمساحة عمله، ولا تخزّن أي رمز مميز أبدًا.
استخدم AWG الخاص بك (مستضاف ذاتيًا، لمسؤولي المؤسسة)
فقط لمؤسسة تشغّل AWG الخاص بها. يفتح مسؤول المؤسسة استخدم AWG الخاص بك في الإعدادات، التكاملات، المهام؛ ثم يقرأ Palgu المهام منه بدلًا من AWG المستضاف. يرى الأعضاء أي AWG قيد الاستخدام؛ ولا يغيّره إلا المسؤولون.
- الرمز: في AWG، أنشئ رمزًا على مستوى مساحة العمل من النوع reviewer، وهو أدنى صلاحية يتيحها AWG. يرفض Palgu أي رمز يستطيع الكتابة في AWG أو حجز المهام أو إدارته، لأنه يقرأ فقط.
- أدخل عنوان AWG (https، على الإنترنت العام) ومساحة العمل والرمز، ثم Test connection: تُجرى كل الفحوص ولا يُحفظ شيء. Connect يحفظ الاتصال فقط عندما تنجح كل الفحوص.
- Link projects: اختر مشروع AWG لكل مشروع في Palgu. يقترح Palgu روابط حيث تتطابق المستودعات.
- لاحقًا: Test connection مرة أخرى، أو Rotate token، أو Disconnect (تبقى روابط المشاريع؛ ألغِ الرمز في AWG أيضًا).
الصق الرمز فقط في حقل كلمة المرور في البطاقة، وليس أبدًا في محادثة أو مشكلة (issue) أو في المساعد. تخزّنه البوابة مشفرًا ولا تعرض إلا آخر 4 أحرف منه.
أين تظهر المهام
تقرأ كل واجهة المهام نفسها عبر البوابة، فلا يحمل أي حاسوب محمول أو متصفح رمز AWG، وتبدأ كل واجهة بالمهام التي تحتاجك.
- الويب: Tasks في لوحة التحكم: الأعداد، ثم Needs you، ثم Board أو List أو Tracks. افتح مهمة لترى معايير القبول والاعتماديات والفحوص مع أدلتها وعمليات التسليم ودليل الإنجاز.
- Palgu Studio (macOS وWindows): المهام في الشريط الجانبي لكل مشروع، والمهام في صفحة المشروع، وبطاقة المهام في Mission Control.
- الطرفية:
palgu tasks listمهام هذا المشروع: الحالة والمعرّف والعنوان والمسار ومن يحتفظ بها والدليل. تأتي المهام التي تحتاجك أولًا.palgu tasks show <ID>مهمة واحدة: معايير القبول والاعتماديات والفحوص والأدلة وآخر تسليم.palgu tasks lanesالمسارات المسماة والمسارات المتوازية التي يحسبها AWG.palgu tasks summaryالأعداد حسب الحالة، والجاهزة للحجز، والجارية، والتي تحتاجك.يُعرض دليل الإنجاز بالشكل نفسه في كل مكان: Verified done وDone (no proof required) وChecks passed وProof pending وCheck failed وProof is for an older commit وNeeds review. يقرر AWG متى تكتمل المهمة؛ ويعرض Palgu ذلك.
Flow على AWG
مفعّل افتراضيًا على AWG المستضاف. أوقفه لتشغيل واحد بـ PALGU_AWG=0، أو لمشروع بـ {"awg.enabled": false} في .srooter/settings.json. يكتب تشغيل Flow مهام خطته في AWG، ويحجز كل مهمة قبل بنائها (فلا تُبنى مهمة مرتين)، وينشر أدلة الاختبار والتحقق والأدلة المرئية. على AWG المستضاف يسجّل الدخول بتسجيل دخولك إلى Palgu؛ وعلى AWG الخاص بك يستخدم بيانات اعتماد وكيل AWG الخاصة بك، وليس رمز المراجع الخاص بالمؤسسة أبدًا. عندما يتعذر الوصول إلى AWG يستمر البناء وتُعاد الكتابات لاحقًا.
عندما لا توجد مهام لعرضها
العرض الذي لا يستطيع إظهار المهام يذكر السبب في سطر واحد، وليس كخطأ أبدًا:
No tasks yet: start a task and Palgu tracks it hereAWG المستضاف: لم يُتتبَّع أي شيء لهذا المشروع بعد. ابدأ مهمة أو تشغيل Flow.Tasks need AWG. An org admin can link your own AWG in Settings → Integrationsلا يملك هذا البوابة AWG مستضافًا، ولا تملك مؤسستك AWG خاصًا بها.This project's tasks are being set upAWG المستضاف: جارٍ إنشاء مساحة العمل لهذا المشروع. يعمل المشروع محليًا في هذه الأثناء، وتظهر المهام من تلقاء نفسها.This project isn't linked to AWG yetAWG مستضاف على بوابة لا تنشئ بعد مساحة عمل لكل مشروع. تحتفظ عمليات Flow بمهامها محليًا حتى ذلك الحين.Tasks are pausedلم يقبل AWG المستضاف تسجيل دخولك إلى Palgu. سجّل الدخول إلى Palgu مرة أخرى؛ وإذا تكرر ذلك، فتواصل مع الدعم.This project isn't linked to an AWG project yetلـ AWG الخاص بك فقط: يربطه مسؤول المؤسسة من ربط المشاريع.Tasks are paused until an admin reconnects AWGلـ AWG الخاص بك فقط: رفض الرمز المحفوظ. يستبدله مسؤول المؤسسة.Tasks aren't enabled on this gatewayتعمل هذه البوابة بدون Tasks.الانتقال من Conductor Cloud: النقل إلى الجهاز المحلي (Transfer to local)
تتحول مساحة عمل Conductor Cloud إلى مساحة عمل Palgu مستضافة: تنتقل مهامها ومساراتها وإثباتاتها إلى مساحة عمل AWG المستضافة الخاصة بمؤسستك، ومعرفتها البرمجية إلى cortex، ومستودعها وإعداداتها وأعضاؤها إلى مشروع Palgu. يمكنك عرضها عبر الويب وفي Studio وفي الطرفية.
أين يعمل الوكلاء: لا يقدّم Palgu حاليًا حوسبة مستضافة للوكلاء (مثل الأجهزة السحابية في Conductor). يعمل وكلاؤك على جهاز Mac أو PC الخاص بك، مع تسجيل الدخول إلى حسابك في Claude Code أو Codex أو OpenCode (Cursor: قريبًا بعد اجتياز التحقق من شروط الاستخدام)، بينما تكون الحالة مستضافة. لا يحتفظ Palgu أبدًا برمز اشتراك، ولا يتوسط في تمريره أو يعيد استخدامه.
- 1. التصدير من Conductor. قبل أن يتحول Conductor Cloud إلى وضع القراءة فقط، انقر بزر الماوس الأيمن على كل مساحة عمل واختر Transfer to local، أو استخدم Settings → Account → Export data لتصدير كل شيء. احتفظ بملف الأرشيف.
- 2. تثبيت Palgu على جهاز Mac أو PC. استخدم Palgu Studio (لنظامي macOS و Windows) أو واجهة الأوامر palgu CLI. سجّل الدخول إلى Claude Code أو Codex أو OpenCode كما تفعل اليوم: تعمل المهام على اشتراكك الخاص. Cursor: قريبًا بعد اجتياز التحقق من شروط الاستخدام.
- 3. استيراد الأرشيف. يعرض الأمر palgu import conductor --archive <export.zip> --json > import.json ما عثر عليه ولا يغيّر شيئًا حتى تقوم بتطبيقه.
- 4. إنشاء مساحة العمل المستضافة (غير متاح بعد). عندما يسرد الاستيراد مساحات عمل Conductor Cloud الخاصة بك، يعرض palgu hosted create --from import.json ما سيُنشئه، ويُنشئ --yes مشروع Palgu ومساحة عمل AWG المستضافة الخاصة به. وعند تشغيله في نسختك المحلية من المستودع (أو مع --repo <dir>) يضيف أيضًا مهمة لكل مهمة من مهام Conductor، ولا يُنشئ تشغيله مرة أخرى أي شيء مرتين. هذا الإصدار من palgu import conductor --archive لا يسردها بعد، لذا لا يُنشئ شيئًا حاليًا.
- 5. فهرسة الكود. تشغيل palgu memory index . داخل المستودع يضع المعرفة البرمجية الخاصة به في cortex لتكون متاحة لجميع أعضاء الفريق.
- 6. التحقق من النتيجة. يعرض الأمر palgu hosted كل مساحة عمل مستوردة: المشروع، ومساحة عمل AWG، والمهام في AWG وفي cortex. وتعرض واجهة الويب البيانات نفسها ضمن Settings, Integrations, Tasks.
يتم إرسال المعرّفات وعناوين المهام والفروع وروابط طلبات السحب (pull requests) والأعداد فقط إلى Palgu. تبقى المحادثات كسجل للقراءة فقط على جهازك؛ ولا يتم رفع نصوصها أبدًا. ينضم الأعضاء عبر مؤسستك في Palgu، وليس من ملف التصدير.
الوكلاء: تابعهم مباشرةً
يظهر كل وكيل يشغّله Palgu (الوكيل الرئيسي للجلسة، والوكلاء الذين يبدؤهم، والمسارات والخيوط) في عرض واحد، مجمّعًا بالطريقة نفسها في كل مكان: Needs you وWorking وReady وDone. لكل صف علامة وكلمة لحالته (لا اللون وحده)، وما هو، والنموذج الذي يعمل عليه، وتكلفته مع الوكلاء الذين بدأهم، وما يفعله.
○ queuedينتظر البدء، مع السبب (الذاكرة أو السعة أو الميزانية أو حد المؤسسة).● workingيعمل الآن.▲ needs youينتظرك: سؤال، أو ميزانية نفدت، أو فشل، أو لا تحديث منذ وقت طويل.‖ pausedأوقفته مؤقتًا، أو توقّف مع الوكيل الذي بدأه.◦ idleانتهى دوره؛ النتيجة جاهزة للمراجعة أو الدمج. أو ينتظر خطة أو شحن الرصيد، مع رابط لشحن الرصيد أو لاختيار خطة.✓ done · ✗ failed · ■ stoppedانتهى. الوكيل الذي فشل يذكر السبب بكلمات واضحة، مع إعادة المحاولة.أين يظهر الوكلاء
- الطرفية: palgu agents على هذا الحاسوب، حيث يمكنك الاطلاع والرد والإيقاف والإيقاف المؤقت والاستئناف ورفع الميزانية. palgu agents --all-devices يعرض كل الأجهزة.
- Palgu Studio (macOS وWindows): الوكلاء في Mission Control، مع الإجراءات نفسها للوكلاء على هذا الحاسوب.
- الويب: تعرض صفحة Agents في لوحة التحكم وكلاءك على كل جهاز، للقراءة فقط: صفِّها (s:needs_you، a:reviewer، d: الجهاز، p: المشروع) وافتح أحدها لتفاصيله. يرى مسؤول المؤسسة وكلاء المؤسسة ومالك كل منهم.
توقِف الوكيل أو توقفه مؤقتًا أو تراسله على الحاسوب الذي يشغّله، في Palgu أو Palgu Studio. لا تحتفظ البوابة إلا بالحالات والأرقام والنموذج وملخص من سطر واحد بعد إزالة الأسرار، إضافةً إلى الجهاز واسم مجلد المشروع. لا يغادر ذلك الحاسوبَ النصُّ الكامل ولا رسائلك ولا نص التقارير ولا التسميات ولا التثبيتات.
الانتقال من Conductor
افتح مستودع Conductor في Palgu وسيعمل كما كان: السكربتات نفسها والمتغيرات نفسها والمنافذ نفسها (عشرة منافذ لكل worktree). ثم انقل مساحات عملك بأمر واحد يعرض تشغيلًا تجريبيًا أولًا. القصة والمواعيد والمقارنة في الانتقال من Conductor.
palgu import conductor --dry-runتشغيل تجريبي (وهو الافتراضي): كل تغيير سيجريه الاستيراد، دون إجراء أي منها.palgu import conductor --applyينفّذها. شغّله مرة أخرى ولن يكون لديه ما يفعله.palgu import conductor --path ~/code/appمستودع واحد، أينما كانت أشجار العمل الخاصة به.palgu import conductor --archive export.zipأرشيف Settings → Account → Export data من Conductor: تصبح المحادثات سجلَّ مهام للقراءة فقط.palgu workspace run [<action>]إجراء تشغيل من .conductor/settings.toml، في هذه الطرفية (الإجراء الافتراضي إن لم تذكر اسمًا).palgu workspace setup | archive | actions | envإعادة الإعداد، الأرشفة، قائمة الإجراءات، والمتغيرات التي يحصل عليها السكربت.إعداداتك تعمل كما هي
- قراءة مباشرة: .conductor/settings.toml (مع settings.local.toml فوقه) أو conductor.json الأقدم. الإعداد وإجراءات التشغيل المسماة والأرشفة وrun_mode وenvironment_variables.
- المتغيرات نفسها: CONDUCTOR_WORKSPACE_PATH وCONDUCTOR_ROOT_PATH وCONDUCTOR_WORKSPACE_NAME وCONDUCTOR_PORT، أول 10 منافذ محجوزة لكل شجرة عمل، إضافةً إلى نظائرها PALGU_*. وتحصل عليها صدفة الوكيل أيضًا.
- الملفات المنسوخة: .worktreeinclude، وإلا فأنماطك، وإلا .env*، إلى كل شجرة عمل جديدة؛ ولا يُستبدل أبدًا ملف موجود فيها.
- وضع التشغيل: مع run_mode = "nonconcurrent"، يؤدي بدء إجراء إلى إيقاف الإجراء الذي يعمل في شجرة عمل أخرى أولًا.
ما يفعله الاستيراد
- تصبح كل شجرة عمل مهمةً في مكانها، على فرعها. لا يُنقل شيء، وتبقى التغييرات غير المُثبتة كما هي.
- الملاحظات وطلبات الدمج: تصبح ملاحظات .context في شجرة العمل تسليمَ المهمة، وتُقرأ أولًا عند استئنافها؛ ويُربط طلب الدمج المفتوح عند تسجيل الدخول إلى gh.
- MCP ومتغيرات البيئة: يُقرأ .mcp.json ومتغيرات البيئة من مكانها؛ ولا يُنسخ شيء.
- الأسرار: تُحفظ القيم في settings.local.toml في سلسلة مفاتيح macOS أو في مدير بيانات الاعتماد في Windows كأسرار للمشروع، ولا تُكتب في ملف أبدًا. تحدد قواعد Studio ما يصل منها إلى المهام: السر الذي يبدو سرًا للإنتاج (اسم فيه LIVE أو PROD، أو مفتاح حي) ينتظر حتى تصنّفه. على Linux يعرضها الاستيراد لتضيفها في Studio.
- آمن: لا يحذف أبدًا بيانات Conductor أو مساحات العمل لديك ولا يغيّرها، ولا يلمس أبدًا إعدادات Claude Code أو Codex. تطبيقه مرة أخرى لا يغيّر شيئًا.
الوكلاء والأوضاع
- اشتراكك الخاص: يعمل كل وكيل عبر أداة سطر الأوامر (CLI) الخاصة به، مع تسجيل الدخول على جهازك. يعرض الأمر palgu runners الوكلاء المتاحين على هذا الجهاز، ويشغّل الأمر palgu --runner claude -p "..." مهمة على أحدهم.
- التعليمات والأدوات: تُقرأ ملفات CLAUDE.md وAGENTS.md والمهارات و.mcp.json كما هي.
- محادثات Conductor: تابِع جلسة Claude Code أو Codex باستخدام palgu --continue-claude أو palgu --continue-codex.
مرجع الأوامر
أوامر الشرطة المائلة (داخل الجلسة)
/helpعرض قائمة بجميع الأوامر./model [id]عرض النموذج النشط أو تبديله./contextاستهلاك الرموز (tokens) والإنفاق لهذه الجلسة./configعرض البوابة والمفتاح والنموذج المعتمدين./doctorالتحقق من إمكانية الوصول إلى البوابة وصلاحية مفتاحك./clearمسح نص المحادثة المعروض على الشاشة./cortex البحث في الرسم البياني لكود مؤسستك عبر البوابة./review [base]إرسال فروق الفرع (diff) إلى مجلس المراجعة متعدد النماذج./loop تشغيل مهمة ذاتياً، مقيدة بنبضات التحقق (heartbeat-bounded)./monitorالجلسات المحلية، إجمالي الرموز، الإنفاق، وعدد المهام المجدولة./schedule …إضافة (add) / عرض (list) / إزالة (rm) الأوامر المجدولة عبر cron./workflow تشغيل سير عمل JSON متعدد الخطوات (الخطوات كوكلاء فرعيين).الخيارات (بعد palgu code)
--continueاستئناف أحدث جلسة.--model اختر النموذج لهذا التشغيل.--gateway تجاوز عنوان URL الخاص بالبوابة.--pinتشغيل النموذج المطلوب حرفياً (تخطي التوجيه)، للاختبارات القياسية.--max-turns تعيين حد أقصى للأدوار المستقلة.--dangerously-allow-allتخطي مطالبات الأذونات (للتشغيل غير المراقب / CI).الاستقلالية والتنسيق
- /loop <task> يشغّل مهمة ذاتياً. بعد كل دورة، يقرر نبض البوابة ما إذا كان الوكيل قد توقف قبل الأوان ويجب أن يستمر، فيحقن توجيهه كدورة تالية. تفرض البوابة ميزانية لكل جلسة وحداً أقصى يبلغ 25 تكراراً.
- الوكلاء الفرعيون يمكن للنموذج استدعاء run_subagent لتفويض مهمة فرعية مركزة إلى وكيل فرعي جديد: بسياق مستقل، ونفس الأدوات، ومستوى واحد من التداخل (دون استدعاء ذاتي متكرر). يعمل الوكيل الفرعي بشكل غير تفاعلي، لذا لا تعمل الأدوات ذات التأثيرات الجانبية إلا إذا منح الوكيل الأصلي إذن السماح للكل (allow-all). استخدم الوكلاء الفرعيين للبحث المركز أو المهام المستقلة.
- MCP (مفعّل افتراضياً) اضبط الخوادم في ~/.srooter/mcp.json (للمستخدم) و .mcp.json (للمشروع). تُحمَّل أدواتها تلقائياً بصيغة server__tool، وتخضع لضوابط الأذونات مثل أي أداة كتابة. يُسجَّل الخادم المعطل في السجلات ويُتخطى، ولا يؤدي أبداً إلى إيقاف النظام.
العمليات والجدولة وسير العمل
palgu code monitor # sessions, token totals, spend, scheduled count palgu code schedule # fire any due scheduled tasks once (cron tick) palgu code schedule run # foreground scheduler: tick every minute palgu code workflow wf.json # run a multi-step workflow
- /schedule add <m h dom mon dow> :: <prompt> · list · rm <id>. تُخزَّن في ~/.srooter/agent/schedule.json؛ شغّلها باستخدام schedule (نبضة واحدة، تُربط مع cron النظام) أو schedule run (في الواجهة الأمامية).
- /workflow <file> ملف JSON للخطوات بصيغة { name, steps: [{ id, prompt, dependsOn? }] }. تُنفَّذ الخطوات حسب ترتيب الاعتمادية (تُنفَّذ الخطوات المستقلة في المستوى نفسه بالتوازي)؛ ويمكن لمطالبة أي خطوة الإشارة إلى مخرجات خطوة سابقة باستخدام {{stepId}}. تعمل كل خطوة كوكيل فرعي.
Cortex والمراجعة
- Cortex يمكن للنموذج استدعاء أداة search_cortex التي تستعلم عن الرسم البياني للكود الخاص بمؤسستك عبر البوابة، ليرتكز على رموز برمجية حقيقية بدلاً من الاكتفاء ببحث grep المحلي. يشغّله الأمر /cortex <query> مباشرة. يتطلب مشروعاً مفهرساً (SROOTER_PROJECT).
- المراجعة يرسل الأمر palgu review [base]، أو /review داخل جلسة، فرعك المعتمد (بدءاً من نقطة الدمج الأساسية مع origin/<default branch>، أو الأساس الذي تحدده) إلى مجلس المراجعة متعدد النماذج في البوابة، ويطبع الحكم النهائي مع النتائج موضحة بصيغة file:line. ويعرض قائمة بالملفات وحجمها بالبايت ويطلب تأكيدك قبل الإرسال. لا تُرسل ملفات .env* و *.pem و *.key و *secret* و id_rsa* مطلقاً، ويُحدَّد سقف الفروق (diff) عند 120,000 حرف. يقرأ المجلس الفروق فقط ولا يشغّل الكود الخاص بك. راجع مراجعة Palgu.
قواعد التوجيه
يصنّف Palgu كل طلب ضمن مستوى (tier) ويوجهه إلى النموذج المعيّن لذلك المستوى. يمكنك ضبط هذه التعيينات في لوحة التحكم. الإعدادات الافتراضية:
trivialرسائل الـ commits، والتنسيق، والمهام الروتينية → cerebras (سريع ومنخفض التكلفة).substantiveطبقة البرمجة الرئيسية → glm (الخيار العملي للمهام اليومية).long_contextالمحادثات التي تتجاوز حد الرموز (الافتراضي 60k) ← glm.thinkطلبات التفكير الموسّع الصريحة → deepseek-pro.architecture / securityالمقاصد عالية الحساسية ← رئيس المجلس (claude-opus).عدّلها في لوحة التحكم لديك ضمن النماذج والتوجيه: اختر النموذج لكل طبقة، ونموذج تصنيف المقاصد، وأعضاء المجلس، وعتبة السياق الطويل. تقيّم المعاينة الفورية إعداداتك من حيث السرعة والتكلفة والجودة ومتوسط التكلفة المدمج لكل $/1k رمز (token)، مع مقارنة مرجعية مقابل تشغيل نموذج رائد واحد لكل المهام. تسري التغييرات على الطلبات الجديدة، ويمكنك استعادة إعدادات Palgu الافتراضية في أي وقت. أما الحدود القصوى الصارمة (قوائم النماذج المسموح بها، وأقصى جهد للاستدلال، وطبقة السرعة) فتوجد ضمن النماذج والتوجيه ← قواعد النماذج.
الرسم البياني للكود في Cortex
Cortex هو iCPG (رسم بياني ذكي لخصائص الكود)، ويمثّل معرفة مؤسستك بكودها الخاص: الرموز، وروابط الاعتماديات، والمقاصد المستخلصة من سلاسل التوثيق (docstrings). وبمجرد فهرسة المستودع، تجيب جلسات البرمجة عن أسئلة «أين يوجد X» مباشرة من الرسم البياني، وتستخدمه جلسات البرمجة ومراجعات المخاطر لمعرفة ما يتأثر بأي تغيير.
palgu memory index . # index this repo (project auto-detected) palgu memory index . --force # force a re-index palgu doctor # check your setup
بعد فهرسة المستودع، تحافظ جلسات البرمجة في palgu على تحديث فهرسه. لم يعد Palgu يضيف خطاف فهرسة تلقائية إلى Claude Code.
تصفّحه في لوحة التحكم لديك ضمن الذاكرة: اعثر على مشروع، واطرح الأسئلة لتحصل على إجابات موثّقة بمصادرها، واستكشف البنية المعمارية مستوى تلو الآخر (الوحدات، والملفات، والرموز)، واقرأ الغاية الكامنة وراء الكود (سبب وجوده، سواء أكان مسجّلاً أم مستنتجاً، مع المصادر).
Codemap للوكيل
ملف CODEMAP.md هو خريطة موجّهة للآلة يقرؤها وكيل الذكاء الاصطناعي أولاً لاستكشاف المستودع: ماهية النظام، وأين تقع المكوّنات، وكيف يتدفق الطلب، والثوابت التي يجب عدم كسرها، بدلاً من استهلاك عشرات استدعاءات الأدوات في تصفح شجرة الملفات. فبينما يمنح AGENTS.md وCLAUDE.md الوكيل القواعد، يمنحه Codemap الخريطة. يولّده Palgu من الرسم البياني للكود لديك، ويكشف الخيار --check أي خريطة قديمة. وهو مكتوب بصيغة Markdown عادية، لذا يمكن لأي وكيل قراءته (Claude Code، وCodex، وCursor، وWindsurf، وOpenCode).
palgu memory codemap . # preview a fresh map (stdout) palgu memory codemap . --write # write / refresh CODEMAP.md palgu memory codemap . --check # validate anchors + freshness (exit 1 on error) # also: /codemap in a Palgu session, Studio Knowledge Refresh CODEMAP.md
يتولى المولّد إدارة الأقسام الحتمية (البنية المعمارية، خريطة الوحدات، مناطق الخطر) ويصوغ الباقي مع مؤشرات ثقة لتقوم أنت بمراجعتها وتنقيحها. يتحكم الخيار --check في عمليات الكتابة ويعمل عند بدء الجلسة، مما يضمن رصد أي خريطة قديمة أو معطوبة وعدم الوثوق بها بصمت أبداً. راجع ADR-067.
المهارات
تدمج المهارات ممارساتك الهندسية في النموذج، حسب الغرض. يأتي Palgu مزوداً بأربع مهارات افتراضية:
tdd-enforcerمنهجية TDD صارمة: RED ثم GREEN ثم VALIDATE، بحد أدنى 80% لتغطية الاختبارات.security-baselineلا أسرار مضمّنة في الكود، استعلامات مُعلَّمة، استخدام bcrypt/argon2، والتحقق من المدخلات.quality-gatesالحد الأقصى 20 سطراً/دالة، 3 معلمات، مستويان من التداخل، 200 سطر/ملف.python-conventionsتلميحات الأنواع (Type hints)، و Pydantic، و pytest، و ruff مع mypy، و pathlib.التوجيه المدرك للمهارات: للمهام التي تُنفَّذ من مرة واحدة مثل العروض التقديمية أو لوحات المعلومات أو صفحات الهبوط أو المستندات المتقنة، يمكن للتوجيه إضافة مهارة مطابقة وترقية النموذج لهذا الطلب تحديداً. حدد مهاراتك الخاصة على مستوى المؤسسة (الاسم، التوجيه، المقاصد، الإلزام المرن أو الصارم، الأولوية) في قسم المعايير والمهارات، ومهاراتك الشخصية المبنية فوق سياسة المؤسسة دون تجاوز الحوكمة أبداً ضمن مهاراتي في الصفحة نفسها.
ذاكرة الجلسة
Mnemos هي الذاكرة العاملة في Palgu لكل جلسة برمجة. بالنسبة لحركة البيانات بصيغة Anthropic، تسجّل الطلب الافتتاحي للجلسة، والملفات التي عدّلتها أو كتبتها، وأخطاء الأدوات، وتنشئ لها نقاط حفظ كلما طالت الجلسة. وهي اليوم سجلّ متاح لك لفحصه، ولا يُعاد إدراج محتواها في طلبات وكلائك.
افحصها في لوحة التحكم لديك ضمن Sessions → Memory: الجلسات مع أحدث نقطة حفظ لها (الهدف، والقيود النشطة، ودرجة الإجهاد) والعُقد المصنّفة (Goal · Constraint · Error · Decision · Result).
مراجعات المخاطر
ترصد مراجعات المخاطر التغييرات التي تمس الجوانب الحساسة: المصادقة، ونطاق المستأجرين (tenant scoping)، والأسرار. يقيّم نموذج حراسة سريع كل تغيير بشكل مستقل عن المسار الرئيسي؛ وعندما تكون النتيجة مرتفعة، يفحص نموذج مراجعة متقدم (claude-opus) النهج المتبع ويضيف توجيهات تصحيحية إلى الدور التالي للوكيل. لا تعيق مراجعات المخاطر عمل المطور.
راجع الأحداث في لوحة التحكم ضمن قسم المراجعات الأمنية: يعرض كل حدث مستوى الخطورة، والنتائج (الأبعاد التي تفعّلت مع الأدلة)، والتوجيهات التصحيحية، وأزراراً لتحديد النتيجة (مؤكد / حادثة / مستبعد / بسيط) ليتكيف الحد الفاصل مع قاعدة الكود الخاصة بك.
سجّل حسابك وابدأ البرمجة
سجّل باستخدام رمز يصلك عبر البريد الإلكتروني وستُنشأ مؤسستك. بعد ذلك شغّل palgu login، وسيحصل كل طلب على سجل تدقيق. راجع الخصوصية لمعرفة ما يتم تخزينه ومدة الاحتفاظ به.
ابدأ الآن →