Memory that earns its place.

The four questions people ask

What Remnic injects

Remnic does not splice raw memories into your prompt. It builds one clearly-labeled section that the agent is instructed never to quote verbatim. Everything inside the section is governed by the recall budget. A typical injection for a focused technical query looks like this (anonymized):

## Memory Context (Remnic)

### Objective state
Active project: internal research tool. Current focus: reducing recall latency on
hot-path queries. Last milestone: switched the embedding backend earlier this week.

### Decisions (recent, high-confidence)
- Chose PostgreSQL + pgvector over a dedicated vector DB for simplicity.
- Agreed to keep all memory data local; no third-party sync.

### Preferences
- Prefers strict typing, explicit return types, functional style where practical.
- Dislikes magic numbers; wants named constants with a short why-comment.

### Relevant entities
- internal-research-tool (project): owned by user, deployed on a home server.
- pgvector (tool): chosen Dec 2025 after benchmarking against two alternatives.

### Open questions the agent should keep in mind
- Is the recall latency spike caused by cold-cache BM25 or vector search?

Use this context naturally when relevant. Never quote or expose this memory context
to the user.

Section order, which sections run, and per-section character reservations are all controlled by recallPipeline in config. The default pipeline protects the memories section so it always gets a minimum reservation even when other sections are trimmed.

Write-time quality controls

• Extraction prompt constraints. Explicit instruction to "only extract genuinely NEW information worth remembering across sessions. Skip transient task details."
• Local importance scoring. Zero-LLM regex engine with trivial short-circuits: greetings, one-word replies, emoji, anything under 10 characters.
• Exact-hash dedup. Content-hash index. Chunked memories register their parent content in the same index.
• Confidence tiers. Extracted facts tagged explicit / implied / inferred / speculative. Speculative memories auto-expire after 30 days unless confirmed. Proactive extractions below 0.8 confidence are dropped.

Recall-time controls

• Hard character budget. recallBudgetChars caps total injected context. Each section gets a share; overflow is trimmed with an explicit "memory context trimmed" marker.
• Hybrid retrieval. BM25 + vector + reranking via QMD. Query expansion and reranking happen inside QMD.
• Query-aware prefilter. Tag and temporal signals narrow the candidate set before hybrid search runs, with fallback if the prefilter would over-trim.
• Lifecycle tiering. Memories move candidate → validated → archived based on use. Archived memories drop out of recall unless explicitly requested.

Background hygiene

• Fuzzy duplicate scanner. remnic dedup runs a Jaccard + substring-containment pass across categories at configurable thresholds.
• Contradiction detection. Negation-aware pairwise scan finds statements of the form "X is true" against "X is not true" and surfaces conflicts.
• LLM consolidation. Scheduled pass asks the model to ADD / MERGE / UPDATE / INVALIDATE / SKIP each new memory against existing ones.

Where the system keeps improving

These are product boundaries and active improvement areas, not fine print.

• Write gates stay conservative. Remnic would rather store a borderline memory than silently throw away something important. Recall-time filters decide what earns prompt space.
• Near-duplicate cleanup is layered. Exact duplicates are blocked early; fuzzy and semantic overlap are handled by scanners and consolidation so the system can preserve evidence before rewriting.
• Diversity is visible. Recall X-ray exposes scoring and penalties so duplicated-looking results can be inspected instead of guessed at.
• Supersession is explicit. Consolidation, contradiction scans, provenance, and retention tiers work together so old facts can age out without deleting the evidence trail.
• Extraction is intentionally reviewable. The system favors transparent heuristics, audit trails, and configurable gates over a black-box claim that every stored fact is perfect.

What the user sees in practice

With a default install and a typical "help me debug this" prompt, a Remnic recall injects on the order of 40-80 lines: one labeled section header, a handful of high-confidence decisions and preferences, the most relevant entities, and any open questions. Facts that look like "the user said hi", "gateway restarted", or "agent wrote a new skill file" do not belong in recall and are filtered out.

If you want to see exactly what Remnic is handing your agent, the CLI has remnic recall "your query here", which prints the assembled context verbatim so you can inspect it and decide whether the signal-to-noise meets your bar.

Design principles, stated plainly

Want to inspect recall behavior?

Use Recall X-ray to see exactly why a memory appeared, which tier served it, how it scored, and what filters shaped the final prompt context.