Local SQLite long-term memory for AI assistants, served over MCP
Project description
agent-logbook
Local SQLite long-term memory for AI assistants, served over MCP. Context window = working memory. This database = long-term memory.
Every decision logged, nothing erased: agent-logbook writes distilled facts and decisions to a plain SQLite file as your assistant works, ranks them by relevance and salience so retrieval stays cheap no matter how old the project gets, and keeps a full supersession chain when something changes — so you can always ask "why did we think that before."
Install
pip install agent-logbook
Quickstart
Register the server with Claude Code (project scope, shared via .mcp.json):
claude mcp add --scope project --transport stdio memory -- \
python -m agent_logbook.server --db .claude/logbook.db
Then paste MEMORY_PROTOCOL.md into your project's CLAUDE.md.
Docs: IMPLEMENTATION_GUIDE.md (architecture + setup) and TESTING_GUIDE.md (3-layer test strategy).
Development
pip install -e ".[dev]" && pytest
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agent_logbook-0.1.0.tar.gz.
File metadata
- Download URL: agent_logbook-0.1.0.tar.gz
- Upload date:
- Size: 15.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
440ee0126e323f13b90791389a5a135dda5636f2e6a0594c00c0ac68bcfecd17
|
|
| MD5 |
1748fb42c6465f1e89763b795ffc2b7e
|
|
| BLAKE2b-256 |
2c925d9a7f9101e901b8c2ca7a9769fdcd79f11253cc43d02b4984728cf13af4
|
File details
Details for the file agent_logbook-0.1.0-py3-none-any.whl.
File metadata
- Download URL: agent_logbook-0.1.0-py3-none-any.whl
- Upload date:
- Size: 9.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9c5fd750a1fc12a4e07a8256ef35cbf6a70bab3f0430bebf481da65987b88a6f
|
|
| MD5 |
10d7d9d336bcee3ebb6c793d05623361
|
|
| BLAKE2b-256 |
0c4a288aa43825d0a90226b8635b7697fd5fd75d2652adbbc57b941ef65d7e8e
|
