codex-memory
v1.0.9
Published
Local persistent memory for Codex agents that captures, searches, and reuses project knowledge.
Maintainers
Readme
codex-memory
Project-local memory for Codex agents.
codex-memory installs a local memory runtime for a Codex workspace. It stores project knowledge in SQLite, exposes MCP tools, and wires Codex hooks so agents can search, capture, and reuse decisions, fixes, facts, and patterns across sessions.
Quick Start
npx codex-memory install
codex-memory doctor
codex-memory remember --type decision --title "Use SQLite" --context "Local memory storage" --resolution "Keep canonical memory in SQLite."
codex-memory query "SQLite"On Windows PowerShell, use npx.cmd codex-memory install if npx is not
resolved. Run codex-memory doctor after install to confirm the API URL,
SQLite path, MCP server, plugin config, hooks, and worker port.
Common Commands
codex-memory status
codex-memory restart
codex-memory debug --query "current task"
codex-memory uninstallMemory Types
Use fact, decision, bug, solution, and pattern for durable project
knowledge:
codex-memory remember --type fact --title "Frontend uses Next.js" --context "Application stack"
codex-memory remember --type bug --title "Windows shell cannot resolve npx" --context "PowerShell install path" --resolution "Run npx.cmd codex-memory install."
codex-memory query "PowerShell npx"MCP
The installer writes MCP configuration for the packaged server. The server uses
CODEX_MEM_API_URL, usually http://127.0.0.1:8000, and exposes memory tools
such as query_memory, store_memory, get_memory, update_memory, and
delete_memory.
Guides
Data
Memory is local-first and stored under ~/.codex-mem by default. Do not store secrets, tokens, credentials, or private personal data as memory.
Package Publishing
The GitHub repository is a monorepo. The root package.json is private and is used for development, workspaces, and shared scripts.
The npm package users install is published from apps/cli, because that directory contains the codex-memory CLI manifest, built dist files, runtime assets, license, and this README.
cd apps/cli
npm pack --dry-run
npm publish --access publicThe dry run should list README.md before publishing.
