memora

# Memora - Persistent Semantic Memory Memora is the persistent memory system for this environment. Use memora MCP tools to store, search, and organize knowledge across sessions. ## When to Use - **Session start**: Relevant memories are auto-injected via hook - **Storing decisions**: Use `memory_create` to save architectural decisions, patterns, preferences - **Finding context**: Use `memory_hybrid_search` to find relevant past work - **Tracking work**: Use `memory_create_todo` / `memory_create_issue` for task tracking - **Organizing knowledge**: Use `memory_hierarchy` to browse organized memories ## Core Tools ### Creating Memories - `memory_create` - Store a new memory (auto-deduplicates, suggests hierarchy) - `memory_create_todo` - Create a TODO with priority (high/medium/low) - `memory_create_issue` - Create an issue with severity (critical/major/minor) - `memory_create_section` - Create organizational headers - `memory_create_batch` - Bulk create multiple memories ### Searching - `memory_hybrid_search` - Best search: combines keyword + semantic (use this by default) - `memory_semantic_search` - Pure vector similarity search - `memory_list` - List/filter by tags, dates, metadata - `memory_list_compact` - Lightweight listing (id, preview, tags only) ### Organizing - `memory_hierarchy` - View memories in section/subsection tree - `memory_tags` - List allowed tags - `memory_tag_hierarchy` - View tag namespace tree - `memory_link` - Create typed relationships between memories - `memory_clusters` - Detect related memory clusters ### Maintenance - `memory_find_duplicates` - Find and review potential duplicates (LLM-powered) - `memory_merge` - Merge two memories together - `memory_insights` - Get activity summary, stale items, patterns - `memory_stats` - Database statistics - `memory_boost` - Increase a memory's importance ranking ### Visualization - Knowledge graph available at http://localhost:8765 when running - `memory_export_graph` - Export as interactive HTML file ## Tag Conventions Use hierarchical tags with `/` separators: - `memora/knowledge` - General knowledge - `memora/todos` - Task items - `memora/issues` - Bug/issue tracking - `memora/auto-capture` - Auto-captured content - `memora/sections` - Organizational headers - `project-name/topic` - Project-specific tags ## Best Practices 1. **Search before creating** - avoid duplicates 2. **Use metadata** for structured data (`section`, `subsection`, `project`) 3. **Tag consistently** - use hierarchical tags 4. **Boost important memories** - they rank higher in searches 5. **Use hybrid search** as default - it combines keyword + semantic 6. **Review insights periodically** - find stale items and consolidation opportunities ## Auto-Capture When `MEMORA_AUTO_CAPTURE=true` is set, the PostToolUse hook automatically captures: - Git commits (appended to per-project commit log) - Test results (failures become issues) - Web research (GitHub repos, documentation) - Documentation edits (README, CHANGELOG, etc.)