Oturumlar arası bağlamı korumak için yapılandırılmış JSON veya SQLite kullanarak yapay zeka ajanları için yerel öncelikli (local-first) uzun süreli bellek sağlar.
Ayrıca bilinen adı LuizEduPP/Rememb
- Yıldızlar
- 5
- Araçlar
- —
- İndirmeler, 30 gün
- 636
- En son sürüm
- 0.3.5
- Son commit
- 2 Kas 2026
- Lisans
- MIT
rememb MCP nedir?
rememb bir MCP sunucusudur. Oturumlar arası bağlamı korumak için yapılandırılmış JSON veya SQLite kullanarak yapay zeka ajanları için yerel öncelikli (local-first) uzun süreli bellek sağlar.
Özet, projenin README dosyasından oluşturuldu
rememb MCP sunucusu hakkında
rememb, farklı sohbet oturumları arasında bağlam kaybını önlemek amacıyla yapay zeka ajanları için yerel öncelikli bir uzun süreli bellek çözümü sunar. Geliştiricilerin ve ekiplerin bulut hizmetlerine veya harici API anahtarlarına güvenmeden kalıcı gerçekleri, kararları ve proje mimarisini depolamasına olanak tanır. Sistem, yapılandırılmış bir JSON backend veya daha büyük veri setleri için bir SQLite veritabanı kullanarak tamamen yerel makinenizde çalışır.
Kullanıcılar, MCP protokolünü kullanarak sunucuyu Cursor, Claude veya VS Code gibi çeşitli IDE'lere ve ajanlara entegre edebilirler. Kurulum süreci, paketin pip aracılığıyla yüklenmesini ve bellek kurallarını ile oturum hook'larını uygulamak için yükleme komutunun çalıştırılmasını içerir. Bellek yönetimi için rememb_write, rememb_edit ve rememb_search dahil olmak üzere on sekiz özel araç sunar. Belleği denetlemek, sürüm geçmişini incelemek ve tarayıcı tabanlı bir panel üzerinden istatistikleri görüntülemek için yerel bir web arayüzü de mevcuttur.
Neler yapabilirsiniz
- 1Proje bağlamını korumaBir yapay zeka ajanı, yeni oturumlarda tekrarlayan açıklamalardan kaçınmak için teknik yığın detaylarını ve mimari kararları saklayabilir.
- 2Belirli bilgileri geri çağırmaGeliştiriciler, anahtar kelime ve token eşleştirme kullanarak ilgili geçmiş bilgileri bulması için bir ajana talimat verebilir.
- 3Değişiklikleri denetleme ve geri yüklemeBellek girişlerinin geçmişini inceleyebilir ve bir üzerine yazma işlemi hatalıysa önceki sürümlere geri dönebilirsiniz.
- 4Proje bazlı bellek yönetimiProject argümanını kullanarak farklı kod depoları için ayrı bellek depoları sürdürebilirsiniz.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
rememb MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a eklerememb MCP'yi Claude Code içine yükleyin
$ claude mcp add rememb -- uvx remembrememb MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"rememb": {
"command": "uvx",
"args": [
"rememb"
]
}
}
}rememb MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"rememb": {
"type": "stdio",
"command": "uvx",
"args": [
"rememb"
]
}
}
}rememb MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"rememb","type":"stdio","command":"uvx","args":["rememb"]}'rememb MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"rememb": {
"command": "uvx",
"args": [
"rememb"
]
}
}
}rememb MCP'yi Codex içine yükleyin
$ codex mcp add rememb -- uvx remembrememb MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.rememb] command = "uvx" args = ["rememb"]
rememb MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user rememb uvx -- remembrememb MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"rememb": {
"command": "uvx",
"args": [
"rememb"
]
}
}
}Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirluizedupp/rememb is public and reachablegithub.com/luizedupp/rememb ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorrememb names luizedupp/rememb as sourcepypi.org/project/rememb/ ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-02github.com/luizedupp/rememb ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from remembGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok13 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
Operate AI agents without losing context between sessions. rememb is local-first long-term memory: structured entries, keyword search, versioning, diff, restore, and audit trail — no cloud, no API keys.
The problem
Teams using agents at real velocity rarely fail because they lack generation. They fail because operating agents every day creates context debt:
- too much re-explaining project facts every session
- too little durable memory outside the chat window
- too little audit trail for why something changed
- too much noise when recalling the right context
Every team or solo developer operating agents professionally hits this wall:
Session 1: "We're using PostgreSQL, auth at src/auth/, prefer async patterns."
Session 2: Agent starts from zero. You explain everything again.
Session 3: Same thing.
Existing solutions often center on hosted memory layers, API keys, or opaque context pipelines. What you actually need is to resume the next session with the minimum correct context and a trail you can inspect.
rememb is built around four memory problems:
- durable facts and decisions instead of session-only chat memory
- keyword search instead of rereading everything (agents judge relevance)
- non-destructive versioning instead of silent overwrites
- local-first audit trail for AI work, not opaque cloud logs
Install
pip install rememb
Quick Start
With MCP (recommended)
1. Install the door, or add the MCP block by hand:
rememb install --apply --project
That writes the MCP server, Memory Rules, and SessionStart / PostToolUse / Stop hooks when the host has them (Cursor and Claude today). Without --apply it only prints the plan. --host limits the target; omit it to write every host rememb install knows (cursor, claude, codex, vscode, copilot, windsurf, continue, gemini, opencode, zed, cline).
Or add this to your IDE's MCP config and paste the rules from MCP_TOOLS.md:
{
"mcpServers": {
"rememb": {
"command": "rememb",
"args": ["mcp"]
}
}
}
Add repeatable --project /path/to/repo args for per-project stores alongside global ~/.rememb. Details: MCP_TOOLS.md.
2. Restart your IDE.
SessionStart injects recent entries, tags, and a short stats block. The agent writes durable memory when something changes, and searches only when targeted recall is needed.
No extra storage setup is required. In MCP mode, rememb auto-initializes ~/.rememb and optional --project stores on first use. Public tools: MCP_TOOLS.md (18 tools).
If you want multiple MCP clients on the same machine to reuse one already-running rememb process, start a persistent local SSE transport:
rememb mcp --transport sse --host 127.0.0.1 --port 8765
This keeps one MCP process alive, so repeated clients can connect through http://127.0.0.1:8765/sse and http://127.0.0.1:8765/messages/.
Do not put --transport sse inside a stdio MCP client config. stdio clients expect JSON-RPC on stdin/stdout; the SSE mode exposes an HTTP endpoint and must be started separately.
Local usage without MCP
rememb # Open the web UI (http://localhost:18181)
rememb --port 9000 # Custom port
How it works
~/.rememb/ ← default store location (MCP and Web UI)
entries.json ← default JSON backend (or entries.db with SQLite)
meta.json ← project metadata
config.json ← limits, sections, storage backend, UI paging
A local store on disk. Your agent can read prior decisions, search by keywords and tokens, update entries without losing history, and restore previous versions without depending on a cloud memory service. Copy ~/.rememb/ anywhere to move the store.
User: "We're using PostgreSQL, auth at src/auth/, async patterns"
Agent: [rememb_write] → Saved
[New session]
SessionStart injects recent + tags + stats (handoff first)
Agent: "I see you're using PostgreSQL with auth at src/auth/..."
Writes, edits, and deletes go through rememb_write, rememb_edit, and rememb_delete. Host hooks also write into actions via rememb hook post-tool / stop. For the full MCP surface, see MCP_TOOLS.md.
Search uses keyword and token matching over entry content and tags. rememb_search returns id, score, tags, date, and a short excerpt (search_excerpt_chars, default 160). Full body is rememb_get / rememb_read on the ids the agent picked, or max_chars=0 on search. The agent applies semantic relevance judgment. No API keys, no cloud, no embedding model download at runtime.
config.json is written during initialization with all supported knobs:
{
"max_content_length": 1000000,
"max_tag_length": 500,
"max_tags_per_entry": 100,
"max_entries": 100000,
"sections": ["project", "actions", "systems", "requests", "user", "context"],
"section_colors": {
"project": "#d84848",
"actions": "#d08020",
"systems": "#d4c430",
"requests": "#40c040",
"user": "#20d4c4",
"context": "#c060f0"
},
"entry_batch_size": 24,
"entry_load_threshold": 6,
"search_excerpt_chars": 160,
"storage_backend": "json"
}
Set storage_backend to sqlite for larger stores. The Web UI and MCP migrate existing JSON entries automatically when you switch backends.
entry_batch_size and entry_load_threshold control pagination in the web UI — how many cards load at once and when to trigger "load more".
Section names are normalized to lowercase, duplicates are ignored after normalization, and removing a section with existing entries automatically migrates those entries to uncategorized. meta.json is kept in sync with the current effective section list.
Older stores may still contain legacy embedding-related config keys; they are dropped the next time configuration is loaded or saved.
Memory sections
| Section | What to store |
|---|---|
project |
Tech stack, architecture, goals |
actions |
What was done, decisions made |
systems |
Services, modules, integrations |
requests |
User preferences, recurring asks |
user |
Name, style, expertise, preferences |
context |
Anything else relevant |
Web UI
rememb includes a local web interface for supervision — browse memory, inspect history, and tune runtime settings. The SPA has no create/edit/delete controls. The HTTP API still has write, delete, and restore routes.
rememb # Open the web UI (http://localhost:18181)
rememb --host 0.0.0.0 # Bind to all interfaces
rememb --port 9000 # Custom port
rememb --no-browser # Start server without opening the browser
Overview with entry totals and recent memory activity.
Stats with totals, section breakdown, date range, and recent entries.
Settings for limits, storage backend, section colors, and maintenance actions.
Skills browser for bundled agent skills included with rememb.
Views:
- Overview — entry totals, deleted count, store size, and recent memory
- Memory — browse, keyword search, filter by section, sort, and include deleted entries
- Stats — totals, backend, section bars, oldest/newest timestamps, and recent entries
- Settings — edit limits, storage backend, section colors, consolidate duplicates, and save runtime config
- Skills — browse bundled agent skills (61 skills shipped in the package)
Entry inspection from the UI includes version history and side-by-side diff. Entry mutations and restore are MCP (rememb_write, rememb_edit, rememb_delete, rememb_restore) or the HTTP API, not SPA controls.
CLI
rememb # Open the web UI (http://localhost:18181)
rememb --host 0.0.0.0 --port 18181 --no-browser # Custom bind, no auto-open
rememb mcp # Start MCP server over stdio
rememb mcp --transport sse --host 127.0.0.1 --port 8765 # One persistent local MCP process
rememb hook session-start # Inject recent + tags + stats
rememb hook post-tool # Write a PostToolUse event from stdin
rememb hook stop # Write a Stop/handoff entry from stdin
rememb install # Show MCP + rules + hooks plan
rememb install --apply --project # Write them for the current directory
rememb --version, -v # Show version
rememb --help, -h # Show help
Compatibility
The current compatibility surface is tracked explicitly in COMPATIBILITY.md.
Short version:
- Python 3.11 to 3.14 are covered by CI
- CLI contract and MCP tool schema (18 tools) have automated test coverage
- stdio MCP is the primary documented integration path
- SSE MCP is documented and partially tested at the route level
- release automation and Trusted Publishing are documented in RELEASE.md
Design
- Local first — plain JSON or SQLite on disk
- Portable — copy
~/.rememb/anywhere, it works - Agnostic — any agent, any IDE (MCP or CLI)
- No lock-in — no servers, no API keys, no accounts
Core capabilities:
- structured memory with sections and tags
- keyword search with agent-side relevance judgment (
rememb_searchis an index: id, score, excerpt; full body via get/read) - host door: SessionStart injects recent + tags + stats; PostToolUse / Stop write into
actions; Stop tagshandoffso the next host sees it first rememb installwrites MCP, Memory Rules, and hooks (hooks for Cursor and Claude)- non-destructive versioning, diff, restore, and soft delete
- duplicate consolidation (exact content) and store stats
- config and maintenance via Web UI (settings and consolidate; entry mutations via MCP or HTTP API)
- 61 bundled agent skills via Web UI and MCP
Contributing
git clone https://github.com/LuizEduPP/Rememb
cd Rememb
pip install -e ".[dev]"
PRs welcome. Issues welcome. Stars welcome. 🌟
License
MIT
rememb MCP soruları
rememb MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add rememb -- uvx rememb komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
rememb MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
rememb internet bağlantısı veya API anahtarı gerektiriyor mu?
Hayır, bulut hizmetleri veya API anahtarları gerektirmeyen yerel öncelikli bir çözümdür.
rememb'i IDE'm ile nasıl kullanabilirim?
Cursor ve Claude gibi desteklenen hostlar için MCP, Memory Rules ve hook'ları otomatik olarak yapılandırmak amacıyla 'rememb install --apply --project' komutunu kullanarak yükleyebilirsiniz.
Bellek girişlerimi görsel bir arayüz üzerinden yönetebilir miyim?
Evet, rememb; belleğe göz atmak, geçmişi incelemek ve ayarları düzenlemek için yerel bir web UI içerir.
Hangi depolama formatları destekleniyor?
Varsayılan olarak JSON backend desteklenir; daha büyük veri depoları için SQLite'a geçiş yapılabilir.