ورقة غش Google Antigravity CLI (agy): الأوامر والإعدادات

Antigravity CLI (agy) هو وكيل برمجة خفيف ومكتوب بلغة Go وأصلي للطرفية من Google ضمن منصة Antigravity 2.0. صُمم agy لتنفيذ الوكلاء الفرعيين المتوازي، وعزل مسارات العمل عبر Git worktree، ومهارات الوكلاء (Agent Skills)، والإضافات، وتكاملات MCP، ليحل محل أداة Gemini CLI الاستهلاكية.

تغطي ورقة الغش هذه خيارات وأوامر agy الفرعية، والأوامر المائلة التفاعلية، واختصارات لوحة المفاتيح، وإعدادات .agents/ وmcp_config.json، وخطوات الترحيل من Gemini CLI.

🔗 أوراق غش ذات صلة: مقارنة أدوات وكلاء البرمجة في الطرفية · ورقة غش Claude Code CLI · ورقة غش OpenAI Codex CLI · ورقة غش بنية مهارات الوكلاء (AI Agent Skills)

1. التثبيت والأوامر الفرعية وخيارات التشغيل

1.1 التثبيت والتشغيل

# تثبيت Antigravity CLI
curl -fsSL https://antigravity.google/cli/install.sh | bash

# تشغيل واجهة TUI التفاعلية (اتبع تعليمات المصادقة على الشاشة عند أول تشغيل)
agy

1.2 الأوامر الفرعية الأساسية وخيارات بدء التشغيل

الأمر / الخيار	الوصف	مثال استخدام
`agy`	تشغيل واجهة TUI التفاعلية في مساحة العمل النشطة	`agy`
`agy -p "<prompt>"`	تشغيل غير تفاعلي (headless) يطبع المخرجات إلى stdout ويخرج	`agy -p "Summarize the last 5 commits"`
`agy -i "<prompt>"`	بدء جلسة تفاعلية مزودة بمطالبة ابتدائية مسبقًا	`agy -i "Refactor auth middleware under src/auth"`
`agy -c`, `--continue`	استئناف أحدث جلسة محادثة	`agy -c`
`agy --conversation <id>`	تحميل محادثة تاريخية محددة عبر المعرف	`agy --conversation 42a506e6-...`
`--mode <mode>`	تحديد وضع أذونات التنفيذ: `default` · `accept-edits` · `auto` (موافقة تلقائية معزولة) · `plan`	`agy --mode accept-edits`
`--model <model>`	تجاوز النموذج النشط لهذه الجلسة	`agy --model gemini-3.8-flash`
`--effort <level>`	ضبط جهد الاستدلال (`low` حتى `max`، حسب النموذج)	`agy --effort high`
`--agent <agent>`	إرفاق ملف تعريف وكيل مخصص عند بدء التشغيل	`agy --agent reviewer`
`--add-dir <path>`	منح سياق مساحة العمل وصولًا لمجلد إضافي (قابل للتكرار)	`agy --add-dir ../shared-types`
`agy models` / `agy agents`	سرد النماذج المتاحة أو الوكلاء المخصصين المضبوطين	`agy models`
`agy plugin <subcmd>`	إدارة الإضافات: `install` · `list` · `validate --strict` · `import gemini`	`agy plugin validate --strict ./my-plugin`

2. الأوامر المائلة التفاعلية في TUI

اكتب / داخل agy لاستدعاء الأوامر المدمجة وإكمالها تلقائيًا:

2.1 التحكم العام والجلسات والسجل

الأمر	الوظيفة	ملاحظات واستخدام
`?` / `/help`	سرد جميع الأوامر المائلة واختصارات لوحة المفاتيح المتاحة	مرجع سريع داخل الجلسة
`/config` / `/settings`	فتح نافذة الإعدادات التفاعلية بملء الشاشة	تعديل التفضيلات والسمات والأذونات (`settings.json`)
`/clear`	مسح مخزن المطالبة النشط وبدء جلسة جديدة	الانتقال بنظافة إلى مهمة غير مرتبطة
`/compact`	ضغط سجل المحادثة وتلخيصه	استعادة مساحة في نافذة السياق أثناء التشغيل الطويل
`/resume`	فتح منتقي المحادثات لاستعادة الجلسات السابقة	متابعة مسارات العمل المتوقفة
`/rewind` / `/undo`	التراجع خطوة للخلف عبر جولات المحادثة	عكس الجولات أو المسارات غير الصحيحة
`/fork`	تفريع المحادثة عند نقطة الحفظ الحالية	استكشاف فروع مساحة عمل متوازية بأمان
`/exit` / `/quit`	إنهاء جلسة `agy` CLI	أو اضغط `Ctrl + D Ctrl + D`

2.2 النماذج وسير العمل والوكلاء والإضافات

