Registry / ai-ml / memory-state-codex

memory-state-codex

JSON →
library0.4.0jsnpmunverified

Portable persistent memory profiles for Codex agents, backed by SQLite with FTS5 and trigram indexes. Version 0.4.0 provides two modes: LITE (curated memory only) and PLUS (with session/message traceability and project-filtered search). The package includes a Python CLI with no third-party dependencies, a global AGENTS.md profile, and a cross-platform npm installer that resolves the Codex home directory from --codex-home flag, CODEX_HOME environment variable, or ~/.codex. The installer is idempotent and replaces managed memory blocks while leaving existing databases untouched. Differentiates from other memory solutions by being pre-curated for Codex agents and fully portable.

ai-ml
npm install memory-state-codex
package ↗
INSTALL
IMPORT
SIG · MEMORY-STATE-CODEX
M
memory-state-codex
ai-mljavascriptv0.4.0
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

memory-state-codex (CLI)
✓ npx memory-state-codex
✗ npm install -g memory-state-codex && memory-state-codex
Package is a CLI installer; run via npx. No programmatic API.
PLUS mode
✓ npx memory-state-codex --plus
Use --plus flag to install PLUS mode with session/message traceability.
Custom home directory
✓ npx memory-state-codex --codex-home ~/.codex-custom
Specify custom Codex home using --codex-home flag or CODEX_HOME environment variable.

Dry-run installation of PLUS mode into a custom directory, showing what would be copied.

npx memory-state-codex --plus --codex-home ~/.codex-mem-test --dry-run
Debug
Known issues
breakingExisting AGENTS.md memory block is replaced idempotently.
fix
Backup AGENTS.md if customizations exist outside the managed block.
affects: >=0.1.0
deprecatedLITE mode is default; PLUS mode requires explicit --plus flag.
fix
Use --plus to enable PLUS mode features.
affects: >=0.4.0
gotchaDatabase file is not overwritten unless --force-db is used; manual delete may be needed.
fix
Use --force-db to reset database, or delete memory_state.db manually.
affects: >=0.1.0
gotchaCLI requires Node.js >=18 and Python (for memory.py scripts) without third-party deps.
fix
Ensure Node.js 18+ and Python 3.x are available in PATH.
affects: >=0.1.0
Errors
Common errors & fixes
npx memory-state-codex --plus --codex-home ~/.codex
Typo in flag or path; directory not writable or exists.
fix
Check spelling: --codex-home, not --codexhome. Use absolute path and ensure write permissions.
AGENTS.md not updated after install
Existing AGENTS.md may have customizations outside the managed block that are preserved, but the managed block is replaced.
fix
Verify the managed block markers are present (─── memory-state-codex block ───) or re-run with --force to regenerate.
Python script not found
Python not installed or not in PATH; memory.py requires Python.
fix
Install Python 3.x and ensure it is accessible from command line.
Upgrade
Version history
0.4.0latest on npm
Audit
Dependencies
nodeoptionalRuntime environment required
Agent activity
6 hits · last 30 days
node
6
Resources
packagememory-state-codex ↗
memory-state-codex — npm install memory-state-codex · libregistry