# recollect v0.5.1 - Table of Contents

Pluggable memory engine with vector search, knowledge graphs, and LLM extraction. Supports PostgreSQL (pgvector), SQLite (sqlite-vec), and libSQL.

## Pages

- [Recollect](readme.md)
- [LICENSE](license.md)

## Modules

- [Recollect](Recollect.md): Pluggable memory engine for Elixir applications.
- [Recollect.Classification](Recollect.Classification.md): LLM-free memory classification using regex-based pattern matching.
- [Recollect.Confidence](Recollect.Confidence.md): Confidence lifecycle management.
- [Recollect.Config](Recollect.Config.md): Runtime configuration resolution for Recollect.
- [Recollect.ConflictDetection](Recollect.ConflictDetection.md): Automatic conflict detection for contradictory memories.
- [Recollect.Conflicts](Recollect.Conflicts.md): Conflict management for contradictory memories.
- [Recollect.Consolidation](Recollect.Consolidation.md): Sleep consolidation for memory maintenance.
- [Recollect.Context.Detector](Recollect.Context.Detector.md): Detect current environment context from the running system.
- [Recollect.DatabaseAdapter](Recollect.DatabaseAdapter.md): Behaviour for database-specific implementations.
- [Recollect.DatabaseAdapter.LibSQL](Recollect.DatabaseAdapter.LibSQL.md): libSQL/SQLite database adapter with native vector support.
- [Recollect.DatabaseAdapter.Postgres](Recollect.DatabaseAdapter.Postgres.md): PostgreSQL database adapter with pgvector support.
- [Recollect.DatabaseAdapter.SQLiteVec](Recollect.DatabaseAdapter.SQLiteVec.md): SQLite database adapter with sqlite-vec extension for vector support.
- [Recollect.Embedding.Local](Recollect.Embedding.Local.md): Local embedding provider using Bumblebee with sentence-transformers/all-MiniLM-L6-v2.
- [Recollect.Embedding.OpenRouter](Recollect.Embedding.OpenRouter.md): OpenRouter embedding provider.
- [Recollect.EmbeddingProvider](Recollect.EmbeddingProvider.md): Behaviour for embedding providers.
- [Recollect.EmbeddingType](Recollect.EmbeddingType.md): Ecto type for embedding vectors that works with both PostgreSQL and libSQL.
- [Recollect.Export](Recollect.Export.md): Export Recollect data to a portable format for migration or backup.
- [Recollect.Extraction.LlmJson](Recollect.Extraction.LlmJson.md): Default extraction provider using LLM with JSON structured output.
- [Recollect.ExtractionProvider](Recollect.ExtractionProvider.md): Behaviour for LLM-powered entity/relation extraction.
- [Recollect.Graph.PostgresGraph](Recollect.Graph.PostgresGraph.md): Graph store implementation using PostgreSQL recursive CTEs.
Queries the recollect_entities and recollect_relations tables directly.

- [Recollect.GraphStore](Recollect.GraphStore.md): Behaviour for graph storage backends.
- [Recollect.Handoff](Recollect.Handoff.md): Session handoff for continuing work across sessions.
- [Recollect.Import](Recollect.Import.md): Import Recollect data from JSONL export files.
- [Recollect.Invalidation](Recollect.Invalidation.md): Active memory invalidation based on detected or explicit breaking changes.
- [Recollect.Knowledge](Recollect.Knowledge.md): Lightweight knowledge API (Tier 2).
Simple store-embed-search for entries and edges.

- [Recollect.Learner](Recollect.Learner.md): Behaviour for learning modules that extract knowledge from external sources.
- [Recollect.Learner.CodingAgent](Recollect.Learner.CodingAgent.md): Unified learner for all coding agents (Claude Code, Codex, Gemini CLI, Goose, OpenCode).
- [Recollect.Learner.CodingAgent.ClaudeCode](Recollect.Learner.CodingAgent.ClaudeCode.md): Provider for Claude Code (`~/.claude/`).
- [Recollect.Learner.CodingAgent.Codex](Recollect.Learner.CodingAgent.Codex.md): Provider for OpenAI Codex CLI (`~/.codex/`).
- [Recollect.Learner.CodingAgent.Gemini](Recollect.Learner.CodingAgent.Gemini.md): Provider for Google Gemini CLI (`~/.gemini/`).
- [Recollect.Learner.CodingAgent.OpenCode](Recollect.Learner.CodingAgent.OpenCode.md): Provider for OpenCode (`~/.local/share/opencode/`).
- [Recollect.Learner.CodingAgent.Provider](Recollect.Learner.CodingAgent.Provider.md): Behaviour for coding agent provider modules.
- [Recollect.Learner.Git](Recollect.Learner.Git.md): Learn from git history — commits, branches, tags.
- [Recollect.Learner.Git.Grouper](Recollect.Learner.Git.Grouper.md): Groups git commits into synthesized development insights.
- [Recollect.Learner.Git.StackDetector](Recollect.Learner.Git.StackDetector.md): Detects the project's technology stack from config files and tracks
framework transitions across git history.
- [Recollect.Learning.Pipeline](Recollect.Learning.Pipeline.md): Orchestrate learning from multiple sources.
- [Recollect.Maintenance.Decay](Recollect.Maintenance.Decay.md): Archives stale entries based on access patterns.
Entries not accessed in N days with fewer than M accesses are archived.

