pi-semantic-memory

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.

Install

pi install npm:pi-semantic-memory

Verify setup:

/logos-setup

Requirements

logosdb-mcp-server must be reachable. Install globally for best performance:

npm install -g logosdb-mcp-server

Falls back to npx --yes logosdb-mcp-server if not found in PATH.

What happens automatically

| 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.

Memory scope

Controlled by LOGOS_MEMORY_MODE (default: global).

global (default)

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
pi

project

Turn records and searches are isolated to the current project namespace (pi-proj-<name>).
Each repo has its own independent memory.

LOGOS_MEMORY_MODE=project pi

Or add to your shell profile / Pi config:

export LOGOS_MEMORY_MODE=project

Namespaces

| 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 |

Tools

| 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 |

Commands

| 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 |

Environment variables

| 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 |

License

MIT