> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/Gentleman-Programming/engram/llms.txt
> Use this file to discover all available pages before exploring further.

# Antigravity Setup

> Google's AI-first IDE with native MCP and skill support

<Note>
  **Prerequisite**: Install the `engram` binary first via [Homebrew](/installation#homebrew-macos-linux) or [binary download](/installation#download-binary).
</Note>

[Antigravity](https://antigravity.google) is Google's AI-first IDE with native MCP and skill support.

## Add the MCP Server

<Steps>
  <Step title="Open MCP Store">
    Click the `...` dropdown in the agent panel → **Manage MCP Servers**
  </Step>

  <Step title="View raw config">
    Click **View raw config**
  </Step>

  <Step title="Edit mcp_config.json">
    Add to `~/.gemini/antigravity/mcp_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "engram": {
          "command": "engram",
          "args": ["mcp"]
        }
      }
    }
    ```
  </Step>

  <Step title="Save and restart">
    Save the file. Antigravity will reload the MCP servers automatically.
  </Step>
</Steps>

## Adding the Memory Protocol (Recommended)

Without the Memory Protocol, the agent has the tools but doesn't know WHEN to use them.

### Option A: Global Rule

Add to `~/.gemini/GEMINI.md`:

```markdown theme={null}
## Memory

You have access to Engram persistent memory via MCP tools (mem_save, mem_search, mem_session_summary, etc.).

- Save proactively after significant work — don't wait to be asked.
- After any compaction or context reset, call `mem_context` to recover session state before continuing.
```

### Option B: Workspace Rule

Add to `.agent/rules/engram-memory.md` in your project:

```markdown theme={null}
## Engram Persistent Memory

You have access to Engram persistent memory via MCP tools.

### WHEN TO SAVE

Call `mem_save` IMMEDIATELY after:
- Bug fix completed
- Architecture or design decision made
- Non-obvious discovery about the codebase
- Configuration change or environment setup
- Pattern established (naming, structure, convention)
- User preference or constraint learned

### WHEN TO SEARCH

When the user asks to recall something ("remember", "what did we do").
Also search proactively when starting work that might overlap past sessions.

### SESSION CLOSE

Before ending, call `mem_session_summary` with:
- Goal
- Discoveries
- Accomplished
- Next Steps
- Relevant Files
```

See [Memory Protocol](/concepts/memory-protocol) for the full text.

## Platform-Specific Notes

### macOS / Linux

Config path: `~/.gemini/antigravity/mcp_config.json`

### Windows

Config path: `%USERPROFILE%\.gemini\antigravity\mcp_config.json`

## Antigravity vs. VS Code

<Warning>
  Antigravity has its own skill, rule, and MCP systems **separate** from VS Code.
</Warning>

**Do not use** `.vscode/mcp.json` with Antigravity. Use `~/.gemini/antigravity/mcp_config.json` instead.

Antigravity's agent system:

* **Skills** — Reusable knowledge bundles
* **Rules** — Project-specific agent instructions
* **MCP** — Tool integrations via stdio transport

## Memory Protocol Behavior

With the Memory Protocol in `GEMINI.md` or `.agent/rules/`, the agent:

* **Saves proactively** after bugfixes, decisions, discoveries, patterns
* **Searches reactively** when you say "remember" or "what did we do"
* **Searches proactively** when starting work that might overlap past sessions
* **Closes sessions** with `mem_session_summary` before saying "done"
* **Recovers state** after compaction with `mem_context`

## Troubleshooting

### MCP tools not available

Check MCP config:

```bash theme={null}
# macOS/Linux
cat ~/.gemini/antigravity/mcp_config.json

# Windows
type %USERPROFILE%\.gemini\antigravity\mcp_config.json
```

Verify the `engram` server entry exists.

### Binary not found

Antigravity can't find `engram` command:

```bash theme={null}
# Check PATH
echo $PATH

# Check binary location
which engram  # macOS/Linux
where engram  # Windows
```

If missing, install via [Homebrew](/installation#homebrew-macos-linux) or [binary download](/installation#download-binary).

### Agent doesn't use memory

Check that global or workspace rules include the Memory Protocol:

```bash theme={null}
# Global
cat ~/.gemini/GEMINI.md

# Workspace
cat .agent/rules/engram-memory.md
```

## Next Steps

* Learn about the [Memory Protocol](/concepts/memory-protocol)
* Explore [MCP Tools](/features/mcp-tools)
* Set up [Git Sync](/features/git-sync) for team memory sharing