Google Antigravity Remote Control: كيفية التحكم في الوكيل من هاتفك

إذا لم تثبّت Antigravity بعد، فابدأ بنظرة عامة على ما هو Google Antigravity وكيفية تثبيته. هذا الدليل مخصص للحالات التي يتولى فيها وكيل مهمة طويلة (إعادة هيكلة، أو تشغيل اختبارات، أو ترحيل تبعيات) وتحتاج فيها إلى الابتعاد عن مكتبك مع الحفاظ على التحكم في الجلسة.

ما هو Remote Control ولماذا تحتاج إليه؟#

Remote Control ميزة في Google Antigravity تتيح لك الاتصال بأمان بجلسات سطح المكتب وCLI على أجهزتك والتحكم فيها من أي متصفح ويب. وفقًا للوصف الرسمي، قد تستغرق المهام الكبيرة وقتًا طويلًا، مثل إعادة هيكلة نظام فرعي كامل، أو تشغيل اختبار طويل، أو ترحيل تبعيات معقد. يتيح لك Remote Control إدارة الجلسة أثناء ابتعادك عن الكمبيوتر مع إبقاء بيئة التطوير بأكملها محلية.

تعمل الميزة في كل من تطبيق سطح المكتب 2.0 وCLI، وهو إصدار Antigravity في الطرفية (agy)، لكن طريقة تفعيلها وسلوكها يختلفان في كل منهما.

تفعيل Remote Control في Antigravity 2.0 لسطح المكتب#

يمكنك تفعيل Remote Control من إعدادات التطبيق:

1. افتح لوحة Settings باستخدام Cmd + , (أو Ctrl + , في Linux وWindows)، أو انقر زر Settings أسفل اللوحة اليسرى.
2. انتقل إلى قسم App.
3. بدّل Enable Remote Control إلى On.
4. (اختياري) عيّن Nickname، مثل workstation-primary أو server-machine، لتتمكن من تمييز هذا الجهاز بسهولة في قائمة الأجهزة المتصلة.

الاتصال من هاتف أو متصفح آخر

لفتح جلسة عن بُعد:

1. افتح متصفحًا على أي جهاز وانتقل إلى لوحة تحكم Antigravity Remote Control. ويمكنك أيضًا تثبيت تطبيق الويب على الشاشة الرئيسية في الهاتف لتلقي إشعارات فورية عند انتهاء الوكيل من مهمة أو طلبه ردًا منك.
2. سجّل الدخول باستخدام حساب Google نفسه الذي تستخدمه على سطح المكتب.
3. اختر الجهاز المطلوب من مبدّل الأجهزة.
4. بعد الاتصال، يمكنك رؤية المحادثات النشطة، وبدء مهام جديدة للوكيل، وعرض خطط التنفيذ والمواد الناتجة.

إذا لم يظهر الجهاز في واجهة الويب، فتوصي التعليمات الرسمية بالتحقق من ثلاثة أمور: أن مفتاح Enable Remote Control مفعّل على الكمبيوتر الذي يعمل عليه Antigravity؛ وأن الكمبيوتر متصل بالإنترنت ولم يدخل في وضع السكون؛ وأن تطبيق سطح المكتب والمتصفح يستخدمان حساب Google نفسه.

إذا انقطع اتصال الشبكة مؤقتًا على الجهاز الذي تستخدمه للاتصال، فستحاول واجهة الويب إعادة الاتصال تلقائيًا. وتستمر مهام الوكيل في الخلفية والأوامر التي شُغّلت من الطرفية على الكمبيوتر الذي يعمل عليه Antigravity من دون انقطاع، ما دام متصلًا بالإنترنت.

وضعا Remote Control في Antigravity CLI#

يتضمن CLI وضعين: وضعًا تفاعليًا مرتبطًا بعملية طرفية محددة، وبرنامجًا خفيًا في الخلفية دون واجهة يعمل من دون طرفية مفتوحة.

الوضع التفاعلي: /remote-control

