Expand description
recall-echo — Persistent memory system with knowledge graph.
A general-purpose persistent memory system for any LLM tool — Claude Code, Ollama, or any provider. Features a four-layer memory architecture with a knowledge graph (SurrealDB + fastembed) as Layer 0.
§Architecture
Transcript adapters (Claude Code, Codex, Grok, pulse-null Messages)
→ Conversation (universal internal format)
→ Archive pipeline (markdown + index + ephemeral + graph)Sessions arrive either because the CLI told us (Claude Code’s SessionEnd
hook) or because we read what it wrote (capture, over transcript).
§Features
pulse-null— Plugin integration for pulse-null entitiesllm— HTTP-based LLM provider for entity extraction
Re-exports§
pub use archive::SessionMetadata;pub use summarize::ConversationSummary;
Modules§
- agent_
cli - Which agent CLIs this machine has, and how recall-echo wires itself into them.
- archive
- Conversation archival — converts conversations into persistent markdown archives.
- capture
- Capture — importing sessions from the agent CLIs a user actually runs.
- checkpoint
- Checkpoint creation — saves a conversation snapshot before context compression.
- cli_
provider - Completions from whichever agent CLI the user already pays for.
- config
- config_
cli - CLI handlers for
recall-echo config showandrecall-echo config set. - consume
- EPHEMERAL.md consumption — reads recent session context.
- conversation
- Core conversation types and processing.
- dashboard
- distill
- ephemeral
- error
- Top-level error type for recall-echo.
- frontmatter
- graph
- recall-graph — Knowledge graph with semantic search for AI memory systems.
- graph_
bridge - Bridge between recall-echo and recall-graph.
- graph_
cli - Graph memory CLI subcommands (behind
graphfeature flag). - init
- Initialize the recall-echo memory system.
- jsonl
- JSONL transcript parsing for Claude Code sessions.
- llm_
provider - LLM providers implementing crate::graph::LlmProvider.
- mcp
- MCP server — the read path into the knowledge graph.
- paths
- Path resolution utilities for recall-echo.
- search
- serve
recall-echo serve— the graph daemon.- serve_
capture - Background transcript capture inside the graph daemon.
- serve_
client - Client side of the graph daemon — connect, or start one and connect.
- serve_
extract - Background entity extraction inside the graph daemon.
- status
- Memory system health check.
- summarize
- Conversation summarization with optional LLM enhancement.
- tags
- Structured tag extraction from conversations.
- transcript
- Transcript adapters — reading any agent CLI’s session records.
Structs§
- Recall
Echo - The recall-echo memory system.