{
  "name": "cognitive-memory",
  "version": "3.0.0",
  "description": "Markdown-based memory system with decay scoring, episodic logging, semantic search, reflection cycles, auto-curated CORE.md, native MCP server integration, rich edge files, and hybrid Ollama/OpenAI embeddings",
  "created": "2026-02-13",
  "migrated_from": "memorygraph",
  "status": "active",
  "files": {
    "client.py": "CLI and Python API for all memory operations",
    "mcp_server.py": "MCP server for Claude Code tool integration",
    "SKILL.md": "Skill documentation and activation triggers",
    "SCHEMA.md": "Format documentation for all file types",
    "scripts/session_memory.py": "SessionEnd hook — auto-stores session learnings",
    "scripts/ensure-symlinks.sh": "Refreshes MEMORY.md symlinks to CORE.md",
    "systemd/": "Reference copies of systemd user timers (see systemd/README.md)",
    "dev/migrate.py": "One-time migration from MemoryGraph SQLite",
    "dev/PROJECT_PLAN.json": "Development roadmap and task tracking"
  },
  "data_location": "~/.claude/memory/",
  "dependencies": "stdlib-only (no external packages; Ollama optional for semantic search)",
  "features": [
    "store: Create markdown memory files with YAML frontmatter (--episode flag)",
    "recall: Search memories ranked by relevance and decay score (--semantic flag)",
    "get: Retrieve memory by ID with access tracking",
    "relate: Create bidirectional relationships between memories",
    "search: Filter by type, tags, importance with optional text query",
    "update: Modify memory frontmatter and content",
    "delete: Remove memory with relation cleanup",
    "related: BFS traversal of memory relationships",
    "stats: Memory system statistics and decay summary",
    "recent: Recently created memories",
    "decay: Recalculate all decay scores",
    "core: Generate CORE.md auto-curated summary",
    "episode: Append to daily session log",
    "reindex: Rebuild index from markdown files",
    "pin: Move memory to vault (never decays)",
    "reflect: Cluster recent memories by tag overlap using union-find",
    "reflection: Generate REFLECTION.md summary with themes and patterns",
    "procedure: Store procedural memories with steps/preconditions/postconditions",
    "embed: Generate Ollama embeddings for semantic search",
    "tags list: Show all tags with usage counts",
    "tags related: Find co-occurring tags",
    "tags suggest: Recommend tags based on co-occurrence patterns",
    "edge-get: Get full edge details by ID",
    "edge-search: Search edges by query, type, from/to IDs",
    "edge-update: Update edge description or strength",
    "edge-delete: Remove edge and clean memory references",
    "config: Manage embedding provider (ollama/openai) with fallback",
    "MCP server: Native Claude Code tool integration via JSON-RPC stdio",
    "Hybrid embeddings: Ollama (local) + OpenAI (optional) with automatic fallback",
    "Rich edges: First-class edge files in graph/edges/ with descriptions"
  ]
}