1. مقدمة
في هذا الدرس التطبيقي حول الترميز، ستتعرّف على Antigravity CLI، وهي واجهة مستخدم خفيفة الوزن في نافذة الأوامر (TUI) من Antigravity. توفّر هذه الواجهة إمكانات بالذكاء الاصطناعي الوكيل الأساسية نفسها التي توفّرها Antigravity 2.0 (مثل الاستدلال المتعدّد الخطوات وتعديل الملفات المتعدّدة واستخدام الأدوات وسجلّ المحادثات) مباشرةً في نافذة الأوامر على جهازك.
ما ستتعلمه
- تثبيت واجهة سطر الأوامر Antigrabity وضبطها
- فهم الاستخدام الأساسي لواجهة سطر الأوامر Antigravity CLI
- استكشاف بعض حالات الاستخدام مع Antigravity CLI
المتطلبات
ستحتاج إلى ما يلي:
- متصفّح الويب Chrome
- حساب Gmail
تم تصميم هذا الدرس التطبيقي حول الترميز للمستخدمين والمطوّرين من جميع المستويات (بما في ذلك المبتدئين). تم تصنيف حالات الاستخدام في الدرس التطبيقي حول الترميز إلى مهام للمطوّرين ومهام لغير المطوّرين. توضّح حالات استخدام المطوّرين كيفية استخدام رمز vibe مع Antigravity CLI والعمل مع مستودع GitHub لتنفيذ مهام تطوير شائعة مثل شرح الرمز البرمجي/فهمه وإنشاء المستندات وإصلاح المشاكل وغير ذلك. ننصحك بإكمال حالات الاستخدام هذه في الدرس التطبيقي حول الترميز. يتوفّر في النهاية قسم اختياري يتناول العديد من المهام اليومية التي لا تركّز على المطوّرين.
2. قبل البدء
إنشاء مشروع
- في Google Cloud Console، ضمن صفحة اختيار المشروع، اختَر أو أنشِئ مشروعًا على Google Cloud.
- تأكَّد من تفعيل الفوترة لمشروعك على السحابة الإلكترونية. تعرَّف على كيفية التحقّق مما إذا كانت الفوترة مفعَّلة في مشروع.
- ستستخدم Cloud Shell، وهي بيئة سطر أوامر تعمل في Google Cloud ومحمّلة مسبقًا بأداة bq. انقر على "تفعيل Cloud Shell" في أعلى "وحدة تحكّم Google Cloud".
- بعد الاتصال بـ Cloud Shell، يمكنك التأكّد من إكمال عملية المصادقة وأنّ المشروع مضبوط على رقم تعريف مشروعك باستخدام الأمر التالي:
gcloud auth list
- نفِّذ الأمر التالي في Cloud Shell للتأكّد من أنّ أمر gcloud يعرف مشروعك.
gcloud config list project
- إذا لم يتم ضبط مشروعك، استخدِم الأمر التالي لضبطه:
gcloud config set project <YOUR_PROJECT_ID>
3- تثبيت
قبل إعداد Antigravity CLI وتشغيله، لننشئ مجلدًا سنستخدمه كمجلد رئيسي لجميع المشاريع التي ننشئها بداخله. هذه هي نقطة البداية التي سيعمل بها Antigravity CLI، على الرغم من أنّه سيشير أيضًا إلى بعض المجلدات الأخرى على نظامك والتي ستتعرّف عليها لاحقًا، حسب الحاجة.
يمكنك إنشاء مجلد نموذجي (agy-cli-projects) والانتقال إليه باستخدام الأوامر الموضّحة أدناه. إذا كنت تفضّل استخدام اسم مجلد آخر، يمكنك إجراء ذلك.
mkdir agy-cli-projects
لننتقل إلى هذا المجلد:
cd agy-cli-projects
عملية التثبيت بسيطة، وتتوفّر الملفات الثنائية على جميع أنظمة التشغيل الرئيسية. وقد أخذتُ الأوامر التي يجب تنفيذها في الوحدة الطرفية مباشرةً من مستند التثبيت:
macOS | Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash
Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iex
Windows CMD
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
من المفترض أن يؤدي ذلك إلى إعداد وتثبيت Antigravity CLI (agy) في نظامك وفي المسار.
في بعض الحالات، إذا لم يتمكّن برنامج التثبيت من إضافة الملف الثنائي ( agy إلى PATH)، سيتم إعلامك بذلك. على سبيل المثال، إليك نموذجًا لناتج على جهاز لم يتمكّن فيه برنامج التثبيت من إضافة الملف الثنائي إلى PATH واقترح ما يجب فعله.
% curl -fsSL https://antigravity.google/cli/install.sh | bash
⠋ Detecting system environment...
✓ Platform detected: darwin_arm64
⠋ Querying release repository...
✓ Latest available version: 1.0.1
⠋ Downloading release package...
✓ Download complete and checksum verified.
⠋ Extracting binary from archive...
⠋ Configuring shell environment...
I0523 11:44:14.012088 76528 installer.go:27] Running Antigravity CLI setup...
Warning: /Users/neilirani/.local/bin is not present in your active PATH.
To use the 'agy' CLI globally, please manually add it to your shell profile:
echo 'export PATH="/Users/yourusername/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
✅ Antigravity CLI binary placed successfully at /Users/yourusername/.local/bin/agy
Note: The binary is installed, but it is not in your active PATH. Please follow the instructions above to add it, then restart your terminal session.
ما عليك سوى الاطّلاع على إصدار Antigravity CLI من خلال الأمر التالي (الإصدار المعروض هو الإصدار المتوفّر في وقت كتابة هذا الدرس التطبيقي حول الترميز):
$ agy --version
1.0.5
عند تشغيل Antigravity CLI للمرة الأولى، سيُطلب منك تسجيل الدخول. شغِّل agy، ومن المفترض أن يظهر لك شيء مشابه لما يلي:
▄▀▀▄
▀▀▀▀▀▀
▀▀▀▀▀▀▀▀
▄▀▀ ▀▀▄
▄▀▀ ▀▀▄
Welcome to the Antigravity CLI. You are currently not signed in.
Select login method:
> 1. Google OAuth
2. Use a Google Cloud project
[Use arrow keys to navigate, Enter to select]
استخدِم حسابك الشخصي في الوقت الحالي. اختَر 1. Google OAuth واضغط على Enter. سيؤدي ذلك إلى فتح متصفّح ويمكنك تسجيل الدخول باستخدام حسابك على Google. بعد إتمام عملية المصادقة والتفويض بنجاح، سيُطلب منك نسخ رمز. يُرجى الرجوع إلى نافذة Antigravity CLI ولصق الرمز.
بعد تسجيل الدخول بنجاح، تحدث بعض الإجراءات:
- في البداية، سيُطلب منك تحديد نسق الألوان الذي تريد اختياره لواجهة سطر الأوامر Antigravity، كما هو موضّح أدناه. اختَر الصورة التي تعجبك.
- بعد ذلك، عليك قبول بعض بنود الخدمة. اقبل هذه الطلبات.
أخيرًا، الأهم هو منح الإذن الذي تثق به للمجلد، كما هو موضّح أدناه:
Accessing workspace:
/Users/yourusername/agy-cli-projects
Do you trust the contents of this project?
Antigravity CLI requires permission to read, edit, and execute files here.
> Yes, I trust this folder
No, exit
↑/↓ Navigate · enter Confirm
سيظهر هذا عادةً في أي مجلد جديد تشغّل فيه واجهة سطر الأوامر Antigravity. سنتناول هذا الموضوع بمزيد من التفصيل لاحقًا في هذه السلسلة، ولكن في الوقت الحالي، انقر على نعم، أثق بهذا المجلد.
تهانينا! اكتملت عملية الإعداد الآن، وأداة Antigravity CLI في انتظار طلبك.
4. تفاعلنا الأول مع Antigravity CLI
لنبدأ باستخدام Antigravity CLI ونكتب طلب البحث الأول كما هو موضّح أدناه:
Give me a famous quote on Artificial Intelligence and who said that?
يظهر الردّ المتوقّع أدناه:
● WebSearch(famous quotes on Artificial Intelligence) (ctrl+o to expand)
Here is one of the most famous quotes on Artificial Intelligence:
│ "AI is the new electricity."
│ — Andrew Ng (Co-founder of Coursera and Google Brain, Adjunct Professor at Stanford University)
Another widely cited perspective on the potential risks of AI is:
│ "The development of full artificial intelligence could spell the end of the human race. It would take off on its
│ own, and re-design itself at an ever-increasing rate."
│ — Stephen Hawking
ستلاحظ أنّ Antigravity استخدمت إحدى أدواتها الداخلية WebSearch للحصول على الاقتباس.
بالإضافة إلى تقديم الطلبات هنا، ما هي الأوامر المختلفة التي يتيحها Antigravity CLI؟ يمكنك العثور على ذلك من خلال كتابة /help (شرطة مائلة للأمام)، وستظهر لك مجموعة متنوعة من الأوامر واختصارات لوحة المفاتيح. في ما يلي بعض الأوامر التي كانت متاحة عند كتابة هذا المقال:
Antigravity CLI general commands shortcuts (←/→ or tab to cycle)
Available Commands
> /add-dir Add a directory to the workspace
/agents List available custom agents
/artifact View and review artifacts
/btw Ask a side question without interrupting the current task
/changelog Show release notes and changes
/clear (new) Clear conversation and start a new one
/config (settings) Open settings panel
/context Visualize current context usage
/copy Copy the last planner response to the clipboard (may require allowing clipboard ac...
/credits Show remaining G1 credits and purchase link
/diff View uncommitted changes and per-turn diffs
/exit (quit) Exit the CLI
/fast Agent will execute tasks directly. Use for simple tasks that can be completed faster
/feedback Submit qualitative feedback to improve the agent
/fork (branch) Create a branch of the current conversation at this point
/help Show available commands and keybindings
/hooks Manage hook configurations for tool events
/keybindings Set custom keybindings
/logout Log out
/mcp Manage MCP servers
/model Set a model
/open Open a file or view opened/edited files
/permissions Manage tool permissions
/planning Agent can plan before executing tasks. Use for deep research, complex tasks, or co...
<MORE_COMMANDS>
لنغلق Antigravity CLI الآن. يمكنك إجراء ذلك إما باستخدام الأمر /quit أو يمكنك تنفيذ الأمر ctrl+d مرّتين في جلسة طرفية تفاعلية لواجهة سطر الأوامر Antgiravity.
5- Antigravity CLI - بعض أوامر الصيانة
تأكَّد من تشغيل Antigravity CLI وأنّه ينتظر تنفيذ أمرك.
لاحظ النموذج الذي يتم استخدامه، وسيظهر اسمه في أسفل يسار الشاشة. أولاً، من المفترض أن تعرف أنّ معظم عمليات التخصيص والإعدادات التي عليك إجراؤها متاحة من خلال الأمر /config أو /settings.
الإعدادات
واصِل العملية وأدخِل الأمر /config. سيؤدي ذلك إلى عرض أقسام مختلفة من Antigravity يمكنك تخصيصها استنادًا إلى إعداداتك المفضّلة. ويشمل ذلك نظام الألوان وإذن الأداة وإعدادات قياس استخدام المنتج والمزيد.
Settings
Search:
────────────────────
> Animation Speed medium
Artifact Review asks for review
Color Scheme dark
Editor auto ($EDITOR)
Enable Telemetry on
Non-Workspace Access off
Notifications off
Rendering Mode native terminal (inline)
Sandbox Mode off
Show Feedback Survey on
Show Tips on
Tool Permission request-review
Use AI Credits off
Verbosity high
على سبيل المثال، يعرض "نظام الألوان" الخيارات التالية التي يمكنني من خلالها اختيار نظام الألوان المفضّل لديّ:
Color Scheme ╭─────────────────────────────────────────────────────────────╮
terminal │
light │
solarized light │
colorblind-friendly light │
> dark (current) │
solarized dark │
colorblind-friendly dark │
tokyo night
settings.json
يجب تخزين إعدادات الضبط في مكان ما، أليس كذلك؟ يتم تخزينها كلها في ملف ~/.gemini/antigravity-cli/settings.json. في ما يلي عيّنة:
{
"colorScheme": "dark",
"model": "Gemini 3.5 Flash (High)",
"statusLine": {
"type": "",
"command": "",
"enabled": true
},
"trustedWorkspaces": [
"/Users/romin/antigravity-cli-projects",
"/Users/romin/agy-cli-projects"
]
}
يمكنك ملاحظة colorScheme الذي اخترته، والنموذج، والمجلدات المختلفة التي بدأت منها Antigravity CLI ووافقت على الوثوق بها.
ملاحظة: يمكنك تعديل settings.json مباشرةً أيضًا وإعادة تشغيل Antigravity CLI كأفضل ممارسة للاطّلاع على التغييرات، ولكن تأكَّد من الإعدادات، وإلا سيظهر خطأ عند بدء التشغيل. إذا لم تكن مرتاحًا لتعديل الملف مباشرةً، يُنصح باستخدام الأمر /settings أو /config في Antigravity CLI للتعامل مع هذا الملف.
إذن الأداة
من الإعدادات المهمة التي يجب فهمها هي "إذن الأداة". تتحكّم هذه السياسة في ما إذا كانت أوامر الجهاز الطرفي تتطلّب موافقتك قبل تنفيذها. يمكنك الوصول إلى هذه الصفحة من خلال الأمر /config.
Tool Permission
> request-review (current)
proceed-in-sandbox
always-proceed
strict
يتم ضبطها تلقائيًا على request-review. لنفهم هذا بالتفصيل. في Antigravity، تتحكّم إعدادات "أذونات الأدوات" في التوازن بين الأمان (حماية نظامك المضيف من التغييرات غير المقصودة) والسرعة (مدى قدرة الوكيل على العمل بشكل مستقل بدون التوقف لطلب إدخالك). لنراجع الخيارات:
request-review (الإعداد التلقائي الحالي)
في هذا الوضع، يتم التعامل مع الوكيل كشريك تعاوني يسجّل الدخول قبل تنفيذ أي إجراء يمكن أن يؤثر في نظامك أو ملفات مشروعك خارج الحدود التي تمت الموافقة عليها مسبقًا. وعندما يحاول الوكيل تنفيذ أمر طرفي أو إجراء عملية ملف (مثل الكتابة أو الحذف) أو استدعاء خدمة خارجية لم تتم الموافقة على إذنها مسبقًا، يتم إيقاف التنفيذ مؤقتًا. ويُطلب من المستخدم الموافقة على الإجراء المحدّد أو رفضه.
proceed-in-sandbox
يسمح هذا الوضع للوكيل بتنفيذ أوامر الوحدة الطرفية تلقائيًا، ولكن ضمن حاوية آمنة ومعزولة. يمكن للوكيل تنفيذ الأوامر بدون مطالبتك بذلك، ولكن يتم تنفيذ هذه الأوامر في وضع حماية محاكاة افتراضية (مثل حاوية خفيفة الوزن). ولا يمكنها تعديل نظام الملفات الخاص بالجهاز المضيف الفعلي أو الوصول إلى شبكتك المحلية.
always-proceed
هذا هو الوضع المستقل تمامًا، ما يمنح الوكيل أقصى سرعة وقدرة. يتم منح الوكيل إذنًا كاملاً بتنفيذ الأوامر وكتابة الملفات مباشرةً على الجهاز المضيف. ولن يطلب منك تأكيدها أبدًا.
strict
هذا وضع أمان عالٍ يعتمد على نهج الثقة المعدومة. وتقتصر إمكانات الوكيل على تنفيذ أدوات القراءة، بينما تتطلّب جميع الأدوات الأخرى أن يطلب الوكيل من المستخدم اتّخاذ إجراء.
6. Antigravity CLI - Command Parameters
يمكن تقديم بعض مَعلمات سطر الأوامر عند بدء تشغيل واجهة سطر الأوامر في Antigravity. للحصول على قائمة كاملة بالخيارات، يمكنك استخدام --help كما هو موضّح أدناه.
agy --help
من المفترض أن يعرض هذا الخيار النطاق الكامل للخيارات المتاحة، كما هو موضّح في نموذج بطاقة البيانات أدناه:
$ agy --help
Usage of agy:
--add-dir Add a directory to the workspace (repeatable) (default [])
-c Short alias for --continue
--continue Continue the most recent conversation
--conversation Resume a previous conversation by ID
--dangerously-skip-permissions Auto-approve all tool permission requests without prompting
-i Short alias for --prompt-interactive
--log-file Override CLI log file path
--model Model for the current CLI session
-p Short alias for --print
--print Run a single prompt non-interactively and print the response
--print-timeout Timeout for print mode wait (default 5m0s)
--prompt Alias for --print
--prompt-interactive Run an initial prompt interactively and continue the session
--sandbox Run in a sandbox with terminal restrictions enabled
Available subcommands:
changelog Show changelog and release notes
help Show help for subcommands
install Configure environment paths and shell settings
models List available models
plugin Manage plugins (install, uninstall, list, enable, disable)
plugins Alias for plugin
update Update CLI
لنلقِ نظرة على بعضها.
وضع عدم التفاعل (الوضع الذاتي)
من الخيارات المثيرة للاهتمام تشغيل Antigravity CLI في وضع غير تفاعلي، ما يعني أنّك تقدّم الطلب مباشرةً وستردّ عليه بدون فتح نافذة Antigravity CLI التفاعلية. ويكون هذا الخيار مفيدًا جدًا إذا كنت تخطّط لاستخدام Antigravity CLI بطريقة آلية كجزء من النص البرمجي أو أي عملية تشغيل آلي أخرى.
يمكنك استخدام المَعلمة -p لتقديم الطلب إلى Antigravity CLI كما هو موضّح أدناه:
agy -p "What is the gcloud command to deploy to Cloud Run"
قد تكون هذه طريقة جيدة للحصول على بعض الإجابات السريعة، ولكن تذكَّر أنّه لا يمكنك مواصلة المحادثة بطرح أسئلة متابعة.
اختيار نموذج محدّد
الطريقة الأولى هي أن تطلب من Antigravity CLI استخدام وضع Gemini معيّن. يمكنك استخدام المَعلمة --model لإخبار Antigravity CLI باستخدام نموذج معيّن خلال جلسته فقط. يكون ذلك مفيدًا جدًا للوضع غير التفاعلي الذي ذكرناه في القسم السابق، حيث تريد تشغيل عدّة جلسات agy واستخدام نماذج معيّنة لمهام معيّنة.
ولكن قبل ذلك، عليك معرفة النماذج المتاحة لأداة Antigravity CLI، ويمكنك إجراء ذلك من خلال الأمر الفرعي models كما هو موضّح أدناه:
$ agy models
Gemini 3.5 Flash (Medium)
Gemini 3.5 Flash (High)
Gemini 3.5 Flash (Low)
Gemini 3.1 Pro (Low)
Gemini 3.1 Pro (High)
Claude Sonnet 4.6 (Thinking)
Claude Opus 4.6 (Thinking)
يمكنك استخدام أيّ من أسماء النماذج هذه لتحديد النموذج الذي سيتم استخدامه للجلسة، وذلك من خلال الأمر --model الموضّح أدناه:
$ agy --model "Claude Opus 4.6 (Thinking)"
بعد تشغيل Antigravity CLI، يمكنك التحقّق من ذلك إما من خلال الأمر /model بشأن النموذج المحدّد الذي طلبت استخدامه أو من خلال النظر إلى أسفل يسار الشاشة حيث يظهر النموذج المستخدَم للجلسة.
العيش بتهوّر
إذا كنت من محبّي المغامرة، يمكنك البحث عن مَعلمة تحمل اسمًا مناسبًا جدًا وهو --dangerously-skip-permissions. سيؤدي ذلك إلى الموافقة تلقائيًا على جميع أذونات الأدوات. لن تظهر لك رسالة تطلب منك منح الأذونات. لذا، يُرجى استخدامه بعناية.
شغِّل Antigravity CLI باستخدام الأمر التالي:
agy --dangerously-skip-permissions
بعد ذلك، وجِّه الطلب التالي. تأكَّد من أنّه لم يطلب مني أي أذونات كتابة في الملف.
> get the latest news and write it in a file called news.txt. Then create another file that contains the summary of that file.
● ListDir(/Users/romin/agy-cli-projects)
● WebSearch(latest world news May 24 2026 news headlines) (ctrl+o to expand)
▸ Thought for 2s, 95 tokens
Processing News Information
● Create(/Users/romin/agy-cli-projects/news.txt)
● Create(/Users/romin/agy-cli-projects/summary.txt) (ctrl+o to expand)
I have fetched the latest world news headlines and created the requested files in your workspace:
1. news.txt: Contains the detailed news headlines for today (May 24, 2026), including topics on geopolitics (U.S.-Iran negotiations, Ukraine conflict), U.S.
security incidents, the Ebola outbreak in Central Africa, and the passing of NASCAR champion Kyle Busch.
2. summary.txt: Contains a concise, structured summary of the major categories covered in the news file.
يمكن أن يكون هذا الوضع مفيدًا في الحالات التي تكون فيها الأمور محلية وتحت سيطرتك، ولكن يجب الاستعداد للمفاجآت واستخدامه بحذر.
7. Antigravity CLI - وضع Shell
هذا هو الوقت المناسب لتعلُّم كيفية العمل مباشرةً مع Shell من داخل واجهة سطر الأوامر في Antigravity. يمكنك الانتقال إلى وضع الصدفة من خلال الضغط على ! في مربّع الرسالة. سيؤدي ذلك إلى التبديل إلى وضع Shell. يمكنك الرجوع إلى الصفحة السابقة بالضغط على ! مرة أخرى أو على المفتاح ESC.
عندما تكون في وضع shell، سترى ! في بداية الطلب كما هو موضّح أدناه:
يمكنك التحقّق مباشرةً باستخدام الأوامر العادية، مثل pwd وls كما هو موضّح أدناه. يُرجى العِلم أنّ الأوامر تفترض استخدام نظام تشغيل من نوع Linux. إذا كنت تستخدم نظام تشغيل آخر (Windows)، يُرجى استخدام الأوامر المكافئة، مثل (cd وdir وtype).
8. حالات استخدام يمكنك تجربتها
يمكن تطبيق واجهة سطر الأوامر Antigravity على مجموعة كبيرة من حالات الاستخدام التي تنطبق على المطوّرين وغير المطوّرين على حد سواء. وفي ما يلي بعض السيناريوهات، ويمكنك تجربة أيّ منها أو جميعها حسب مجال اهتمامك.
في كلّ من هذه الحالات، يتمّ تقديم الطلب. يمكنك تجربة ذلك في وضع Antigravity CLI التفاعلي لفهم كيفية تنفيذ Antigravity CLI لمهمته بشكل أفضل.
البرمجة الحدسية باستخدام Antigravity CLI
لنستخدِم Antigravity CLI لإنشاء رمز تطبيق. في هذه المهمة، ستطلب من Antigravity CLI إنشاء تطبيق ثم إرسال الإصدار الأولي إلى مستودع GitHub.
المتطلّبات الأساسية
لتنفيذ المهام في هذا القسم، يجب استيفاء بعض الشروط المسبقة:
- Git
- Antigravity CLI
- بيئة Python 3
- إعداد
gh( أداة GitHub CLI) - الإلمام بأساسيات Git ومعرفة بعض المعلومات عن البرمجة
سنفترض أنّك شغّلت Antigravity CLI في مجلد محدّد من اختيارك. في حالتنا، أطلقنا Antigravity CLI من مجلد الصفحة الرئيسية الأولي agy-cli-projects ومجلد آخر bq-releases-notes بداخله.
ابدأ بطلب أولي، واعتبره مواصفات لتطبيقك. يمكنك تعديله كما تراه مناسبًا. تذكَّر أنّه سيطلب منك أذونات لإنشاء الملفات وما إلى ذلك خلال الجلسة مع Antigravity CLI، لذا عليك منح الأذونات المطلوبة.
Please build a web application for me using Python Flask and plain vanilla HTML, JavaScript and CSS that fetches the BigQuery Release notes from (https://docs.cloud.google.com/feeds/bigquery-release-notes.xml) and shows them to me.
A simple refresh button with a spinner is good enough, anytime I'd like to refresh the details.
I would also like the ability to take any specific update, select it and then Tweet about it.
الطلبات والردود القليلة التالية هي نموذج لسير عمل تم رصده. سيضع Antigravity CLI خطة ويطلب منك أي تأكيدات أو توضيحات أو سيتابع التنفيذ. يُرجى اتّباع التعليمات. إليك نموذج لسلسلة المحادثات:
I will start by exploring the workspace to see if there is an existing structure or if this is a brand new project.
● ListDir(/Users/romin/agy-cli-projects/bq-release-notes) (ctrl+o to expand)
I will read the BigQuery release notes XML feed to understand its structure (Atom/RSS elements, entry/item elements, namespaces, dates, titles, content) so that we can parse it
correctly in the Python Flask backend.
● ReadURL(https://docs.cloud.google.com/feeds/bigquery-release-notes.xml) (ctrl+o to expand)
I will view the fetched feed content saved locally to understand its format and structure.
● Read(/Users/romin/.gemini/antigravity-cli/brain/116191af-e6ea-4ba5-aa23-62f995bd068a/.system_generated/steps/6/content.md) (ctrl+o to expand)
▸ Thought for 2s, 2.3k tokens
Analyzing XML Feed Structure
I will write the implementation plan detailing the architecture, design aesthetic, components, and verification steps for the BigQuery Release Notes Web Application. This plan will be
written to the artifacts directory.
● Create(/Users/romin/.gemini/antigravity-cli/brain/116191af-e6ea-4ba5-aa23-62f995bd068a/implementation_plan.md) (ctrl+o to expand)
I have created the implementation_plan.md to outline the design and architecture of the BigQuery Release Notes Web Application.
Please review the plan, especially the approach for the Twitter Composer & Preview Card, and let me know if you approve or if there are any adjustments you'd like to make!
1 artifact · /artifact to review
حان الوقت للتعرّف على ماهية Artifacts في Antigravity. من خلال Artifacts، يمكن لواجهة سطر الأوامر (CLI) في Antigravity إطلاعنا على خطة التنفيذ وقائمة المهام التي يتم العمل عليها والنتائج التي يمكن التحقّق منها وغير ذلك. يتم إنشاء هذه الملفات وهي تسجّل العمل الذي تنفّذه Antigravity وخطتها وقائمة المهام وغير ذلك.
بعد ذلك، سيقول: "لقد أنشأتُ implementation_plan.md لتحديد تصميم وبنية تطبيق الويب الخاص بملاحظات إصدار BigQuery. يُرجى مراجعة الخطة، لا سيما طريقة استخدام "أداة إنشاء التغريدات" و"بطاقة المعاينة" على Twitter، وإعلامي بموافقتك أو إذا كانت لديك أي تعديلات تريد إجراءها".
يمكنك ملاحظة أنّه يذكر أيضًا في أسفل يسار الشاشة أنّه يجب مراجعة قطعة أثرية واحدة، وهي في هذه الحالة implementation_plan.md.
وجِّه الطلب /artifact. سيؤدي ذلك إلى عرض العنصر الذي تم إنشاؤه implementation_plan.md ويمكنك استخدام مفاتيح الأسهم لفتحه والموافقة عليه ورفضه وما إلى ذلك. ما عليك سوى الضغط على Escape والعودة إلى الطلب، ويمكنك الموافقة عليه هنا إذا أردت.
في حالتنا، سنوافق على ما تم إنشاؤه. سيؤدي ذلك إلى بدء مجموعة الخطوات التالية، حيث ستبدأ عملية التنفيذ، أي إنشاء الملفات وتشغيل بعض الأوامر وما إلى ذلك. سيُطلب منك الموافقة ومنح الإذن بالتنفيذ، حسب الحاجة.
في حالتنا، منحنا الموافقة لإنشاء البيئة الافتراضية في Python وتثبيت التبعيات من خلال requirements.txt وما إلى ذلك.
في الخلفية، أنشأ أيضًا ملف task.md كجزء من المهام التي يجب إنجازها استنادًا إلى خطة التنفيذ، ويضع علامة بجانب المهام الفردية عند إكمالها. بعد اكتمال عملية التثبيت، سيتم إعلامك بذلك ويمكنك الاطّلاع على التطبيق في المتصفّح. إليك ما أنشأته لنا:
يمكننا التوقف الآن، فقد كان الهدف من ذلك هو توضيح ما يمكن أن يفعله الذكاء الاصطناعي من خلال متطلبات بسيطة.
(اختياري) إرسال التغييرات إلى مستودع Github
إذا كنت لا تريد نشر الموقع الإلكتروني للفعالية الذي أنشأناه على Github، يمكنك تجاهل هذا القسم والانتقال إلى القسم التالي.
أولاً، لننشئ ملف .gitignore، ويمكنك الاستعانة بواجهة سطر الأوامر Antigravity.
Create a .gitignore file for this project.
الخطوة التالية هي تقديم تعليمات إلى Antigravity CLI لنقل هذا المستودع إلى حسابنا على GitHub، ويجب أن يستخدم ذلك أداة GitHub المساعدة (gh) التي من المفترض أن تكون متاحة وتم إعدادها على جهازك. أدوات خادم MCP على GitHub في الخلفية.
قدِّم طلبًا مشابهًا للطلب أدناه:
Great! I would now like to push all of this to a new repository in my GitHub account. I would like to name this repository <Your-Name>-event-talks-app
سيتم تنفيذ عدد من الأوامر هنا:
- أنشئ المستودع.
- سيستخدم عدة أوامر Git، مثل init وadd وcommit، لإدارة مستودع Git المحلي.
- سيتم بعد ذلك إعداد Git عن بُعد وتنفيذ عملية دفع
إذا سارت الأمور على ما يرام، من المفترض أن يكون لديك مستودع GitHub. يمكنك الانتقال إلى صفحة مستودع GitHub. في ما يلي لقطة شاشة نموذجية:
يُرجى العِلم أنّك لم تنشئ README.md لهذا المشروع، وهذا تمرين جيد للقسم التالي، حيث سنعمل الآن مع هذا المستودع الذي أنشأته للتو.
استخدام Antigravity CLI للعمل مع مستودع الرموز البرمجية
في حالة الاستخدام هذه، عليك استخدام Antigravity CLI للعمل مع مستودع الرموز البرمجية. ستنفّذ مهام متعددة تشمل ما يلي:
- فهم قاعدة الرموز البرمجية
- إنشاء مستندات
- تنفيذ ميزة جديدة
من المفترض أن يمنحك ذلك أساسًا جيدًا للعمل مع مستودعاتك واستخدام Antigravity CLI كمساعد في ما يتعلق بهذه المهام الخاصة بالمطوّرين.
المتطلّبات الأساسية
لتنفيذ المهام الواردة في هذا القسم، عليك إجراء ما يلي:
- Antigravity CLI
- يجب أن تكون قد أكملت القسم السابق وأن يكون لديك الرمز الذي تم إنشاؤه في متناول يدك، حيث أنشأنا قارئًا لملاحظات إصدار BigQuery.
لنواصل استخدام Antigravity CLI من المجلد أو الدليل الذي استخدمته لإنشاء تطبيق "ملاحظات إصدار BigQuery".
جرِّب الطلبات التالية كما هو موضّح أدناه:
فهم قاعدة الرموز البرمجية
- أريد فهم هذا المشروع بالتفصيل. أريد فهم الميزات الرئيسية ثم تقسيمها إلى ميزات من جهة الخادم وميزات من جهة العميل. أريد مثالاً على مسار عمل وكيفية عمل الطلب والاستجابة. يُرجى العِلم أنّه سيتم إنشاء ملف جديد (عنصر) ويمكنك عرض جميع العناصر أو عناصر معيّنة من خلال **
/artifact** **الأمر.** - شرح
@app.py
إنشاء ملف README
- أنشئ ملف
READMEلهذا المشروع.
تنفيذ ميزة جديدة
- يُرجى تنفيذ ميزتَين بسيطتَين للأدوات المساعدة: زر "نسخ إلى الحافظة" على كل بطاقة وزر "تصدير إلى ملف CSV".
- يُرجى تنفيذ مفتاح تبديل بسيط في العنوان يبدّل نظام ألوان الصفحة من الوضع الداكن إلى الوضع الفاتح من خلال إلغاء متغيرات CSS الجذرية.
يجب أن يقدّم لك خطة يمكنك الموافقة عليها، وبعد الموافقة، سيقوم Antigravity CLI بإجراء هذه التغييرات. اختبِر التغييرات، وإذا كانت هناك أخطاء (وهذا محتمل)، اطلب من Antigravity CLI إصلاحها.
إنشاء مشاكل استنادًا إلى الميزات المقترَحة
لنجرّب شيئًا مثيرًا للاهتمام هنا. ستطرح على Antigravity CLI سؤالاً حول كيفية تحسين تجربة المستخدم لهذا التطبيق.
جرِّب الطلب التالي:
- أريد منك تقييم التطبيق من وجهة نظر تجربة المستخدم، أي سهولة الاستخدام والاستجابة والرسائل المفيدة وغير ذلك. يُرجى تقديم قائمة بالتحسينات.
كمتابعة، يمكنك الآن اختيار إحدى المشاكل التي تم إنشاؤها سابقًا وطلب أن تعمل أداة Antigravity CLI على حلّها وتنفيذها.
(اختياري) المهام اليومية
حالات الاستخدام الموضّحة أدناه هي مهام قد تضطر إلى تنفيذها بانتظام. وتشمل هذه الأدوات ترتيب الملفات في مجلدات، واسترداد المحتوى وتلخيصه من الويب، ومعالجة ملفات الصور واستخراج المحتوى منها، والعمل مع قواعد البيانات، وغير ذلك.
يمكنك استكشاف أي من حالات الاستخدام التي تعجبك.
تنظيم الملفات/المجلدات
يمكنك استخدام Antigravity CLI لتنظيم الملفات حسب الأنواع في مجلدات مختلفة حسب الحاجة. انتقِل إلى مجلد على جهازك يحتوي على عدة ملفات بتنسيقات .txt و.png و.jpg و.pdf و.mp4 وغيرها. من المحتمل أن يكون هذا هو سطح المكتب أو مجلد "عمليات التنزيل".
انتقِل إلى هذا المجلد وابدأ Antigravity CLI. ستطلب من Antigravity CLI إنشاء بعض المجلدات أولاً: "الصور" و"المستندات" و"الفيديوهات"، ثم ستطلب من Antigravity CLI تنظيم الملفات في المجلدات.
سيطلب منك Antigravity CLI غالبًا الحصول على إذن قبل تنفيذ الأوامر، خاصةً تلك التي تعدّل نظام الملفات (مثل كتابة الملفات أو نقلها أو حذفها). يُرجى مراجعة هذه الطلبات بعناية دائمًا قبل منح الإذن. هذه هي شبكة الأمان.
Create the following folders "Images","Documents","Videos"
بعد ذلك، وجِّه الطلب التالي:
Go through all the files in this folder and then organize them by moving all the files ending with .jpg, .jpeg, .gif into the "Images" folder. Move all ".txt" files into the "Documents" folder. Move all the ".mp4" files in the "Videos" folder.
في ما يلي مثال على عملية تشغيل على جهازنا:
I have completed organizing your files into their respective folders. Here is a summary of the files moved:
• Images: Moved 95 files ending in .jpg or .jpeg (no .gif files were present).
• Documents: Moved 1 file ending in .txt ( 12March_Live_chat_transcript.txt ).
• Videos: Moved 26 files ending in .mp4 .
في ما يلي بعض سيناريوهات التنظيم الأخرى (تظهر الطلبات بجانب كل سيناريو):
- التلخيص: لكل مستند في مجلد "المستندات"، أنشئ ملف txt في المجلد نفسه باسم "summary_ORIGINAL_FILENAME.txt" يتضمّن ملخّصًا من 3 جمل للنقاط الرئيسية في المستند.
- التصنيف حسب النوع: يتم فحص جميع ملفات PDF وDOCX في هذا الدليل. انقل جميع الملفات التي تتضمّن كلمة "فاتورة" في اسمها أو محتواها إلى المجلد "الشؤون المالية/الفواتير". نقل الملفات التي تتضمّن كلمة "إيصال" إلى مجلد "المستندات المالية/الإيصالات" يتم نقل أي ملفات docx .أخرى إلى مجلد "التقارير".
- استخراج المعلومات الأساسية (و"وضع العلامات"): لكل ملف PDF في مجلد "المستندات المالية/الفواتير"، اقرأ محتواه. إذا عثرت على تاريخ، أعِد تسمية الملف لتضمين هذا التاريخ بالتنسيق YYYY-MM-DD، مثلاً، "invoice_2025-07-26_original_name.pdf".
تلخيص المقالات (الملفات المحلية أو الويب)
في كل سيناريو من السيناريوهات أدناه، يمكنك تغيير عنوان URL وموضوع الاهتمام وأسماء الملفات المحلية حسب الاقتضاء. أسماء الملفات المقدَّمة هي أسماء ملفات نموذجية، ويمكنك استبدالها بأسماء ملفات لديك على نظامك.
جرِّب أيًا من السيناريوهات التالية (تظهر الطلبات بجانب كل سيناريو):
- تلخيص مقالة على الويب (عنوان URL واحد): انتقِل إلى https://medium.com/google-cloud/antigravity-cli-tutorial-series-12b46cfe3bf2 ولخِّص أهم 3 نقاط رئيسية من هذه المقالة الإخبارية.
- تلخيص مقالات ويب متعددة (مثل تلك التي تظهر في نتائج البحث): ابحث عن أحدث المقالات الإخبارية حول "واجهة سطر الأوامر Antigravity" باستخدام "بحث Google". بالنسبة إلى أهم 5 مقالات ذات صلة، يجب تلخيص كل مقالة في جملتين أو ثلاث جمل وإدراج عناوين URL الخاصة بها.
- تلخيص ملف نصي محلي: لخِّص النقاط الرئيسية في المقالة في الملف my_research_paper.txt، مع التركيز على المنهجية والاستنتاجات.
- تلخيص ملف PDF محلي: اقرأ ملف financial_report_Q2_2025.pdf. قدِّم ملخّصًا للأداء المالي والتحديات الرئيسية المذكورة.
استخراج معلومات محدّدة (الملفات المحلية أو الويب)
في كل سيناريو من السيناريوهات أدناه، يمكنك تغيير عنوان URL وموضوع الاهتمام وأسماء الملفات المحلية حسب الاقتضاء. أسماء الملفات المقدَّمة هي أسماء ملفات نموذجية، ويمكنك استبدالها بأسماء ملفات لديك على نظامك.
جرِّب أيًا من السيناريوهات التالية (تظهر الطلبات بجانب كل سيناريو):
- استخراج الكيانات من مقالة محلية: من الملف biography.txt، أدرِج جميع الأشخاص المذكورين والتواريخ المهمة المرتبطة بهم.
- استخراج البيانات من جدول في ملف PDF: في الملف quarterly_sales.pdf، استخرِج البيانات من الجدول في الصفحة 3 الذي يعرض "مبيعات المنتجات حسب المنطقة" وقدِّمها بتنسيق جدول Markdown.
- استخراج عناوين الأخبار ومصادرها من موقع إلكتروني للأخبار: انتقِل إلى ‘https://news.google.com/’ (أو موقع إلكتروني مشابه للأخبار). استخرِج العناوين الرئيسية من الصفحة الأولى ومصادر الأخبار المقابلة لها، ثم اعرضها كقائمة نقطية.
- العثور على مواصفات المنتج من صفحة للتجارة الإلكترونية: انتقِل إلى "https://www.amazon.in/Google-Cloud-Certified-Associate-Engineer/dp/1119871441" (مثال على كتاب). استخرِج عنوان الكتاب والمؤلف والتفاصيل الأخرى. يجب عرض ذلك بتنسيق JSON منظَّم.
- استخراج المدة من فيديو بتنسيق معيّن (مثلاً "2h37m42s")
الإجابة عن الأسئلة استنادًا إلى المحتوى (سلوك مشابه لنموذج RAG)
في كل سيناريو من السيناريوهات أدناه، يمكنك تغيير عنوان URL وموضوع الاهتمام وأسماء الملفات المحلية حسب الاقتضاء. أسماء الملفات المقدَّمة هي أسماء ملفات نموذجية، ويمكنك استبدالها بأسماء ملفات لديك على نظامك.
جرِّب أيًا من السيناريوهات التالية (تظهر الطلبات بجانب كل سيناريو):
- سؤال وجواب حول مستند محلي: أرفقتُ الملف user_manual.pdf. ما هي خطوات تحديد مشاكل الاتصال بالشبكة وحلّها؟
- سؤال وجواب على صفحة ويب: استنادًا إلى المحتوى من الرابط"https://www.who.int/news-room/fact-sheets/detail/climate-change-and-health"، ما هي المخاطر الصحية الأساسية المرتبطة بتغيّر المناخ وفقًا لمنظمة الصحة العالمية؟
- مقارنة المعلومات من مصادر متعددة: لديّ مقالتان إخباريتان: article1.txt وarticle2.txt، وكلتاهما تناقشان التغييرات الأخيرة في السياسة الاقتصادية. قارِن بين وجهات نظرهم حول التأثير المحتمَل في الأنشطة التجارية الصغيرة.
إنشاء المحتوى استنادًا إلى المعلومات المستخرَجة
في كل سيناريو من السيناريوهات أدناه، يمكنك تغيير عنوان URL وموضوع الاهتمام وأسماء الملفات المحلية حسب الاقتضاء.
جرِّب أيًا من السيناريوهات التالية (تظهر الطلبات بجانب كل سيناريو):
- إنشاء موجز إخباري من مقالة: اقرأ @tech_innovation_article.txt. اكتب موجزًا إخباريًا قصيرًا وجذّابًا (حوالي 150 كلمة) مناسبًا للنشرة الإخبارية للشركة، مع تسليط الضوء على التكنولوجيا الجديدة وإمكاناتها.
- إنشاء مسودة رسالة إلكترونية تلخّص نص اجتماع: إليك ملف نص اجتماع: @meeting_transcript.txt. أنشئ مسودة رسالة إلكترونية للفريق تلخّص القرارات الرئيسية التي تم اتخاذها وبنود العمل التي تم تحديدها، بما في ذلك الجهة المسؤولة عن كل منها.
دعم الوسائط المتعددة في Antigravity CLI
تتيح أداة Antigraity CLI استخدام نماذج متعددة من خلال Gemini، ويمكنك أن تطلب منها معالجة ملفات بتنسيقات محتوى مختلفة وفقًا لمتطلباتك.
ستعالج مجموعة من صور الفواتير باستخدام Antigraity CLI وتستخرج منها المعلومات الرئيسية. يُرجى اتّباع الخطوات التالية:
- أنشئ مجلدًا على جهازك ونزِّل بعض الفواتير من المستودع التالي على GitHub.
- تشغيل Antigravity CLI من هذا المجلد
قدِّم الطلب التالي لاستخراج المعلومات من الفواتير في شكل جدول.
The current folder contains a list of invoice files in Image format. Go through all the files in this folder and extract the following invoice information in the form of a table: Invoice No, Invoice Date, Invoice Sent By, Due Date, Due Amount.
من المفترض أن تحصل على نتيجة تبدو على النحو التالي:
إليك سيناريو آخر يمكنك فيه طلب أعمدة مشتقة إضافية. لنفترض أنّك تريد عرض رمز تعبيري على شكل صليب أحمر لجميع تواريخ استحقاق الفواتير السابقة. يمكنك تقديم طلب على النحو التالي:
list all files with .png extension in this folder. Extract the invoice information from it by reading them locally and display it in a table format containing the following column headers: : Invoice No, Invoice Date, Invoice Sent By, Due Date, Due Amount. Add a column at the end of the table that shows a red cross emoji in case the due date is in the past.
يؤدي ذلك إلى ظهور الناتج التالي:
يمكنك تطبيق ذلك على أي من ملفاتك بتنسيقات أخرى غير النص.
استخدام Antigravity CLI لإنشاء البيانات
يمكنك أن تطلب من Antigravity CLI إنشاء بيانات بتنسيقات مختلفة، بدءًا من قطع المحتوى وصولاً إلى بيانات JSON التي قد تحتاج إلى محاكاتها. لنركّز هنا على السيناريوهات التي تنطبق على المطوّرين/المختبِرين.
في ما يلي بعض الطلبات التي يمكنك تجربتها:
إنشاء بيانات JSON لعينات من مراجعات العملاء
Generate a JSON array of 3 synthetic customer reviews for a new smartphone. Each review should have 'reviewId' (string, UUID-like), 'productId' (string, e.g., 'SMARTPHONE_X'), 'rating' (integer, 1-5), 'reviewText' (string, 20-50 words), and 'reviewDate' (string, YYYY-MM-DD format).
إنشاء ردود وهمية من واجهة برمجة التطبيقات (JSON)
Generate a JSON array representing 7 daily sales records for a mock API endpoint. Each record should include 'date' (YYYY-MM-DD, chronologically increasing), 'revenue' (float, between 5000.00 and 20000.00), 'unitsSold' (integer, between 100 and 500), and 'region' (string, either 'North', 'South', 'East', 'West').
إنشاء عبارات إدراج قاعدة بيانات نموذجية (SQL)
Generate 5 SQL INSERT statements for a table named 'users' with columns: 'id' (INTEGER, primary key), 'username' (VARCHAR(50), unique), 'email' (VARCHAR(100)), 'password_hash' (VARCHAR(255)), 'created_at' (DATETIME, current timestamp). Ensure the password_hash is a placeholder string like 'hashed_password_X'.
إنشاء بيانات CSV لتحميل البيانات/تحليلها
Generate 10 lines of CSV data, including a header row, for customer transactions. Columns should be: 'TransactionID' (unique string), 'CustomerID' (integer), 'ItemPurchased' (string, e.g., 'Laptop', 'Monitor', 'Keyboard'), 'Quantity' (integer, 1-3), 'UnitPrice' (float, between 100.00 and 1500.00), 'TransactionDate' (YYYY-MM-DD).
إنشاء ملف إعدادات (YAML)
Generate a sample YAML configuration for a 'user_service'. Include sections for 'database' with 'host', 'port', 'username', 'password', 'database_name'. Also include a 'api_keys' section with 'payment_gateway' and 'email_service' placeholders. Use realistic default values.
إنشاء بيانات اختبار للحالات الحدّية/التحقّق من الصحة
Generate a JSON array of 8 email addresses for testing purposes. Include a mix of: 2 valid standard emails, 2 with missing '@', 2 with invalid domains (e.g., '.com1'), and 2 with special characters in the local part that are usually invalid (e.g., spaces or multiple dots).
9- تهانينا
تهانينا، لقد استكشفتَ بنجاح واجهة سطر الأوامر Antigravity وإمكاناتها وطبّقتها على بعض حالات الاستخدام.