waggle-mcp
Persistent memory that remembers decisions, reasons, and contradictions across sessions.
Your AI forgets everything when the context window closes. Waggle gives it a graph-backed brain that persists.
Not a code indexer. A conversational memory engine — it stores what you decided, why you decided it, and what changed, so the next session picks up where the last one left off.
Core
This repository is the public Waggle product repo: Apache-2.0 licensed, available on GitHub and PyPI, and focused on the local-first memory engine.
Tech Stack
- Python 3.11+ package built with
pyproject.toml - MCP server exposed through
waggle-mcp - SQLite graph storage by default, with an optional Neo4j backend
- Local sentence-transformers embeddings with a deterministic offline fallback
- Ruff, mypy, and pytest for linting, type checks, formatting, and tests
- GitHub Actions for pull request CI/CD checks
- Vite/React assets for the bundled Graph Studio UI under
apps/mcp/graph-ui/
Quick Start
# Install globally (no venv needed)
pipx install waggle-mcp
# One-line setup — detects your MCP clients and writes config
waggle-mcp setup --yes
# Verify everything is healthy
waggle-mcp doctor
