memento

I wrote Memento to let several piclaw instances share facts without sharing their chats, reminders, credentials or machine-specific notes. One looks after personal work, another deals with servers, and project agents come and go; they all need to know things like where a service runs, why one system replaced another and which machine a project depends on.

Memento gives them an authenticated MCP service over a repository of Markdown concepts. Agents can search, follow links, read a concept and propose changes. Curators can review those proposals and publish them to Git.

Concepts have stable IDs, structured metadata and ordinary Markdown links. Read them with a text editor, inspect their history with Git or rebuild the indexes from the checkout. control.sqlite keeps operations, proposals, dynamic principals, credential verifiers and access activity; derived.sqlite holds FTS5, backlinks, graph metrics and optional embeddings.

What Belongs Here

Shared memory is for facts that should outlive a conversation and be useful to more than one agent:

• where a service runs and who owns it;
• why one system replaced another;
• relationships between people, projects, machines and services;
• aliases, tags and links that make the same fact easier to find later;
• reviewed operating knowledge that several agents should follow.

Chat transcripts, daily notes, reminders, schedules, passwords and tokens stay with the agent or machine that owns them.