# 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:

```bash
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:

```bash
picoclaw auth models
```

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

```bash
# 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:
    ```bash
    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)