memora

name	memora
description	Use when working with persistent memory across sessions, storing/retrieving knowledge, managing TODOs/issues, or when context from previous sessions would be helpful.
version	0.2.20

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.)