Install, sign in, make one bounded change, and prove it works.
Finish with: An installed, authenticated Antigravity CLI workspace with rules, a verified Python change, a headless read-only check, and a practiced recovery path.
Progress stays in this browser. Export to keep a portable record.
BuildBotsBetterA step demonstration outline; use optional narration while you follow it.
This browser checks the evidence format and your checklist. It cannot inspect your computer or certify a live login.
You have recorded evidence for every step. Repeat the core task from a fresh input and export your results. Review the source, account and platform limits before using the workflow on real work.
Repeat the last product-specific checkpoint from a fresh practice input, preserve actual output, then complete the Build Bot Better guard and restore checks. Export the evidence.
Sources checked 2026-10-05. Native installers and Linux/npm prerequisite paths need clean-machine verification; see test receipts. macOS commands have not been run on a real Mac. Human sign-in and paid-plan eligibility cannot be certified without the learner’s account. Do not assign an A/fully verified setup grade until a real clean install and sign-in walk is complete.
Source-owned text for offline reading and retrieval. Command success still requires actual local evidence.
Open the linked official source. Verify the product name Antigravity CLI, your OS/architecture, and the account option available to you. Record the path you will use before installing.
Expected: The product, platform and eligible sign-in route are recorded; no plan upgrade is required by this course.
Download the resource ZIP at the top of this Build. Extract it into a new folder you own (for example C:\BBBPractice on Windows, or ~/bbb-practice on macOS/Linux). Open a terminal in the extracted folder. Run the version command for your platform. All subsequent commands assume this folder.
Expected: Python reports version 3.10 or newer and the terminal is in the extracted resource folder.
python --version
Get-Location
Get-ChildItempython3 --version
pwd
lspython3 --version
pwd
lsFor an npm route, install a current Node.js LTS from nodejs.org first. Run node --version and npm --version; Qwen Code needs Node.js 22+. For a native installer, verify the shell and curl (macOS/Linux), and check the official platform prerequisites. Do not run a macOS/Linux script directly in native PowerShell.
Expected: The required runtime and shell are available; the directory is the extracted practice workspace.
node --version
npm.cmd --version
Get-Locationnode --version
npm --version
pwd
command -v curlnode --version
npm --version
pwd
command -v curlInspect the installer source or package publisher on the official page, then execute the command card for your platform. Reopen the terminal if PATH changed. Save the version output; do not run elevated npm unless the official package specifically requires it.
Expected: The agy version command exits successfully and prints a version.
irm https://antigravity.google/cli/install.ps1 | iex
agy --versioncurl -fsSL https://antigravity.google/cli/install.sh | bash
agy --versioncurl -fsSL https://antigravity.google/cli/install.sh | bash
agy --versionRun agy. If there is no saved keyring session, complete the Google account browser sign-in yourself. A remote terminal may print a URL and ask you to paste the browser authorization code into the CLI, not this evidence form. Confirm eligibility in the actual tool.
Expected: The CLI is authenticated to your own account and accepts an interactive prompt; no credential is stored in the practice files.
agyagyagyOpen GEMINI.md in the resource folder and replace the workspace sentence with your real path. Start agy there. Ask the agent to list its rules, summarize app.py and say which files it may modify.
Expected: The agent names GEMINI.md, the practice path, the bounded scope and the verification command.
Read GEMINI.md and app.py. Summarize your permitted workspace, prohibited actions and the verification command. Do not change anything.Ask Antigravity CLI to add a docstring to total in app.py, keeping behavior unchanged. Require the agent to run verify.py and show the minimal diff. Review that only app.py changed, then run the command independently.
Expected: VERIFY PASS covers empty, ordinary, signed and repeated inputs; only the requested docstring changed.
python verify.pypython3 verify.pypython3 verify.pyRun the diagnostic command, then the CLI’s --help. Record the rules/settings locations and approval mode available in this installed version. Keep the ordinary permission prompts. For Qwen, inspect approval modes and --allowed-tools locally before using any flag.
Expected: The effective configuration and permission mode are recorded; unexpected writes need review.
agy --help
agy --helpagy --help
agy --helpagy --help
agy --helpInspect --help for the headless command. Use the card to request only an explanation of app.py. Save stdout and the exit code. Headless mode still consumes provider usage and must not be treated as a free sandbox.
Expected: The output accurately describes sum(items), the process exits 0, and app.py is unchanged.
agy -p "Read app.py and explain total. Do not edit files or run commands."agy -p "Read app.py and explain total. Do not edit files or run commands."agy -p "Read app.py and explain total. Do not edit files or run commands."Inspect the CLI’s help/configuration for MCP or tool extensions. Write the name of one needed tool, the exact directory/data it would expose, and the permission needed. Add no server until you review that scope. Qwen users inspect current MCP/multi-directory help instead of assuming older --mcp-config flags still exist.
Expected: One connector plan contains purpose, scoped data, permissions, verification and a removal plan.
Use incident-template.md to document one real or deliberately introduced missing-file error in the practice project. Ask the agent to diagnose from the exact command, path and error, then repair only the practice input and rerun verification.
Expected: The incident contains the failure, one supported diagnosis, smallest fix and VERIFY PASS after recovery.
python verify.pypython3 verify.pypython3 verify.pyFill onboarding-checklist.md for Antigravity CLI. Rules: GEMINI.md. Memory/settings: ~/.gemini and the OS keyring (Windows: %USERPROFILE%\.gemini). Guard: ~/.gemini/config/hooks.json uses its own hook JSON protocol; command paths must be parsed correctly. Inspect the linked BBB safety reference. Record permissions, backup schedule, restore and final verification.
Expected: The checklist contains a concrete path and owner for rules, memory, permissions, guard, backup, restore and final verification.
Run workspace_guard.py --self-test. Read the source: the target is resolved before deciding. The variable_target case points at the home folder but performs no filesystem operation. Compare this with a hook that sees only command text.
Expected: GUARD PASS reports inside allowed and profile, outside, variable-derived profile and workspace root denied; no deletion was executed.
python workspace_guard.py --self-testpython3 workspace_guard.py --self-testpython3 workspace_guard.py --self-testFor CLI tools, open the hook/permissions screen and confirm the configured guard is active. Use your tool’s documented pre-command hook protocol; the BBB working reference is linked in Sources. Run a harmless directory listing, then a guard dry-run targeting the profile. Do not execute a destructive profile probe. Grok Bot has no proven local shell guard here: use project-only tasks and reviewed actions, with backups.
Expected: A harmless command runs, the guard dry-run returns DENY, and the checklist records the actual hook protocol and active state or the Grok Bot limitation.
Connect a second backup drive. Windows: configure System Protection as additional recovery and use a scheduled copy/File History that explicitly includes hidden agent folders. macOS: configure Time Machine and verify dot folders are included. Linux: use a home backup such as restic/Deja Dup; Timeshift omits /home by default. Download the copy-only profile backup script for your platform, inspect it, and adapt the folder list to your tool. Record the last successful scheduled run; protect backup access because it may contain credentials.
Expected: A backup on another drive includes the tool’s user settings and memory folder and this project, and a successful schedule/time is recorded.
.\profile-backup.ps1 -Destination D:\Backups\llm-profilesbash profile-backup.sh /Volumes/YourBackup/llm-profilesbash profile-backup.sh /media/YourBackup/llm-profilesRun restore_drill.py with a separate backup directory. The script creates a new proof file, copies it, restores a second copy, and compares SHA256 hashes. Then restore one non-secret file from your actual agent memory backup into a separate scratch directory and open it; do not overwrite the live profile.
Expected: RESTORE PASS contains matching hashes; the actual memory file is readable after restoration into scratch.
python restore_drill.py --backup-root D:\Backups\bbb-practice --work-root practicepython3 restore_drill.py --backup-root /Volumes/YourBackup/bbb-practice --work-root practicepython3 restore_drill.py --backup-root /media/YourBackup/bbb-practice --work-root practiceClose the CLI normally. Reopen a terminal in this extracted folder. Run agy (or start a new session if the installed help lists a different continuation option). Ask it to reread GEMINI.md and summarize the last verification. Run verify.py independently again.
Expected: The correct workspace/rules are active after restart and VERIFY PASS is reproducible.
agy
# After returning to your terminal:
python verify.pyagy
# After returning to your terminal:
python3 verify.pyagy
# After returning to your terminal:
python3 verify.py