يمكنك تفعيل Remote Control في جلسة agy التفاعلية الحالية من دون إعادة تشغيل CLI. نفّذ الأمر في سطر الإدخال:

/remote-control

وفقًا للوصف الرسمي، يفتح CLI اتصالًا — نفقًا عكسيًا — للجلسة الحالية، ويطبع اسم المضيف ورابطًا للمحادثة النشطة كي تفتحها من جهاز آخر:

Remote control on for this session.
Hostname: devbox-swift-falcon
Open https://antigravity.google.com/r/<instance-id>?p=c%2F<conversation-id> on another device to continue this conversation.

افتح هذا الرابط في متصفح على كمبيوتر محمول أو جهاز لوحي أو هاتف، وسجّل الدخول باستخدام حساب Google نفسه الذي تستخدمه في CLI، ثم واصل العمل في الجلسة من خلال واجهة Antigravity على الويب.

لتعطيل النفق من دون إنهاء جلسة الطرفية المحلية:

/remote-control off

يمكنك بدء CLI مع تفعيل Remote Control مسبقًا باستخدام خيار عند التشغيل:

agy --remote-control

يرتبط الوضع التفاعلي بعملية agy: عند الخروج من CLI (/exit أو Ctrl+C أو Ctrl+D) أو إغلاق نافذة الطرفية، ينتهي نفق Remote Control تلقائيًا ويختفي إدخال الجلسة من لوحة التحكم. لكل عملية CLI تفاعلية معرّف جلسة واسم مضيف خاصان بها، لذا يمكنك تشغيل agy --remote-control في الوقت نفسه ضمن عدة علامات تبويب طرفية أو أدلة عمل.

عند الاتصال بجلسة CLI تفاعلية من متصفح، تتم مزامنة الجانبين في الوقت الفعلي. تنتقل الطلبات من الجهاز البعيد مباشرة إلى الطرفية المحلية، بينما يظهر استدلال الوكيل واستدعاءاته للأدوات وتغييرات الشيفرة في الواجهة البعيدة. إذا توقف الوكيل لطلب التأكيد (y/n) أو طرح سؤال متابعة، فيمكنك الرد من هاتفك أو الطرفية المحلية. الإعدادات هي الاستثناء: لا يمكنك تغييرها من واجهة الويب البعيدة، بل من CLI نفسه فقط.

البرنامج الخفي دون واجهة: agy remote-control start

الوضع الثاني هو برنامج خفي دائم في الخلفية يُسجَّل كخدمة لنظام التشغيل. يتوفر ما دام الكمبيوتر قيد التشغيل ومتصلًا بالإنترنت؛ ويعتمد سلوكه بعد تسجيل الخروج وإعادة التشغيل على النظام الأساسي.

agy remote-control start

يسجّل البرنامج الخفي نفسه كخدمة لنظام التشغيل (خدمة systemd للمستخدم في Linux، أو LaunchAgent في macOS، أو مهمة مجدولة في Windows) ويبدأ فورًا من دون الحاجة إلى نافذة طرفية مفتوحة.

استخدم agy remote-control status لمعرفة اسم الإدخال. ثم اختر هذا الكمبيوتر من لوحة تحكم Antigravity Remote Control وواصل العمل عبر واجهة Antigravity على الويب.

تتحكم ثلاثة أوامر في البرنامج الخفي:

agy remote-control start     تسجيل البرنامج الخفي وبدؤه
agy remote-control status    عرض حالة البرنامج الخفي واسم مثيله
agy remote-control stop      إيقاف البرنامج الخفي وإلغاء تسجيله

يستخدم البرنامج الخفي بيانات الاعتماد التي استخدمتها لتسجيل الدخول إلى CLI. تسجيل الدخول إلى CLI منفصل عن تسجيل الدخول إلى محرر Antigravity لسطح المكتب على الكمبيوتر نفسه؛ وفي المتصفح، استخدم حساب Google نفسه المستخدم في CLI.

يمكنك تعيين اسم جهاز البرنامج الخفي دون واجهة باستخدام الخيار --name عند التشغيل:

