# جهز الـ coding agent

أعط Claude Code أو Codex أو Cursor كل ما يلزمه لكي ينشر عنك: الـ CLI، والقواعد، والصفحات التي يقرؤها.

## التجهيز

1. [ثبت الـ CLI وسجل الدخول](/ar/docs/install-the-cli) حيث يعمل الـ agent.

   يستعمل الـ agent تسجيل دخولك.
2. أضف [ملفات الـ agent](/ar/docs/harness) إلى الـ repo الخاص بك، لكي يقرأ الـ agent هذه القواعد في كل مرة.
3. دع الـ agent يتعلم كل الأوامر والـ flags من [مرجع الـ CLI](/ar/docs/cli)، أو بنداء واحد في الـ [CLI](/ar/docs/install-the-cli):

   ```sh
   ghaym help all --json
   ```

## قواعد للـ agents

- **سجل الدخول عبر صاحب الحساب.** يستعمل الـ CLI تسجيل دخول من يشغله. إذا فشل `ghaym whoami`، فاطلب منه أن يشغل `ghaym login` في التيرمينال الخاص به، ولا تطلب منه أبدا أن يلصق مفتاحا في المحادثة.
- **استعمل الـ CLI، لا نداءات API تكتبها بيدك.**
- **الـ push يبدأ النشر.** الـ push على الـ branch الذي تتابعه الخدمة يبنيها وينشرها. ولا ينجح النشر إلا عندما يقول سجل البناء ذلك.
- **استمع على كل العناوين، وعلى الـ port الذي يحدده غيم.** اربط التطبيق على `0.0.0.0` لا على localhost، واقرأ الـ port من `PORT`. وإلا فلن يصل فحص الجاهزية إلى التطبيق ويفشل النشر.
- **كل تغيير ينتظر حتى يطبق.** المتغيرات وإعدادات البناء والحجم والنسخ والتوزيع والوصول تبقى [تغييرات مجهزة](/ar/docs/staged-changes) حتى `ghaym cloud changes apply`، أو `--apply` على الأمر الذي جهزها. وتطبيق تغيير على متغير أو على ربط مخزن أو على الـ branch أو على إعداد بناء ينشر الخدمة.
- **جرب التغيير أولا.** كل أمر يغير شيئا يأخذ `--dry-run`، ولا يغير عندها شيئا. أوامر `services create` و`domains add` و`sessions rollback` تعيد الخطة مع سعرها الشهري التقريبي؛ والباقي يطبع الطلب الذي كان سيرسله.
- **تعتمد الأسعار على الموقع.** اقرأها بالأمر `ghaym cloud regions sizes <region>`.
- **الطلبات المتتالية تبقي الخدمة مستيقظة.** الخدمات خارج الـ production [تنام](/ar/docs/sleep) عندما لا يصلها شيء، ولا يحسب الـ compute إلا وهي مستيقظة.
- **الترافيك الخارج الذي يتجاوز الكمية الشهرية مدفوع**.
- **التسجيل يحتاج إلى شخص.** والنشر يفتح بعد أن تعتمد غيم الحساب.

## أي أمر لأي مهمة

- **نشر الكود:** `ghaym cloud projects create`، ثم `ghaym cloud services create --project <project> --type git --repo <owner/name> --size <size> --site <slug>`، ثم push على الـ branch الذي تتابعه الخدمة، كما تقول صفحة [انشر أول خدمة](/ar/docs/getting-started). `ghaym cloud regions list` يعرض المواقع.
- **تجربة تغيير بعيد عن الـ production:** `ghaym cloud environments create` مع branch خاص بها، ثم push على هذا الـ branch.
- **معرفة سبب فشل البناء:** `ghaym cloud deployments logs <id>`، لا نتيجة الـ push.
- **تغيير الإعدادات:** `ghaym cloud vars set`. لا تحفظ في الـ repo ملف إعدادات فيه قيم.
- **انتظار موافقة أحد:** الأمر الذي يحتاج إلى موافقة يخرج بالرمز `6` ومعه رقم الموافقة. شغل `ghaym cloud approvals wait <id>` بدلا من إعادة المحاولة.
- **معرفة ما حدث:** `ghaym cloud audit list` و `ghaym cloud sessions list`، مع `--json`.

## صفحات يقرؤها الـ agent

- [/docs/errors](/ar/docs/errors): صفحة لكل نوع خطأ في الـ API. رابط `docs` في الخطأ يشير إلى هنا.
- [/docs/verified-prompts](/ar/docs/verified-prompts): prompts تجهز repo موجودا للنشر.
- [/llms.txt](/llms.txt): فهرس موقع غيم بصيغة llms.txt.
- كل صفحة تحت `/docs` موجودة أيضا بصيغة Markdown: أضف `.md` إلى المسار، مثل [/docs/agents.md](/docs/agents.md).
- أضف `?lng=en` إلى أي رابط لتحصل على النسخة الإنجليزية. ومن دونه، تظهر الصفحات بالعربية.
