Connect your agent

Pensieve for Gemini CLI

This page tells you how to connect Gemini CLI to Pensieve over MCP, and what changes on your computer.

Connect Gemini CLI

1. Install Pensieve (see Install).
2. Run one of these commands:

   pensieve integrate recommended   # every agent on this computer
   pensieve integrate gemini-mcp gemini pensieve-search   # only Gemini CLI

3. Restart Gemini CLI. It loads its MCP servers when it starts.
4. Ask Gemini CLI a question about your code, for example “where do we retry failed webhooks?”.

What Pensieve adds

The instructions block goes in ~/.gemini/GEMINI.md, between <!-- pensieve:start --> markers.

Connect by hand

Add this entry to ~/.gemini/settings.json. Use the full path of your pensieve command. To find it, run which pensieve.

{
  "mcpServers": {
    "pensieve": {
      "command": "/Users/you/.local/bin/pensieve",
      "args": ["mcp"]
    }
  }
}

Remove

pensieve integrate gemini-mcp gemini --remove

Pensieve removes only the entries that it added.

See also: scopes, the MCP tools, and the benchmark.

Something wrong or missing? Tell us on GitHub.