@memongo/pi-extension

Memongo durable memory for the Pi coding agent.

Additive — sits alongside pi-hermes-memory (local SQLite FTS5) and exposes Memongo's hybrid vector + full-text + graph retrieval as new tools. Does not replace any existing Pi memory tool.

Tools

| Tool | Purpose | |------|---------| | memongo_search | Semantic / cross-project / cross-session search over durable memory (hybrid vector + text + graph) | | memongo_save | Persist a durable structured fact / decision / preference / instruction to Memongo | | memongo_status | Probe Memongo API health + vector search availability | | /memongo | Slash command — quick status check |

Quick start

1. Run Memongo locally

cd /Users/rom.iluz/Dev/memongo

# Start MongoDB (Atlas Local Preview — includes mongod + mongot + Atlas Search + auto-embed)
docker compose -f docker/docker-compose.yml up -d

# Start the HTTP API
cd apps/api && bun run dev

Get a Voyage AI API key (free tier, al-... prefix) and export it:

export VOYAGE_API_KEY="al-..."

2. Wire into Pi

Add to ~/.pi/agent/settings.json:

{
  "packages": [
    "/Users/rom.iluz/Dev/memongo/packages/pi-extension"
  ]
}

Set env vars (in shell or .envrc):

export MEMONGO_API_URL="http://127.0.0.1:3847"
export MEMONGO_API_KEY="local-dev-secret"
export MEMONGO_AGENT_ID="pi-agent"

3. Reload and verify

/reload
/memongo

You should see Memongo @ http://127.0.0.1:3847 with vector status. Then try:

• memongo_status — confirms API + vector search are live
• memongo_search with a query — semantic recall across projects
• memongo_save — persist a durable fact

Architecture

Pi Agent
  ├── pi-hermes-memory (local FTS5)       ← stays
  ├── pi-observational-memory             ← stays
  └── @memongo/pi-extension (this)        ← additive
        └── @memongo/client → HTTP API (port 3847) → MongoDB (Docker)

Config

| Env var | Default | Purpose | |---------|---------|---------| | MEMONGO_API_URL | http://127.0.0.1:3847 | Memongo HTTP API base URL | | MEMONGO_API_KEY | (none) | Bearer token (optional for local dev) | | MEMONGO_AGENT_ID | pi-agent | Agent identity for scoping | | VOYAGE_API_KEY | (none) | Required for vector/semantic search (Atlas Model API key) |

Graceful degradation

If the Memongo API is down, all three tools return clean error messages instead of crashing. The agent is instructed to fall back to memory_search (local FTS5). Nothing breaks.

License

Apache-2.0