> ## Documentation Index
> Fetch the complete documentation index at: https://docs.claude-mem.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Antigravity CLI Setup

> Add persistent memory to Antigravity CLI with claude-mem

# Antigravity CLI Setup

> **Give Antigravity CLI persistent memory across sessions.**

Antigravity CLI (`agy`) is Google's standalone successor to Gemini CLI — it reuses Gemini CLI's `~/.gemini/` config tree and, per Google, "keeps the most critical features of Gemini CLI: Agent Skills, Hooks, Subagents, and Extensions." Claude-mem changes what happens across sessions by capturing observations, decisions, and patterns — then injecting relevant context into each new session.

<Info>
  **How it works:** Claude-mem installs lifecycle hooks into Antigravity CLI's shared `~/.gemini/settings.json` that capture tool usage, agent responses, and session events. A local worker service extracts semantic observations and injects relevant history at session start — via `GEMINI.md`, an MCP server, and a rules file.
</Info>

<Note>
  Antigravity CLI is a different product from the Antigravity **desktop IDE** (`antigravity` binary) — both share the same `~/.gemini/antigravity` namespace, but the CLI's own binary is `agy`. Detection checks for `agy` in your `PATH` (or an existing `~/.gemini/antigravity` directory).
</Note>

## Prerequisites

