Melchizedek

Search indexed past conversations. Returns compact results with snippets. Results from the current project and session are boosted by default. Use m9k_context or m9k_full to drill down.

Get a chunk with surrounding context (adjacent chunks in the same session). Use after m9k_search to understand the conversation flow.

Retrieve full content of chunks by IDs. Use after m9k_search to get complete context.

Find past conversations that touched a specific file. Searches metadata (tool_use file_path) and text content.

Find past solutions for an error message. Returns error context + how it was resolved.

Find past work similar to what you're about to do. Use at the start of a complex task to see previous approaches. Unlike m9k_search, this prioritizes chunks with rich metadata (multiple tools used, multiple files touched).

Manually save a memory note for future recall. Use for important decisions, patterns, or context.

List all indexed sessions, optionally filtered by project.

Show memory index information: corpus size, search pipeline status, usage metrics, embedding worker state.

View or update plugin configuration. Changes are saved to ~/.melchizedek/config.json and take effect on next server restart. Without arguments, returns current config.

Permanently remove a specific chunk from the memory index. Does NOT delete the source JSONL. Use m9k_search() first to find the chunk ID to forget.

Delete a session from the index. Removes all chunks and search data. Does NOT delete the source JSONL file.

Exclude a project from indexing. Future sessions won't be indexed. Optionally purge existing indexed sessions for this project.

Remove a project from the ignore list. Future sessions will be indexed again. Previously purged sessions are NOT restored (requires backfill re-indexation).

Restart the MCP server. Use after npm run build to load fresh code. The server disconnects; next MCP call auto-reconnects with the new build.

melchizedek v1.0.2 — Persistent memory for Claude Code with hybrid search (BM25 + dual embeddings) + reranking.

Corpus: empty (no sessions indexed yet).

Available tools (16):

• m9k_search: Find past conversations (BM25 + text vectors + code vectors, fused via RRF)

• m9k_context: Get a chunk with surrounding conversation context

• m9k_full: Get complete chunk content by IDs

• m9k_sessions: Browse indexed sessions

• m9k_file_history: Find conversations that touched a specific file

• m9k_errors: Find past solutions for error messages

• m9k_save: Store important notes for future recall

• m9k_similar_work: Find past approaches to similar tasks (bonus for complex work)

• m9k_forget: Permanently remove a chunk from memory

• m9k_info: Memory index information, corpus size, search pipeline status, usage metrics, embedding worker state

• m9k_config: View or update plugin configuration

• m9k_delete_session: Remove a session from the index

• m9k_ignore_project: Exclude a project from indexing (optionally purge existing data)

• m9k_unignore_project: Re-enable indexing for a previously ignored project

• m9k_restart: Restart the MCP server to load fresh code after rebuild

RETRIEVAL PATTERN (use this order):

1. m9k_search(query) → compact results, current project and session boosted (use order="date_asc" to find first occurrence)

2. m9k_context(chunkId) → surrounding conversation

3. m9k_full([chunkIds]) → complete content if needed

SPECIALIZED SEARCH:

• m9k_file_history(filePath) → before modifying any file

• m9k_errors(errorMessage) → when you hit an error

• m9k_similar_work(description) → at the start of a complex task

MANAGE:

• m9k_info() → check corpus size, search pipeline, usage metrics

• m9k_config() → view or change plugin configuration

• m9k_delete_session(sessionId) → remove a session from the index

• m9k_ignore_project(project) → exclude a project from indexing

• m9k_unignore_project(project) → re-enable indexing for a project

• m9k_restart() → restart server after npm run build