الأمر	الوظيفة	ملاحظات واستخدام
`/model`	تبديل نموذج الذكاء الاصطناعي النشط أثناء الجلسة	الموازنة بين السرعة والتكلفة مقابل قوة الاستدلال
`/effort`	فحص أو ضبط جهد الاستدلال (`low` إلى `max`)	ملاحظة: `agy -p "/effort"` يعرض مخرجات JSON للقراءة فقط
`/plan`	توليد خطة خطوة بخطوة قبل تعديل الملفات	بوابة أمان قبل التغييرات المعمارية الكبيرة
`/goal`	التشغيل ذاتيًا حتى الاكتمال دون توقف في منتصف المهمة	مناسب للمهام طويلة الأمد
`/grill-me`	إجراء مقابلة متطلبات تفاعلية قبل كتابة الشيفرة	توضيح الحالات الحدية ومعايير القبول مسبقًا
`/agent`	التبديل إلى ملفات تعريف وكلاء مخصصين أو استدعاؤهم	يحمل التعريفات من `.agents/agents/`
`/worktree`	إنشاء أو إدارة مجلدات Git worktree معزولة	العمل على فروع متوازية دون تلويث الشجرة الرئيسية
`/mcp`	فحص حالة اتصال MCP الحية والسجلات وإعادة تحميل الإعدادات	استكشاف أخطاء خوادم MCP المحلية أو البعيدة
`/plugin`	تصفح إضافات السوق أو تفعيلها أو تعطيلها أو فحصها	إدارة المهارات والقواعد والخطافات وخوادم MCP المجمعة
`/voice`	تبديل وضع الإدخال بالإملاء الصوتي	الاختصار المكافئ: `F5`

3. اختصارات الطرفية وصياغة الإدخال

الاختصار / الصياغة	الإجراء	التأثير والسيناريو
`@<path>`	الإكمال التلقائي لمسارات الملفات	حقن مسارات ملفات أو مجلدات محددة في السياق
`!<command>`	التنفيذ المضمن في الطرفية	ابدأ بالرمز `!` لتنفيذ أوامر Shell مباشرة (مثل `!npm run build`)
`Ctrl + G`	فتح المحرر الخارجي	كتابة مطالبات طويلة أو متعددة الأسطر في محررك الافتراضي (Vim، VS Code)
`Esc Esc`	مسح مربع المطالبة النشط	مسح الإدخال المعلق عندما لا يكون هناك بث نشط
`F5`	تبديل الإملاء الصوتي	مكافئ للأمر `/voice`
`Ctrl + D Ctrl + D`	إنهاء الجلسة	الضغط مرتين على `Ctrl + D` للخروج بسلاسة

4. التسلسل الهرمي للإعدادات وملف `mcp_config.json`

4.1 خريطة المجلدات الشاملة مقابل مجلدات مساحة العمل

الطبقة	النطاق الشامل (كل مساحات العمل)	نطاق مساحة العمل (محلي للمشروع)	الغرض
إعدادات CLI	`~/.gemini/antigravity-cli/settings.json`	—	تفضيلات CLI والسمة والمحرر والأذونات الافتراضية
اختصارات المفاتيح	`~/.gemini/antigravity-cli/keybindings.json`	—	تعيينات لوحة المفاتيح المخصصة للطرفية
تعليمات المشروع	`~/.gemini/AGENTS.md` أو `GEMINI.md`	`./AGENTS.md` أو `./GEMINI.md`	أعراف المستودع الدائمة وأوامر البناء والاختبار والشخصية
القواعد الدائمة	`~/.gemini/config/rules/*.md`	`.agents/rules/*.md`	قيود خلفية تُحقن تلقائيًا في السياق
مهارات الوكيل (Skills)	`~/.gemini/config/skills/<name>/SKILL.md`	`.agents/skills/<name>/SKILL.md`	حزم Agent Skills المعيارية مع السكربتات والموارد
إعدادات MCP	`~/.gemini/config/mcp_config.json`	`.agents/mcp_config.json`	تعريفات خوادم MCP المحلية عبر stdio والبعيدة عبر HTTP

⚠️ تغيير جوهري في مخطط MCP البعيد (serverUrl): في ملف mcp_config.json، يجب أن تستخدم خوادم MCP البعيدة عبر HTTP المفتاح serverUrl بدلًا من المفاتيح القديمة url أو httpUrl—فاستخدام url يسبب فشل اتصال صامتًا.

{
  "mcpServers": {
    "remote-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "local-tool": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.example.com/mcp"]
    }
  }
}

5. الترحيل من Gemini CLI القديم إلى `agy`

انتهت الفئة المجانية الاستهلاكية وطلبات Google AI Pro/Ultra على Gemini CLI في 18 يونيو 2026 (مع الإبقاء فقط على Gemini Code Assist للمؤسسات ومسارات مفاتيح API المقاسة). أهم تحويلات الترحيل إلى agy:

المكون	Gemini CLI القديم	Antigravity CLI (`agy`)	إجراء الترحيل
بيئة التشغيل والبرنامج	TypeScript مفتوح المصدر (`gemini`)	CLI متعدد الوكلاء بلغة Go (`agy`)	بدّل الاستدعاءات إلى `agy`؛ يعمل التهيئة التلقائية عند التشغيل
الامتدادات (Extensions)	امتدادات Gemini CLI	إضافات Antigravity الأصلية	شغل `agy plugin import gemini` لتحويلها واستيرادها
ملفات التعليمات	`GEMINI.md`	`GEMINI.md` و`AGENTS.md`	متوافق تمامًا—يعمل ملف `GEMINI.md` الحالي كما هو
مسار المهارات المحلي	`.gemini/skills/`	`.agents/skills/`	انقل مجلدات المهارات إلى `.agents/skills/<name>/SKILL.md`
سير العمل القديم	`.agents/workflows/`	مُرحَّل إلى Agent Skills	حوّل ملفات سير العمل المفردة إلى `.agents/skills/` (`/migrate-workflows`)
إعدادات ومفاتيح MCP	مضمنة في `settings.json` باستخدام `url`	ملف `mcp_config.json` مستقل باستخدام `serverUrl`	افصل كتل MCP إلى `mcp_config.json` وأعد تسمية `url` إلى `serverUrl`