- [Recollect.Maintenance.Reembed](Recollect.Maintenance.Reembed.md): Re-embeds entries, chunks, and entities using a pluggable embedding
function and tracks per-row provenance via `embedding_model_id`.
- [Recollect.MigrationGenerator](Recollect.MigrationGenerator.md): Generates database-specific migration content for Recollect tables.
- [Recollect.Mipmap](Recollect.Mipmap.md): Context mipmaps — progressive detail levels for retrieval.
- [Recollect.Outcome](Recollect.Outcome.md): Outcome feedback for closing the learning loop.
- [Recollect.OutcomeTracker](Recollect.OutcomeTracker.md): ETS table for tracking the last-retrieved entry IDs per scope.
- [Recollect.Pipeline](Recollect.Pipeline.md): Orchestrates the full memory ingestion pipeline.
- [Recollect.Pipeline.Chunker](Recollect.Pipeline.Chunker.md): Splits document text into chunks suitable for embedding and retrieval.
- [Recollect.Pipeline.Embedder](Recollect.Pipeline.Embedder.md): Embeds chunks and entities using the configured embedding provider.
Supports batch processing and async embedding via TaskSupervisor.

- [Recollect.Pipeline.Extractor](Recollect.Pipeline.Extractor.md): Extracts entities and relationships from text chunks using LLM structured output.
Deduplicates and persists results with mention counting.

- [Recollect.Pipeline.Ingester](Recollect.Pipeline.Ingester.md): Ingests content into the memory system with content-hash deduplication.
Creates or updates MemoryDocuments within a collection.

- [Recollect.RetrievalCounter](Recollect.RetrievalCounter.md): GenServer that owns an ETS :counter table for retrieval bumps.
- [Recollect.Schema.Chunk](Recollect.Schema.Chunk.md): Text fragment with vector embedding, created by the Chunker.
Preserves section hierarchy and paragraph boundaries.

- [Recollect.Schema.Collection](Recollect.Schema.Collection.md): Groups related memory documents. One per user/workspace/topic.

- [Recollect.Schema.Document](Recollect.Schema.Document.md): Source content record. Tracks original artifacts/conversations being indexed.
Content hash enables deduplication — unchanged documents skip re-processing.

- [Recollect.Schema.Edge](Recollect.Schema.Edge.md): Lightweight knowledge edge between entries (Tier 2).

- [Recollect.Schema.Entity](Recollect.Schema.Entity.md): Named entity extracted from chunks via LLM.
10 entity types with mention counting and prominence tracking.

- [Recollect.Schema.Entry](Recollect.Schema.Entry.md): Lightweight knowledge entry (Tier 2).
Simple store-embed-search with access tracking and decay support.

- [Recollect.Schema.PipelineRun](Recollect.Schema.PipelineRun.md): Tracks pipeline execution: status, step details, cost, and timing.

- [Recollect.Schema.Relation](Recollect.Schema.Relation.md): Graph edge between entities. 8 typed relations with confidence weights.

- [Recollect.SchemaFit](Recollect.SchemaFit.md): Schema fit computation for new entries.
- [Recollect.SchemaIndex](Recollect.SchemaIndex.md): ETS table for schema acceleration data.
- [Recollect.Search](Recollect.Search.md): Unified search combining vector similarity, graph traversal, and edge following.

- [Recollect.Search.Completion](Recollect.Search.Completion.md): LLM-augmented retrieval that combines hybrid search with LLM reasoning.
- [Recollect.Search.ContextBooster](Recollect.Search.ContextBooster.md): Calculate context boost for search results based on entry hints matching current context.

- [Recollect.Search.ContextFormatter](Recollect.Search.ContextFormatter.md): Formats search results as text suitable for LLM system prompt injection.

- [Recollect.Search.Graph](Recollect.Search.Graph.md): Graph-based search using PostgreSQL recursive CTEs.
Provides neighborhood expansion and relation queries.

- [Recollect.Search.Vector](Recollect.Search.Vector.md): Semantic similarity search over chunks and entries.
- [Recollect.Strength](Recollect.Strength.md): Memory strength calculation based on hippocampal-inspired mechanics.
- [Recollect.Telemetry](Recollect.Telemetry.md): Telemetry events emitted by Recollect.
- [Recollect.TestRepo](Recollect.TestRepo.md)
- [Recollect.Valence](Recollect.Valence.md): Emotional valence inference and handling.
- [Recollect.WorkingMemory](Recollect.WorkingMemory.md): Working memory layer (Tier 0).
- [Recollect.WorkingMemory.Server](Recollect.WorkingMemory.Server.md): GenServer holding a bounded working memory buffer for a single scope.

## Mix Tasks

- [mix recollect.consolidate](Mix.Tasks.Recollect.Consolidate.md): Run Recollect sleep consolidation for a scope.
- [mix recollect.gen.migration](Mix.Tasks.Recollect.Gen.Migration.md): Generates Recollect database migrations in the host application.

