Files

T

Igor Lins e Silva 0cb9ee5c58 fix(website): correct false claims and stale numbers in live docs

- Landing: replace nonexistent `mempalace remember` CLI demo with real
  `mempalace mine ./notes`
- Landing: soften unverifiable absolutes ("forever available",
  "100% recall by design", "<50 ms", "90%+ compression",
  "two-thousand-year-old", "tens of thousands of entries")
- MCP tool count: 19 → 29 across mcp-integration, claude-code, openclaw,
  and modules; expand tool overview with Drawers, Tunnels, and System
  categories to match mcp_server.py
- Wake-up token range: ~170–900 → ~600–900 in cli/api-reference/python-api
  to match cli.py help text and concept docs
- Gemini CLI: move `--scope user` before target name and add `--`
  separator so `-m mempalace.mcp_server` isn't parsed as Gemini flags

2026-04-16 23:31:35 -03:00

2.1 KiB

Raw Blame History

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

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

::: warning Use the absolute path to the Python binary so the server starts from any working directory. The -- separator prevents Gemini from parsing -m mempalace.mcp_server as its own flags. :::

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

2.1 KiB Raw Blame History