picoclaw/docs/ANTIGRAVITY_USAGE.md

Using Antigravity Provider in PicoClaw

This guide explains how to set up and use the Antigravity (Google Cloud Code Assist) provider in PicoClaw.

Prerequisites

1. A Google account.
2. Google Cloud Code Assist enabled (usually available via the "Gemini for Google Cloud" onboarding).

1. Authentication

To authenticate with Antigravity, run the following command:

picoclaw auth login --provider antigravity

• This will open a browser window for Google OAuth.
• After successful login, it will automatically fetch your Project ID and Email.
• It will automatically update your ~/.picoclaw/config.json to set antigravity as the default provider and gemini-3-flash as the default model.

2. Managing Models

List Available Models

To see which models your project has access to and check their quotas:

picoclaw auth models

Switch Models

You can change the default model in ~/.picoclaw/config.json or override it via the CLI:

# Override for a single command
picoclaw agent -m "Hello" --model claude-opus-4-6-thinking

3. Real-world Usage (Coolify/Docker)

If you are deploying via Coolify or Docker, follow these steps to test:

1. Branch: Use the feat/antigravity-provider branch.
2. Environment Variables:
   • PICOCLAW_AGENTS_DEFAULTS_PROVIDER=antigravity
   • PICOCLAW_AGENTS_DEFAULTS_MODEL=gemini-3-flash
3. Authentication persistence: If you've logged in locally, you can copy your credentials to the server:

   scp ~/.picoclaw/auth-profiles.json user@your-server:~/.picoclaw/
   

   Alternatively, run the auth login command once on the server if you have terminal access.

4. Troubleshooting

• Empty Response: If a model returns an empty reply, it may be restricted for your project. Try gemini-3-flash or claude-opus-4-6-thinking.
• 429 Rate Limit: Antigravity has strict quotas. PicoClaw will display the "reset time" in the error message if you hit a limit.
• 404 Not Found: Ensure you are using a model ID from the picoclaw auth models list. Use the short ID (e.g., gemini-3-flash) not the full path.

5. Summary of Working Models

Based on testing, the following models are most reliable:

• gemini-3-flash (Fast, highly available)
• gemini-2.5-flash-lite (Lightweight)
• claude-opus-4-6-thinking (Powerful, includes reasoning)