۱. مقدمه
در این آزمایشگاه کد، شما با Antigravity CLI، یک رابط کاربری ترمینال (TUI) سبک برای Antigravity، آشنا خواهید شد. این رابط، همان قابلیتهای اصلی عامل Antigravity 2.0 (مانند استدلال چند مرحلهای، ویرایش چند فایلی، فراخوانی ابزار و تاریخچه مکالمه) را مستقیماً به ترمینال شما میآورد.
آنچه یاد خواهید گرفت
- نصب و پیکربندی Antigrabity CLI
- آشنایی با کاربردهای اولیهی رابط خط فرمان Antigravity
- بررسی چند مورد استفاده با Antigravity CLI
آنچه نیاز دارید
شما به موارد زیر نیاز خواهید داشت:
- مرورگر وب کروم
- یک حساب جیمیل
این آزمایشگاه کد، برای کاربران و توسعهدهندگان در تمام سطوح (از جمله مبتدیان) طراحی شده است. موارد استفاده در آزمایشگاه کد به وظایف توسعهدهنده و غیر توسعهدهنده طبقهبندی شدهاند. موارد استفاده توسعهدهنده، نحوهی کدنویسی با Antigravity CLI و کار با مخزن GitHub را برای انجام وظایف رایج توسعه مانند توضیح/درک کد، تولید مستندات، رفع مشکلات و موارد دیگر نشان میدهد. توصیه میشود این موارد استفاده را در آزمایشگاه کد تکمیل کنید. در انتها یک بخش اختیاری وجود دارد که چندین کار روزمره را که متمرکز بر غیر توسعهدهنده هستند، پوشش میدهد.
۲. قبل از شروع
ایجاد یک پروژه
- در کنسول گوگل کلود ، در صفحه انتخاب پروژه، یک پروژه گوگل کلود را انتخاب یا ایجاد کنید.
- مطمئن شوید که صورتحساب برای پروژه ابری شما فعال است. یاد بگیرید که چگونه بررسی کنید که آیا صورتحساب در یک پروژه فعال است یا خیر .
- شما از Cloud Shell ، یک محیط خط فرمان که در Google Cloud اجرا میشود و bq از قبل روی آن بارگذاری شده است، استفاده خواهید کرد. روی Activate Cloud Shell در بالای کنسول Google Cloud کلیک کنید.
- پس از اتصال به Cloud Shell، با استفاده از دستور زیر بررسی میکنید که آیا از قبل احراز هویت شدهاید و پروژه روی شناسه پروژه شما تنظیم شده است یا خیر:
gcloud auth list
- دستور زیر را در Cloud Shell اجرا کنید تا تأیید شود که دستور gcloud از پروژه شما اطلاع دارد.
gcloud config list project
- اگر پروژه شما تنظیم نشده است، از دستور زیر برای تنظیم آن استفاده کنید:
gcloud config set project <YOUR_PROJECT_ID>
۳. نصب
قبل از انجام تنظیمات و اجرای Antigravity CLI، بیایید یک پوشه ایجاد کنیم که از آن به عنوان پوشه اصلی برای تمام پروژههایی که درون آن ایجاد میکنیم استفاده خواهیم کرد. این یک نقطه شروع برای کار Antigravity CLI است، اگرچه به برخی پوشههای دیگر روی سیستم شما نیز اشاره خواهد کرد که در صورت نیاز بعداً به آنها مراجعه خواهید کرد.
یک پوشه نمونه ( agy-cli-projects ) ایجاد کنید و از طریق دستورات نشان داده شده در زیر به آن بروید. اگر ترجیح میدهید از نام پوشه دیگری استفاده کنید، لطفاً این کار را انجام دهید.
mkdir agy-cli-projects
بیایید به آن پوشه برویم:
cd agy-cli-projects
نصب آن سرراست است و فایلهای باینری آن در سیستمعاملهای اصلی موجود است. من دستورات لازم برای اجرا در ترمینال را مستقیماً از سند نصب گرفتهام:
مک او اس | لینوکس
curl -fsSL https://antigravity.google/cli/install.sh | bash
ویندوز پاورشل
irm https://antigravity.google/cli/install.ps1 | iex
سی ام دی ویندوز
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
در حالت ایدهآل، این باید رابط خط فرمان Antigravity ( 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]
فعلاً از حساب شخصی خود استفاده کنید. گزینه ۱. Google OAuth را انتخاب کنید و Enter را بزنید. با این کار یک مرورگر باز میشود و میتوانید با حساب گوگل خود وارد شوید. پس از احراز هویت و مجوز موفقیتآمیز، از شما خواسته میشود یک کد را کپی کنید. لطفاً به ترمینال Antigravity CLI برگردید و کد را جایگذاری کنید.
پس از موفقیت آمیز بودن ورود، چند اتفاق میافتد:
- در ابتدا، از شما در مورد تم رنگی که میخواهید برای Antigravity CLI انتخاب کنید، همانطور که در زیر نشان داده شده است، سوال میشود. تم مورد نظر خود را انتخاب کنید.
- در مرحله بعد، باید چند مورد از شرایط خدمات را بپذیرید. آنها را بپذیرید.
در نهایت، مهمترین چیز این است که اجازه دهید پوشه مورد اعتماد شما باشد، همانطور که در زیر نشان داده شده است:
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 CLI را در آن اجرا کنید، خواهید دید. بعداً در این مجموعه بیشتر به این موضوع خواهیم پرداخت، اما فعلاً، بگویید بله، من به این پوشه اعتماد دارم .
تبریک! اکنون همه چیز آماده است و 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 انجام دهید یا میتوانید در جلسه ترمینال تعاملی Antigravity CLI دو بار ctrl+d را فشار دهید.
۵. رابط خط فرمان ضد جاذبه - چند دستور برای مدیریت خانه
مطمئن شوید که 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
تنظیمات.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 برای کار با این فایل استفاده کنید.
مجوز ابزار
یکی از تنظیمات مهمی که باید درک شود، مجوز ابزار (Tool Permission) است. این تنظیم کنترل میکند که آیا دستورات ترمینال قبل از اجرا نیاز به تأیید شما دارند یا خیر. میتوانید از طریق دستور /config به این بخش دسترسی پیدا کنید.
Tool Permission
> request-review (current)
proceed-in-sandbox
always-proceed
strict
به طور پیشفرض، روی request-review تنظیم شده است. بیایید این را با جزئیات بیشتری درک کنیم. در Antigravity، تنظیمات مجوز ابزار، تعادل بین امنیت (محافظت از سیستم میزبان شما در برابر تغییرات ناخواسته) و سرعت (میزان خودمختاری عامل بدون مکث برای ورودی شما) را کنترل میکند. بیایید گزینهها را بررسی کنیم:
درخواست-بررسی (پیشفرض فعلی)
در این حالت، با عامل به عنوان یک شریک مشارکتی رفتار میشود که قبل از انجام هر عملی که میتواند بر سیستم یا فایلهای پروژه شما خارج از محدودههای از پیش تأیید شده تأثیر بگذارد، بررسی میکند. هر زمان که عامل سعی کند یک دستور ترمینال را اجرا کند، یک عملیات فایل (مانند نوشتن/حذف) انجام دهد یا یک سرویس خارجی را در جایی که مجوز از پیش تأیید نشده است، فراخوانی کند، اجرا متوقف میشود. از کاربر خواسته میشود که عمل خاص را تأیید یا رد کند.
ادامه در سندباکس
این حالت به عامل اجازه میدهد تا دستورات ترمینال را به طور خودکار اجرا کند، اما در یک کانتینر امن و ایزوله. عامل میتواند دستورات را بدون درخواست شما اجرا کند، اما این دستورات در یک جعبه شنی مجازی (مثلاً یک کانتینر سبک) اجرا میشوند. آنها نمیتوانند سیستم فایل دستگاه میزبان واقعی شما را تغییر دهند یا به شبکه محلی شما دسترسی پیدا کنند.
همیشه ادامه بده
این حالت کاملاً خودکار است و به عامل حداکثر سرعت و قابلیت را میدهد. به عامل اجازه کامل برای اجرای دستورات و نوشتن فایلها مستقیماً روی دستگاه میزبان شما داده میشود. هرگز از شما تأییدیه نمیخواهد.
سختگیر
این یک حالت با امنیت بالا و بدون نیاز به اعتماد (zero-trust) است. قابلیتهای عامل (agent) به اجرای ابزارهای خواندنی (read tools) محدود شده است. تمام ابزارهای غیر خواندنی (non-read tools) نیاز به درخواست از کاربر برای انجام کاری دارند.
۶. رابط خط فرمان ضد جاذبه - پارامترهای فرمان
چند پارامتر خط فرمان وجود دارد که میتوان هنگام شروع Antigravity CLI ارائه داد. برای دریافت لیست کامل گزینهها، میتوانید از --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 در حالت غیر تعاملی است. این بدان معناست که شما مستقیماً به آن اعلان (prompt) میدهید و بدون باز شدن ترمینال تعاملی 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) را از طریق دستور زیر اجرا کنید:
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.
این حالت میتواند در سناریوهایی مفید باشد که همه چیز محلی و تحت کنترل شماست، اما همچنان برای غافلگیریها آماده هستید و از این رو با احتیاط از آن استفاده کنید.
۷. رابط خط فرمان ضد جاذبه - حالت پوسته
الان زمان خوبی برای یادگیری نحوه کار مستقیم با Shell از داخل Antigravity CLI است. میتوانید با فشار دادن ! در کادر پیام، به حالت shell بروید. این کار شما را به حالت Shell تغییر میدهد. میتوانید با فشار دادن دوباره ! یا زدن کلید ESC به حالت اولیه برگردید.
وقتی در حالت shell هستید، علامت ! را در ابتدای اعلان فرمان، مطابق شکل زیر، مشاهده خواهید کرد:
شما میتوانید مستقیماً با استفاده از دستورات استاندارد مانند pwd و ls همانطور که در زیر نشان داده شده است، بررسی کنید. لطفاً توجه داشته باشید که این دستورات فرض میکنند سیستم عامل از نوع لینوکس است. اگر از سیستم عامل دیگری (ویندوز) استفاده میکنید، لطفاً از دستورات معادل مانند ( cd ، dir و type ) استفاده کنید.
۸. از موارد برای امتحان کردن استفاده کنید
رابط خط فرمان آنتیگراویتی (Antigravity CLI) میتواند در طیف گستردهای از موارد استفاده، چه برای توسعهدهندگان و چه برای غیر توسعهدهندگان، اعمال شود. در اینجا چند سناریو ارائه شده است و بسته به حوزه مورد علاقهتان، میتوانید هر یک یا همه آنها را امتحان کنید.
در هر یک از این موارد، دستورالعملی ارائه شده است. شما میتوانید این را در حالت تعاملی Antigravity CLI امتحان کنید تا بهتر بفهمید که Antigravity CLI چگونه وظیفه خود را انجام میدهد.
کدنویسی Vibe با Antigravity CLI
بیایید از Antigravity CLI برای کدنویسی vibe یک برنامه استفاده کنیم. در این کار، از Antigravity CLI میخواهید که یک برنامه تولید کند و سپس نسخه اولیه را به یک مخزن GitHub ارسال کند.
پیشنیاز
برای انجام وظایف این بخش، چند پیشنیاز وجود دارد:
- گیت
- رابط خط فرمان ضد جاذبه
- محیط پایتون ۳
- راهاندازی
gh( ابزار خط فرمان گیتهاب ). - آشنایی با اصول اولیه گیت و کمی دانش برنامهنویسی
فرض میکنیم که شما 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
وقت آن رسیده که بفهمیم مصنوعات در Antigravity چه هستند. مصنوعات به ما کمک میکنند تا رابط خط فرمان Antigravity ما را در جریان برنامه پیادهسازی، فهرست وظایفی که روی آنها کار میکند، خروجیهای قابل تأیید و موارد دیگر قرار دهد. این فایلها تولید میشوند و سابقهای از کاری که Antigravity انجام میدهد، برنامه، فهرست وظایف و موارد دیگر آن هستند.
وقتی این کار را انجام داد، میگوید: «من فایل implementation_plan.md را برای ترسیم طراحی و معماری برنامه وب BigQuery Release Notes ایجاد کردهام. لطفاً طرح، به خصوص رویکرد مربوط به Twitter Composer & Preview Card را بررسی کنید و در صورت تأیید یا هرگونه تنظیماتی که میخواهید انجام دهید، به من اطلاع دهید!»
میتوانید ببینید که در پایین سمت راست نیز اشاره میکند که ۱ مصنوع برای بررسی وجود دارد و در این مورد، آن implementation_plan.md است.
دستور /artifact را اجرا کنید. این دستور، مصنوعاتی را که implementation_plan.md تولید کرده است، نمایش میدهد و میتوانید از کلیدهای جهتنما برای باز کردن، تأیید، رد کردن و غیره استفاده کنید. فقط Escape کنید و به اعلان برگردید، در اینجا میتوانید در صورت تمایل آن را تأیید کنید.
در مورد ما، ما قصد داریم با آنچه تولید شده است پیش برویم و آن را تأیید کنیم. این مرحله، مجموعه مراحل بعدی را آغاز میکند، که در آن پیادهسازی یعنی ایجاد فایلها، اجرای چند دستور و غیره آغاز میشود. از شما خواسته میشود که در صورت لزوم، آن را تأیید کرده و اجازه اجرا را بدهید.
در مورد ما، ما به آن اجازه دادیم تا محیط مجازی پایتون را ایجاد کند، وابستگیها را از طریق requirements.txt نصب کند و غیره.
در پسزمینه، یک فایل task.md نیز به عنوان بخشی از وظایفی که باید بر اساس طرح پیادهسازی انجام دهد، ایجاد کرده است و وظایف جداگانه را با تکمیل آنها علامتگذاری میکند. پس از تکمیل، به شما اطلاع میدهد و میتوانید برنامه را در مرورگر بررسی کنید. در اینجا چیزی است که برای ما ایجاد شده است:
فعلاً میتوانیم متوقف شویم. ایده این بود که نشان دهیم و بررسی کنیم که با نیازهای ساده چه کاری میتواند انجام دهد.
(اختیاری) تغییرات را به مخزن گیتهاب ارسال کنید
اگر نمیخواهید وبسایت رویدادی که ایجاد کردهایم را به گیتهاب منتقل کنید، میتوانید این بخش را نادیده بگیرید و به بخش بعدی بروید.
اول از همه، بیایید یک فایل .gitignore ایجاد کنیم و میتوانید از Antigravity CLI کمک بگیرید.
Create a .gitignore file for this project.
مرحله بعدی برای شما این است که به Antigravity CLI دستور دهید تا این مخزن را تحت حساب GitHub ما قرار دهد و این باید از Github helper (gh) که انتظار میرود در دستگاه شما موجود و پیکربندی/تنظیم شده باشد، استفاده کند. ابزارهای GitHub MCP Server در پسزمینه.
یک درخواست مشابه درخواست زیر بدهید:
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
در اینجا تعدادی دستور را طی خواهد کرد:
- مخزن را ایجاد کنید.
- این برنامه از چندین دستور گیت شامل init، add و commit برای مدیریت مخزن محلی گیت استفاده خواهد کرد.
- سپس ریموت گیت را تنظیم کرده و یک push انجام میدهد.
اگر همه چیز خوب پیش برود، باید یک مخزن گیتهاب داشته باشید. میتوانید از صفحه مخزن گیتهاب دیدن کنید. یک نمونه تصویر در زیر نشان داده شده است:
توجه داشته باشید که شما برای این پروژه README.md ایجاد نکردهاید و این تمرین خوبی برای بخش بعدی است، جایی که اکنون با این مخزنی که شما ایجاد کردهاید کار خواهیم کرد.
استفاده از Antigravity CLI برای کار با مخزن کد
در این مورد استفاده، شما باید از Antigravity CLI برای کار با یک مخزن کد استفاده کنید. شما چندین کار انجام خواهید داد که شامل موارد زیر است:
- درک پایه کد
- تولید مستندات
- پیادهسازی یک ویژگی جدید
این باید پایه خوبی برای کار با مخازن شما و استفاده از Antigravity CLI به عنوان دستیار در مقابل این وظایف خاص توسعهدهنده باشد.
پیشنیاز
برای انجام وظایف این بخش، به موارد زیر نیاز دارید:
- رابط خط فرمان ضد جاذبه
- شما باید بخش قبلی را تکمیل کرده باشید و کدی که تولید شده است را در دسترس داشته باشید، جایی که ما یک خواننده یادداشتهای انتشار BigQuery ایجاد کردیم.
بیایید به استفاده از Antigravity CLI از پوشه/دایرکتوری که برای تولید برنامه BigQuery Release Notes استفاده کردید، ادامه دهیم.
دستورالعملهای زیر را مطابق آنچه در زیر آمده است، امتحان کنید:
درک پایه کد
- میخواهم این پروژه را با جزئیات درک کنم. به من کمک کنید تا ویژگیهای اصلی را درک کنم و سپس آن را به سمت سرور و کلاینت تقسیم کنم. یک نمونه از جریان کار را در نظر بگیرید و نحوه عملکرد درخواست و پاسخ را به من نشان دهید. توجه داشته باشید که این کار یک فایل جدید (artifact) ایجاد میکند و شما میتوانید تمام مصنوعات یا مصنوعات خاص را از طریق دستور **
/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 اغلب قبل از اجرای دستورات، به خصوص آنهایی که سیستم فایل شما را تغییر میدهند (مانند نوشتن، انتقال یا حذف فایلها)، از شما اجازه میخواهد. همیشه قبل از اعطای مجوز، این درخواستها را با دقت بررسی کنید. این شبکه امنیتی شماست.
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» ایجاد کنید که شامل خلاصهای ۳ جملهای از نکات اصلی سند باشد.
- دستهبندی بر اساس نوع: تمام فایلهای PDF و DOCX موجود در این پوشه را اسکن کنید. تمام فایلهایی که نام یا محتوای آنها «فاکتور» است را به پوشه «مالی/فاکتورها» منتقل کنید. فایلهایی که «رسید» دارند را به «مالی/رسیدها» منتقل کنید. سایر فایلهای .docx به «گزارشها» میروند.
- استخراج اطلاعات کلیدی (و "برچسبگذاری"): برای هر فایل PDF در پوشه 'Financial/Invoices'، محتوای آن را بخوانید. اگر تاریخی پیدا کردید، نام فایل را تغییر دهید تا آن تاریخ را با فرمت YYYY-MM-DD شامل شود، مثلاً 'invoice_2025-07-26_original_name.pdf'.
خلاصهسازی مقالات (فایلهای محلی یا وب)
برای هر یک از سناریوهای زیر، میتوانید آدرس اینترنتی (url)، موضوع مورد علاقه و نام فایلهای محلی را در صورت لزوم تغییر دهید. نام فایلهای ارائه شده، نام فایلهای نمونه هستند، میتوانید آنها را با نام فایلهایی که در سیستم خود دارید جایگزین کنید.
هر یک از سناریوهای زیر را امتحان کنید (دستورالعملها در کنار هر سناریو داده شدهاند):
- خلاصه کردن یک مقاله وب (یک URL): به https://medium.com/google-cloud/antigravity-cli-tutorial-series-12b46cfe3bf2 بروید و 3 نکته کلیدی برتر این مقاله خبری را خلاصه کنید.
- خلاصه کردن چندین مقاله وب (مثلاً از یک جستجو): با استفاده از جستجوی گوگل، جدیدترین مقالات خبری در مورد "Antigravity CLI" را پیدا کنید. برای 5 مقاله برتر مرتبط، هر کدام را در 2-3 جمله خلاصه کنید و URL های آنها را فهرست کنید.
- خلاصه کردن یک فایل متنی محلی: نکات اصلی مقاله را در فایل 'my_research_paper.txt' خلاصه کنید. روی روششناسی و نتیجهگیری تمرکز کنید.
- خلاصهای از یک فایل PDF محلی: فایل «financial_report_Q2_2025.pdf» را مطالعه کنید. خلاصهای از عملکرد مالی و چالشهای کلیدی ذکر شده را ارائه دهید.
استخراج اطلاعات خاص (فایلهای محلی یا وب)
برای هر یک از سناریوهای زیر، میتوانید آدرس اینترنتی (url)، موضوع مورد علاقه و نام فایلهای محلی را در صورت لزوم تغییر دهید. نام فایلهای ارائه شده، نام فایلهای نمونه هستند، میتوانید آنها را با نام فایلهایی که در سیستم خود دارید جایگزین کنید.
هر یک از سناریوهای زیر را امتحان کنید (دستورالعملها در کنار هر سناریو داده شدهاند):
- استخراج موجودیتها از یک مقاله محلی: از 'biography.txt'، تمام افراد نامبرده و تاریخهای مهم مرتبط با آنها را فهرست کنید.
- استخراج دادهها از جدول در فایل PDF: در فایل 'quarterly_sales.pdf'، دادهها را از جدول صفحه ۳ که «فروش محصول بر اساس منطقه» را نشان میدهد، استخراج کرده و آن را در قالب جدول 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 را بخوانید. یک خلاصه خبری کوتاه و جذاب (حدود ۱۵۰ کلمه) مناسب برای خبرنامه شرکت بنویسید و فناوری جدید و پتانسیل آن را برجسته کنید.
- پیشنویس ایمیلی حاوی خلاصه متن جلسه: فایل متن جلسه به آدرس @meeting_transcript.txt است. پیشنویس ایمیلی را برای تیم تهیه کنید که در آن خلاصهای از تصمیمات کلیدی گرفته شده و موارد اجرایی تعیین شده، از جمله اینکه چه کسی مسئول هر یک از آنهاست، ارائه شود.
پشتیبانی چندوجهی رابط خط فرمان ضد جاذبه (Antigravity CLI)
رابط خط فرمان آنتیگرایتی (Antigraity CLI) از طریق Gemini از چند مدل پشتیبانی میکند و میتوانید از آن بخواهید فایلهایی با فرمتهای مختلف محتوا را طبق نیاز شما پردازش کند.
شما قصد دارید تعدادی تصویر فاکتور را با Antigraity CLI پردازش کرده و اطلاعات کلیدی را از آنها استخراج کنید. مراحل زیر را دنبال کنید:
- یک پوشه روی دستگاه خود ایجاد کنید و چند فاکتور را از مخزن GitHub زیر دانلود کنید.
- Antigraity 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).
تولید پاسخهای API آزمایشی (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).
۹. تبریک
تبریک میگویم، شما با موفقیت Antigravity CLI، قابلیتهای آن را بررسی کردید و آن را در چند مورد استفاده به کار بردید.