Rememora
What's new in v1.5.0 — rememora update [--check] surfaces a one-line upgrade hint matched to your install method (Homebrew / cargo / unknown). 1.4.0 and 1.4.1 before it made the autonomous memory pipeline actually work end-to-end on modern Claude Code (the curator parser was inert in 1.2.x — Stop hook fired but no memories were ever saved). Full notes: v1.5.0 · v1.4.1 · v1.4.0 · CHANGELOG
Persistent, cross-agent memory for AI coding agents. One SQLite database, shared by every agent you use.
The problem: Claude Code, Codex, and Gemini CLI each lose context between sessions. Switch agents mid-task and you start from scratch. Come back to a project after a week and the agent has forgotten everything.
Rememora fixes this. A fast Rust CLI that any agent can call via Bash to save and retrieve memories, transfer working context between agents, and build up project knowledge over time — with autonomous curation that extracts memories from session transcripts without manual intervention.
# Agent A (Claude Code) saves a decision
rememora save "Chose Zustand over Redux for state management" \
--category decision --project myapp --importance 0.9
# Agent B (Codex) picks up full context
rememora context --project myapp
# → Returns: project memories + last session state + working context
Features
- Cross-agent memory — Claude Code, Codex, Gemini CLI, or any agent with Bash access
- Session transfer — hand off working state between agents with full continuity
- 6 memory categories — preferences, entities, decisions, events, cases, patterns
- Tiered loading — L0 abstracts (~100 tok) → L1 overviews (~500 tok) → L2 full content
- Hotness scoring — frequently accessed + important memories surface first
- Full-text search — BM25 via SQLite FTS5, zero external dependencies
- Vector search — optional cosine similarity via sqlite-vec + sentence-transformers (feature-gated)
- Hybrid search — reciprocal rank fusion (RRF) merging BM25 + vector results
- Autonomous curation — LLM-powered memory extraction from Claude Code session transcripts
- Memory consolidation — smart dedup, merge, and pruning of stale memories via LLM
- Agent orchestration — dispatch GitHub issues to Claude CLI with quality gates and retry loops
- Eval benchmark — multi-scenario harness measuring instruction compliance and autonomous behavior
- Fast — ~3ms startup, 3.6MB binary, single SQLite database with WAL
- Local-first — everything stays on your machine
Install
# Homebrew (macOS & Linux)
brew install Rememora/tap/rememora
# From source
cargo install --path .
# Or download from GitHub Releases
# https://github.com/Rememora/rememora/releases
Staying up to date
rememora update # hits GitHub, prints status + upgrade hint
rememora update --check # respect 24h cache (use from scripts/hooks)
brew upgrade rememora # actual upgrade (Homebrew)
rememora update detects your install method (Homebrew / cargo install / unknown) from the running binary's path and prints the appropriate upgrade command — it never auto-executes the upgrade. rememora setup --apply also prints the same hint inline when a newer release is cached. Set REMEMORA_NO_UPDATE_CHECK=1 to disable entirely.
Quick Start
# Register a project
rememora project add myapp --path /Users/me/myapp --description "Mobile app" --stack react-native,typescript
# Start a tracked session
rememora session start --agent claude-code --project myapp --intent "implementing auth flow"
# → prints session ID
# Save memories as you work
rememora save "Uses expo-secure-store for token storage" --category decision --project myapp --importance 0.8
rememora save "Stripe API requires idempotency keys for charges" --category entity --project myapp
rememora save "iOS build fails with Hermes + RN 0.76 — disable new arch" --category case --project myapp
# Search memories
rememora search "authentication" --project myapp
# End session with summary
rememora session end <session-id> \
--summary "Auth flow complete. Login, signup, token refresh all working." \
--working-state "Need to add biometric auth. Files: src/auth/"