agy remote-control start --name "my-workstation"

تؤدي إعادة تشغيل start --name بقيمة جديدة إلى تغيير اسم الجهاز.

إذا لم تعيّن اسمًا، ينشئ البرنامج الخفي اسمًا سهل التذكر (مثل my-machine-distant-plume) عند تشغيله لأول مرة؛ ويعرض agy remote-control status الاسم الحالي. ويمكنك أيضًا إعادة تسميته في ملف الإعدادات: افتح ~/.gemini/config/config.json في Linux/macOS أو %USERPROFILE%\.gemini\config\config.json في Windows، وغيّر قيمة cliRemoteControlHostname، واحفظ الملف، ثم شغّل agy remote-control start مجددًا لإعادة تشغيل البرنامج الخفي. سيظهر الاسم الجديد في لوحة التحكم بعد إعادة تشغيل الخدمة؛ ولا تُطبّق التغييرات على الملف أثناء تشغيل البرنامج الخفي.

يوجد في الملف حقلان متشابهان. cliRemoteControlHostname هو اسم برنامج CLI الخفي المشروح هنا. أما remoteControlHostname فهو حقل منفصل لمحرر Antigravity لسطح المكتب على الكمبيوتر نفسه؛ ويمكنك تغييره في Antigravity 2.0 من Settings → App.

سلوك البرنامج الخفي بعد تسجيل الخروج وإعادة التشغيل

يعتمد السلوك على نظام التشغيل:

تفاصيل خاصة بنظام Windows

يتطلب تسجيل البرنامج الخفي لبدء التشغيل التلقائي عند إقلاع النظام تشغيله بصلاحيات مسؤول. يمكنك استخدام PowerShell أو موجه الأوامر العادي. يعمل الأمر start أيضًا من نافذة عادية، لكن بعد تسجيل الخروج أو إعادة التشغيل لن يُستأنف البرنامج الخفي إلا عند تسجيل الدخول التالي، لا عند الإقلاع. ويعمل الأمران status وstop من نافذة عادية من دون صلاحيات مرتفعة.

أي وضع تختار؟

يكفي الوضع التفاعلي لإدارة مهمة جارية من هاتفك. إذا كنت بحاجة إلى الوصول عن بُعد من دون طرفية مفتوحة، فاستخدم البرنامج الخفي دون واجهة، وفقًا لشروط نظام التشغيل لديك.

ما الذي تفعله عند مواجهة مشكلات في الاتصال؟#

المشكلات والحلول الواردة في الوثائق الرسمية:

لإجراء تشخيص أعمق، راجع سجلات البرنامج الخفي: في Linux، شغّل journalctl --user -u antigravity-cli-daemon -n 50؛ وفي macOS، افحص ~/Library/Logs/antigravity-cli-daemon.log؛ وفي Windows، افحص أحدث ملف cli-*.log في %USERPROFILE%\.gemini\antigravity-cli\log.

يوفر البرنامج الخفي دون واجهة إمكانية الوصول من دون طرفية مفتوحة، بما في ذلك أثناء ابتعادك، وفقًا لظروف تشغيل الكمبيوتر ونظام التشغيل. إذا لم تعد بحاجة إلى الوصول المستمر، فأوقف البرنامج الخفي باستخدام agy remote-control stop.

هناك مقال منفصل عن التحكم عن بُعد في Claude Code. للتحكم في وكيل آخر عبر Telegram، راجع إعداد Hermes Agent في Telegram.

ما الخطوة التالية؟#

إذا كنت تعمل في CLI وتريد الابتعاد عن المهمة الحالية، فابدأ بالوضع التفاعلي. اترك الطرفية مفتوحة: إذا أغلقتها، ينقطع النفق ويختفي إدخال الجلسة من لوحة التحكم. للوصول إلى الجهاز من دون طرفية مفتوحة، استخدم البرنامج الخفي وفقًا لقيود نظام التشغيل لديك.

تتوفر مواد أخرى على Ailoot.