mnemonic

mnemonic is a persistent memory system for Claude Code that stores knowledge as structured markdown files on the filesystem. It implements MIF Level 3 with ontology-driven namespaces, automatic capture/recall hooks, and garbage collection.

How It Works

Memories are plain markdown files with YAML frontmatter, organized into namespaces (semantic, procedural, episodic). Claude Code hooks trigger search on session start and capture prompts on task completion. ripgrep handles full-text search across the memory store.

Features

• Ontology-driven namespace organization
• Automatic capture and recall through Claude Code hooks
• Full-text search via ripgrep
• Memory deduplication and garbage collection
• Git-backed version history
• Cross-session knowledge persistence

Architecture

~/.local/share/mnemonic/
  _semantic/        # Facts, decisions, knowledge
  _procedural/      # Patterns, workflows, how-to
  _episodic/        # Events, blockers, sessions

Links

• GitHub Repository