* [Antigravity CLI](https://github.com/google-antigravity/antigravity-cli) (`agy`) installed — `curl -fsSL https://antigravity.google/cli/install.sh | bash`
* [Node.js](https://nodejs.org/) 18+
* The `~/.gemini` directory must exist (created by Antigravity CLI / Gemini CLI on first run)

## Installation

### Step 1: Install claude-mem

```bash theme={null}
npx claude-mem install --ide antigravity
```

The installer will:

1. Auto-detect Antigravity CLI (checks for `agy` in `PATH`, or an existing `~/.gemini/antigravity` directory)
2. Install 8 lifecycle hooks into `~/.gemini/settings.json`
3. Inject context configuration into `~/.gemini/GEMINI.md`
4. Register claude-mem's MCP server in `~/.gemini/antigravity/mcp_config.json` **and** `~/.gemini/config/mcp_config.json`
5. Write a rules/context placeholder to `~/.agents/rules/claude-mem-context.md`
6. Start the worker service

### Step 2: Configure an AI provider

Claude-mem needs an AI provider to extract observations from your sessions. Choose one:

<Tabs>
  <Tab title="Gemini API (Free)">
    The simplest option — use Gemini's own API for observation extraction:

    1. Get a free API key from [Google AI Studio](https://aistudio.google.com/apikey)
    2. Add it to your settings:

    ```bash theme={null}
    mkdir -p ~/.claude-mem
    cat > ~/.claude-mem/settings.json << 'EOF'
    {
      "CLAUDE_MEM_PROVIDER": "gemini",
      "CLAUDE_MEM_GEMINI_API_KEY": "YOUR_API_KEY"
    }
    EOF
    ```

    <Tip>
      **Free tier:** 1,500 requests/day with `gemini-2.5-flash-lite`. Enable billing on Google Cloud for 4,000 RPM without charges.
    </Tip>
  </Tab>

  <Tab title="Claude SDK">
    If you have a Claude API key:

    ```bash theme={null}
    mkdir -p ~/.claude-mem
    cat > ~/.claude-mem/settings.json << 'EOF'
    {
      "CLAUDE_MEM_PROVIDER": "claude"
    }
    EOF
    ```

    Set your API key via environment variable:

    ```bash theme={null}
    export ANTHROPIC_API_KEY="your-key"
    ```
  </Tab>

  <Tab title="OpenRouter">
    For access to 100+ models:

    ```bash theme={null}
    mkdir -p ~/.claude-mem
    cat > ~/.claude-mem/settings.json << 'EOF'
    {
      "CLAUDE_MEM_PROVIDER": "openrouter",
      "CLAUDE_MEM_OPENROUTER_API_KEY": "YOUR_KEY"
    }
    EOF
    ```
  </Tab>
</Tabs>

### Step 3: Verify installation

```bash theme={null}
# Check worker is running
npx claude-mem status

# Check hooks are installed — look for claude-mem entries
cat ~/.gemini/settings.json | grep claude-mem

# Check MCP registration in either candidate config path
cat ~/.gemini/antigravity/mcp_config.json | grep claude-mem
cat ~/.gemini/config/mcp_config.json | grep claude-mem
```

Open [http://localhost:37777](http://localhost:37777) to see the memory viewer.

### Step 4: Start using Antigravity CLI

Launch Antigravity CLI normally. Claude-mem works in the background:

```bash theme={null}
agy
```

On session start, you'll see claude-mem context injected with your recent observations and project history.

## What gets captured

Claude-mem registers all 8 confirmed Antigravity CLI lifecycle hooks (verified against a live install):

| Hook             | Internal event     | Purpose                                     |
| ---------------- | ------------------ | ------------------------------------------- |
| **SessionStart** | `context`          | Injects memory context into the session     |
| **BeforeAgent**  | `session-init`     | Captures user prompts                       |
| **AfterAgent**   | `observation`      | Records full agent responses                |
| **BeforeTool**   | `observation`      | Logs tool invocations before execution      |
| **AfterTool**    | `observation`      | Captures tool results after execution       |
| **Notification** | `observation`      | Records system events (permissions, etc.)   |
| **PreCompress**  | `summarize`        | Captures session summary before compression |
| **SessionEnd**   | `session-complete` | Marks session complete                      |

All 8 events above are **confirmed** — verified directly against a live, already-installed Antigravity CLI's `~/.gemini/settings.json` (not assumed from Gemini CLI's schema alone).

## MCP registration

Antigravity CLI has native MCP support, but which config path it reads was genuinely ambiguous at the time of writing — two real candidate paths exist on disk with no definitive documentation resolving which one `agy` loads. Claude-mem writes to **both**, safely and idempotently:

* `~/.gemini/antigravity/mcp_config.json`
* `~/.gemini/config/mcp_config.json`

This gives claude-mem's search tools (`search`, `smart_search`, `timeline`, etc.) a chance to register correctly regardless of which path Antigravity CLI actually reads.

## Future enhancement (not implemented in this release)

Antigravity CLI ships a first-class plugin-marketplace subcommand system: `agy plugin {list,import,install,uninstall,enable,disable,validate,link}`. Notably, `agy plugin import gemini|claude` suggests native cross-tool plugin migration — structurally similar to Codex CLI's `.codex-plugin/plugin.json` marketplace mechanism. This could eventually be a cleaner, more idiomatic way to bundle claude-mem's hooks + MCP + skills registration than hand-editing `settings.json`. It isn't implemented here because its manifest schema isn't discoverable without running `agy plugin import`/`install` against a real manifest, which would mutate a user's live local plugin state. Tracked as a candidate follow-up.

## Troubleshooting

### Hooks not firing

1. Verify hooks exist in settings:
   ```bash theme={null}
   cat ~/.gemini/settings.json
   ```
   You should see entries like `"SessionStart"`, `"AfterTool"`, etc. with claude-mem commands.

2. Restart Antigravity CLI after installation.

3. Re-run the installer:
   ```bash theme={null}
   npx claude-mem install --ide antigravity
   ```

### Worker not running

```bash theme={null}
# Check status
npx claude-mem status

# View logs
npx claude-mem logs

# Restart worker
npx claude-mem restart
```

### No context appearing at session start

1. Ensure the worker is running (check [http://localhost:37777](http://localhost:37777))
2. You need at least one previous session with observations for context to appear
3. Check your AI provider is configured in `~/.claude-mem/settings.json`

### Raw escape codes in output

If you see characters like `[31m` or `[0m` in the session context, your claude-mem version may need updating — the Antigravity CLI adapter strips ANSI color codes automatically:

```bash theme={null}
npx claude-mem install --ide antigravity
```

## Uninstalling

```bash theme={null}
npx claude-mem uninstall
```

This removes claude-mem's hooks from `~/.gemini/settings.json`, cleans up the context section in `~/.gemini/GEMINI.md`, removes claude-mem's entry from both MCP config files, and removes the rules context section — while preserving everything else in those files.

## Next Steps

* [Gemini Provider](/usage/gemini-provider) — Configure the Gemini AI provider for observation extraction
* [Configuration](/configuration) — All settings options
* [Search Tools](/usage/search-tools) — Search your memory from within sessions
* [Troubleshooting](/troubleshooting) — Common issues and solutions