chronica_save_entryLABSCO SUMMARY
The next conversation starts where the last one stopped.
Memory arrives as an opening summary scoped to one project, rather than a search you have to remember to run, so the first message already carries the recent decisions and the items left open.
What it is
A persistent memory layer for Claude Desktop, spoken over stdio and stored in a local SQLite file. Ten tools cover the opening context, the entries saved as the conversation runs, and the search that pulls them back; a separate Streamlit screen handles the tidying up.
What you get
- An opening summary at the top of a conversation: local time, the five most recent entries for the project you name, and the questions and actions still unresolved in that slice —
chronica_compose_opening - A short per-turn payload with the current local time, how long since the last saved memory, and the start of the recent topic —
chronica_session_tick - Entries written out of the conversation in five kinds — note, event, decision, action and question — with tags, a title and an optional relative date like "3 days ago" (3日前) that gets parsed for you —
chronica_save_entry - Search by thread, kind, tag or project, and a timeline over a date range —
chronica_search,chronica_timeline - Daily, weekly and decision summary packs, with counts by kind plus decisions, actions and open questions pulled out —
chronica_summarize - Threads as the unit of a topic: create one, list what exists, read one in detail, and ask when you last spoke —
chronica_create_thread,chronica_list_threads,chronica_get_thread_info,chronica_get_last_seen - A Streamlit screen for curating what has piled up: filter by kind or tag, delete what you do not want, and see which entries take the most of the token budget
Requirements
Python 3.10 or newer, Claude Desktop over stdio, on Windows or macOS. Setup scripts write the client config for you; the store is a SQLite file under the project directory. Pass the project argument on the opening call — without it, entries from other projects can mix into the summary, so confirm the name against the thread list first if you are unsure. The curation screen deletes entries; it does not edit them.
Setup effort
Build from source — git clone https://github.com/Nic9dev/Chronica.git
USE CASES
Picking up a project after a few days away
Name the project at the top of the conversation and read back the current time, the last five things recorded against it, and whatever questions and actions are still open. No scrolling through an old chat to reconstruct where you were.
Keeping a decision from evaporating
Decisions get written as they are made, tagged and filed against the project, rather than left in a transcript nobody reopens. Kinds separate a decision from a note or a task, so the summary can single them out later.
Writing up what happened last week
Ask for a weekly pack over a date range and get counts by kind alongside the decisions, actions and open questions from that window — the raw material for a status update, already sorted.
Pulling up the detail the opening summary left out
The opening only carries titles and a preview of each entry. When you need the full working log, search the same project — optionally by a volume tag — and read the entries in full.
Cutting the memory back down
Open the curation screen, filter by kind or tag, and see which entries are consuming the most of the token budget. Delete the redundant ones; entries are deletable but not editable, so what stays is what was actually saved.
10 tools
Listed in project docs. Your client may show a different list.
chronica_searchchronica_timelinechronica_get_last_seenchronica_compose_openingchronica_session_tickchronica_summarizechronica_create_threadchronica_list_threadschronica_get_thread_infoBEFORE YOU INSTALL
What to know first
Tools you get
10 tools named in the project's documentation. Tool names carry the chronica_ prefix, such as chronica_save_entry.
Requires
Python 3.10+
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
1. Clone the repository
git clone https://github.com/Nic9dev/Chronica.git
cd ChronicaWindows (PowerShell)
.\setup.ps1macOS / Linux
chmod +x setup.sh
./setup.shRestart Claude Desktop
MCP Clients
Claude Desktop — Windows Manual Setup
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txtAdd this to %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"chronica": {
"command": "<YOUR_PATH_TO_CHRONICA>/.venv/Scripts/python.exe",
"args": [
"<YOUR_PATH_TO_CHRONICA>/run_server.py"
],
"env": {
"PYTHONPATH": "<YOUR_PATH_TO_CHRONICA>/src"
}
}
}
}