Files
mempalace/website/guide/gemini-cli.md
T
mvalentsev c4baceccb4 docs: fix stale milla-jovovich org URLs in website and plugin manifests (#787)
Follow-up to #766 which covers version.py, pyproject.toml, README,
CHANGELOG, and CONTRIBUTING. These 11 files still had the old org
name in URLs:

- website/ (VitePress config + 6 docs pages)
- .claude-plugin/ (plugin.json repository, README marketplace command)
- .codex-plugin/ (plugin.json URLs, README links)

Author name fields are intentionally unchanged.
2026-04-14 02:44:41 +05:00

2.0 KiB

Gemini CLI

MemPalace works natively with Gemini CLI, which handles the MCP server and save hooks automatically.

Prerequisites

  • Python 3.9+
  • Gemini CLI installed and configured

Installation

# Clone the repository
git clone https://github.com/MemPalace/mempalace.git
cd mempalace

# Create a virtual environment
python3 -m venv .venv

# Install dependencies
.venv/bin/pip install -e .

Initialize the Palace

.venv/bin/python3 -m mempalace init .

Identity and Project Configuration (Optional)

You can optionally create or edit:

  • ~/.mempalace/identity.txt — plain text describing your role and focus
  • ./mempalace.yaml — per-project MemPalace configuration created by mempalace init
  • ./entities.json — per-project entity mappings used by AAAK compression

Connect to Gemini CLI

Register MemPalace as an MCP server:

gemini mcp add mempalace /absolute/path/to/mempalace/.venv/bin/python3 \
  -m mempalace.mcp_server --scope user

::: warning Use the absolute path to the Python binary to ensure it works from any directory. :::

Enable Auto-Saving

Add a PreCompress hook to ~/.gemini/settings.json:

{
  "hooks": {
    "PreCompress": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "/absolute/path/to/mempalace/hooks/mempal_precompact_hook.sh"
          }
        ]
      }
    ]
  }
}

Make sure the hook scripts are executable:

chmod +x hooks/*.sh

Usage

Once connected, Gemini CLI will automatically:

  • Start the MemPalace server on launch
  • Use mempalace_search to find relevant past discussions
  • Use the PreCompress hook to save memories before context compression

Manual Mining

Mine existing code or docs:

.venv/bin/python3 -m mempalace mine /path/to/your/project

Verification

In a Gemini CLI session:

  • /mcp list — verify mempalace is CONNECTED
  • /hooks panel — verify the PreCompress hook is active