infinit-mem

infinit-mem

Persistent typed memory for AI coding agents (Codebuff, Claude Code, Cursor, Codex, etc.). Three-layer context system inspired by Memanto's memory architecture.

1. 13 typed memories — instruction, fact, decision, goal, commitment, preference, relationship, context, event, learning, observation, artifact, error
2. Confidence & provenance — every memory tracks how sure you are (0-100) and where it came from (explicit, inferred, observed)
3. Codebase graph — deterministic structural map of the entire codebase (zero LLM cost, SHA-256 cached)

Install

npm install -g infinit-mem

Quick Start

# 1. Initialize a project (creates knowledge.md with memory markers)
cd your-project
infinit-mem init

# 2. Generate the codebase structure graph
infinit-mem graph

# 3. Inject context before starting your agent
infinit-mem inject

Commands

Core Memory

Command	Description
infinit-mem save <title> <content>	Save a memory with type, confidence, provenance
infinit-mem search <query>	Search with keyword, semantic (--semantic), or temporal (--as-of, --changed-since) filters
infinit-mem get <id>	View full memory by ID
infinit-mem edit <id>	Edit memory (creates version history)
infinit-mem forget <id>	Soft-delete a memory (--hard for permanent)
infinit-mem bulk	Bulk import JSON from stdin

Intelligence

Command	Description
infinit-mem conflicts	Detect contradictory memories (semantic similarity + LLM check)
infinit-mem answer <question>	Grounded QA — retrieve relevant memories + LLM answer
infinit-mem daily-summary	Summarize yesterday's observations
infinit-mem upload <file>	Upload files (.md, .txt, .json, .csv, .py, .ts, etc.) into memory

Project Setup

Command	Description
infinit-mem init	Create knowledge.md template in current directory
infinit-mem graph	Generate/update the codebase structure graph
infinit-mem inject	Inject memories + codebase graph into knowledge.md
infinit-mem embed	Generate BGE embeddings for all observations
infinit-mem session	Start/end/summarize coding sessions
infinit-mem export <vault-path>	Export to Obsidian vault (wikilinks, tag indexes)
infinit-mem serve [port]	Start HTTP API server

System

Command	Description
infinit-mem health	Database statistics
infinit-mem timeline	Recent sessions for a project
infinit-mem projects	List all known projects

Memory Types (13 from Memanto)

instruction fact decision goal commitment preference relationship context event learning observation artifact error

Plus backwards-compatible aliases: architecture, bugfix, gotcha, codebase-graph

Save with Confidence & Provenance

infinit-mem save "API key rotation schedule" "Rotate all keys every 90 days" \
  --type instruction --confidence 95 --provenance explicit --importance 9

Temporal Queries

# What changed since last week?
infinit-mem search --changed-since 2026-06-21 --project /my/project

# What did we know as of a specific date?
infinit-mem search "port configuration" --as-of 2026-06-01

Conflict Detection

# Find potentially contradictory memories
infinit-mem conflicts --project /my/project --limit 5

Grounded Q&A

infinit-mem answer "What database credentials are we using for production?" \
  --project /my/project --top-k 5

File Upload

infinit-mem upload docs/api-spec.md --type artifact --title "API Specification"
infinit-mem upload data/export.csv --type observation

Fresh Machine Setup

npm install -g infinit-mem
git clone <your-repo> && cd <your-repo>
infinit-mem init && infinit-mem graph && infinit-mem inject
# Your agent now has full context

Environment

Variable	Default	Description
INFINIT_MEM_PROJECT	cwd	Default project path
INFINIT_MEM_SESSION	—	Current session ID
INFINIT_MEM_PORT	37777	HTTP server port
LLAMA_CPP_BASE_URL	http://127.0.0.1:8081	LLM for summaries/QA

License

MIT