c4baceccb4
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.
2.0 KiB
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 bymempalace 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_searchto find relevant past discussions - Use the
PreCompresshook 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— verifymempalaceisCONNECTED/hooks panel— verify thePreCompresshook is active