The remnant that survives.

mem + remnant. What's left after context windows die, conversations end, and you come back three weeks later. A local SQLite ledger that knows what you decided, when, why, and whether it's still true.

What your agent gets
recall
Semantic search over past decisions, session logs, and framework fixes. Includes cross-project colony results marked [colony].
log
Record decisions, framework fixes, and session summaries. Framework fixes and rejections auto-promote to your colony.
session_context
Compiled context with narrative briefing: last session, open TODOs, stale decisions, colony fixes. LLM-composed or template.
session_log
Log a progress summary without closing the session. Default when you say "done".
session_close
Close a session with a summary of what shipped, what was decided, and what's next.
synthesise
Ask questions that span multiple records, with citations back to source.
context_for_file
Records relevant to the file being edited.
project_brief
Dynamic 500-token summary of where the project stands right now.
status
Project health — stale records, unresolved contradictions, ledger stats.
check_copy
Validate text against your copy specs. Catches banned phrases.
check_design
Validate against design system specs. Catches banned components.
promote
Manually promote any project record to the colony for cross-project access.
analytics
Decision velocity, knowledge areas, coverage gaps. Sparkline dashboard or JSON.
team_status
Active builders, record counts per builder, unresolved contradictions, last import timestamp.
brief --onboarding
Structured onboarding package: key decisions, architecture patterns, known gotchas, team conventions. 8K token budget.
stigmergy
Reactive cross-builder awareness. When a teammate logs a fix for a file you're working on, it surfaces immediately — not next session.
churn detection
Spots topics that keep getting revisited. When a decision has been superseded 3+ times, memnant flags the underlying tension.

Full list on npm.

How it works

Typed records — decisions, framework fixes, session logs — stored in an append-only SQLite ledger with vector embeddings for semantic search. Framework fixes auto-promote to a machine-local colony that spans all your projects. When the codebase changes under a decision, memnant scores whether the change actually matters — semantic confidence, not a binary flag. Session starts with a narrative briefing — not a raw dump. Team decisions sync through git — with cross-builder contradiction detection, recall filters, and onboarding briefs. Ant-inspired behaviours compound knowledge: pheromone trails boost records accessed together, stigmergy surfaces teammate updates in real time, colony patterns recruit themselves across projects, and churn detection flags decisions that keep getting revisited. Synthesis works with Anthropic, OpenAI, or self-hosted models via Ollama. Everything runs locally.

Who it's for

You work in sessions. Days or weeks apart. Across projects that share patterns. memnant is for builders who want what they learned yesterday to be there tomorrow.

$ memnant

how to install · works offline · mit license