Local-first semantic memory for Pi coding agent, powered by LogosDB.
Vector search runs entirely on your machine — no cloud, no external API, stdio-only.
pi install npm:pi-semantic-memoryVerify setup:
/logos-setup
logosdb-mcp-server must be reachable. Install globally for best performance:
npm install -g logosdb-mcp-serverFalls back to npx --yes logosdb-mcp-server if not found in PATH.
| Event | Action |
|---|---|
| Session start | Background-indexes the project directory (incremental, honours .gitignore) |
| Every user prompt | Semantic search → injects relevant memories into the system prompt silently |
| After each agent turn | Persists a turn record (Q+A) to memory; incremental re-index for changed files |
| Session compaction | Stores a handoff note |
All automatic actions are silent — nothing is printed to the console.
Controlled by LOGOS_MEMORY_MODE (default: global).
Turn records are stored in pi-global and are visible across all sessions and all projects.
Context injection searches both pi-global and the current project namespace.
# default — no env var needed
piTurn records and searches are isolated to the current project namespace (pi-proj-<name>).
Each repo has its own independent memory.
LOGOS_MEMORY_MODE=project piOr add to your shell profile / Pi config:
export LOGOS_MEMORY_MODE=project| Namespace | Purpose |
|---|---|
pi-global |
Cross-project memories (default store for turn records in global mode) |
pi-proj-<name> |
Project-specific memory and indexed source files; auto-derived from cwd basename |
| Tool | Description |
|---|---|
logos_remember |
Store a memory in a namespace |
logos_recall |
Semantic search across a namespace |
logos_forget |
Delete by semantic match |
logos_namespaces |
List all collections |
| Command | Description |
|---|---|
/logos-setup |
Verify MCP server and print configuration |
/logos-status |
Show mode, active namespace, indexing state |
/logos-index |
Manually trigger incremental re-indexing of the current directory |
| Variable | Default | Description |
|---|---|---|
LOGOS_MEMORY_MODE |
global |
global or project — controls memory scope |
LOGOSDB_PATH |
~/.pi/agent/logosdb |
Path to the LogosDB database directory |
LOGOSDB_MCP_BIN |
(auto) | Override the logosdb-mcp-server binary path |
MIT