mement

I have to believe in a world outside my own mind.

— Leonard, Memento

Your agents forget everything. mement doesn't.

A local memory layer for coding agents. It reads the sessions of Pi, Codex, and Claude Code, keeps the words you actually said, and lets you search them.

No cloud. No server. Your memory stays on your machine.

Install

npm install -g @hidaviddong/mement
mement install

mement install drops a skill into each agent:

• ~/.pi/agent/skills/mement/SKILL.md
• ~/.codex/skills/mement/SKILL.md
• ~/.claude/skills/mement/SKILL.md

Requires Node ≥ 22.13.

Remember

mement add                   # everything, incrementally
mement add --pi              # or just one source
mement add --codex --claude-code

Recall

mement search "sqlite schema"
mement search "deploy failed" --cwd "$(pwd)" --context 3
mement search "query" --harness codex --limit 10 --json

Where

Memory lives at ~/.mement/mement.db. Set MEMENT_HOME to move it.

Release

npm version patch && git push && git push --tags

Pushing any v* tag runs the Release workflow: tests, typecheck, build, publish to npm (OIDC — no 2FA), and a GitHub Release.

Forget nothing. Write it down. Tattoo it on your arm.