Antigravity CLI 基础教程 (Tutorial)

学习如何启动 Antigravity CLI，与自主本地 Agent 协同工作，审查生成的文件，并执行终端测试命令。

概述 (Overview)

本指南将引导您完成快速入门练习。您将指挥一个自主 Agent 创建一个 Python 实用工具脚本，审查其更改并验证其执行结果。

逐步指南 (Step-by-step)

1. 创建干净的项目目录并启动 Antigravity TUI

mkdir agy-demo && cd agy-demo
agy

[!NOTE] 首次启动：如果首次运行 agy，请按照终端指令完成静默验证。如果遇到问题，请参阅 安装与身份验证 (Installation & Auth) 以获取故障排除详情。

2. 提示 Agent 生成一个 Python 爬取脚本

在屏幕底部的 Prompt 输入框中输入以下指令并按回车键：

Write a simple python script to fetch web page text

Agent 会读取工作空间，确定没有任何文件存在，并制定一个创建脚本的计划。随着 Agent 进行推理并安排操作，您将看到实时的状态更新。

3. 打开 Artifact 审查屏幕以检查提议的代码

一旦 Agent 完成文件的生成，终端将出现通知提示。按 Ctrl + R 进入 Artifact Review 审查屏幕。

1. 使用 ↑/↓ 键导航到新创建 of the main.py。
2. 审查完整的文件内容和代码差异（diff）。
3. 按 y 批准创建 main.py。
4. 按 Esc 关闭审查面板并返回主对话界面。

4. 与 Agent 一起执行测试命令以验证输出

指示 Agent 运行 Python 脚本以验证其行为。在输入框中输入以下命令并按回车键：

Run the python script and show me the output

Agent 将提议运行 python3 main.py。按 y 确认并执行命令。Agent 会在本地运行该脚本，并将标准输出直接流式传输到您的终端屏幕中。

5. 退出 Antigravity 会话

完成任务后，在输入框中按 Ctrl + D（或输入 /exit）关闭 TUI 并恢复您原始的 Shell 会话。

后续步骤 (Next steps)

Now that you have executed your first agent-assisted workflow, learn how to configure the CLI and master core concepts:

• 安装与身份验证 (Installation & Auth)：关于安装 agy 和设置 SSH 配置文件的详细说明。
• Prompting & 交互：多行输入、粘贴媒体文件和主动中断控制的最佳实践。
• 审查 Artifacts：深入了解“基于透明度的信任 (Trust through Transparency)”架构模式。