Skip to content

elderfo/mehmory

v0.4.0MIT

Memory abstraction layer for Claude Code, Codex CLI and Pi: deterministic capture hooks plus model-driven skills over a markdown wiki in ~/.mehmory.

integrate

Merge captured mehmory inbox entries into the wiki pages under ~/.mehmory — editing pages, links, index lines and frontmatter, then clearing the inbox transactionally and committing. Use when the SessionStart nudge says the inbox is over threshold, or whenever the user asks to integrate, process, or file memory. Writes to ~/.mehmory (outside the project), so Claude Code may prompt for permission; if writes are denied nothing is lost — entries stay in the inbox for the next pass.

lint

Full-sweep health check of the mehmory wiki under ~/.mehmory — staleness, orphan pages, contradictions across pages, and archive candidates. Reports everything first and applies only the fixes the user approves. Use when the user asks to lint, audit, clean up, or check memory. Writes to ~/.mehmory (outside the project), so Claude Code may prompt for permission on the apply step; the report itself is read-only.

onboard-session

Seed mehmory for the current project from scratch — survey the repo (README, package manifest, git log, docs), then write project.md, a first set of pages and the index under ~/.mehmory, and commit. Use on a fresh store, when SessionStart says the store was just created, or when the user asks to onboard, bootstrap, or set up memory for this project. Writes to ~/.mehmory (outside the project), so Claude Code may prompt for permission.

pause

Pause mehmory capture and injection for this session when the user says pause memory, stop capturing, or mute mehmory. Uses a locked helper to write the pause flag under ~/.mehmory/.state (outside the project), so permission may be required. Reversible with resume.

remember

Save a fact, decision, correction or gotcha to the mehmory inbox right now, so the next integrate files it into the wiki. Use when the user says remember this, save this, note that, or do not forget. For a one-liner there is a faster path with no skill load at all — start a prompt with the remember: prefix (for example remember: staging deploys need the VPN) and the UserPromptSubmit hook captures it inline. Writes to ~/.mehmory (outside the project), so Claude Code may prompt for permission.

resume

Resume mehmory capture and injection after a session pause when the user says resume memory, unpause, or start capturing again. Uses a locked helper to clear the flag under ~/.mehmory/.state (outside the project), so permission may be required. Hooks disabled in config stay disabled.