CAIRN //LOCAL-FIRST 57.4736°N 4.0722°W //MMXXVI
Stacked cairn marker
FIG.01 — STACKED MARKER
N 57.4736 / W 4.0722
THE MEMORY YOU ACTUALLY OWN

Knowledge worth stacking.

Cairn is episodic memory for you and your AI — it captures what you actually worked through (decisions, dead ends, the reasons why) as plain-text you own. Local-first, append-only, model-agnostic, built to outlast the chat it was written in. Every note is a marker the next session can follow — future you, or your next model or agent.

View on GitHub
No cloud, no accounts Plain-text · Open formats
Built To EndureLocal-FirstOwn Your MemoryNo SubscriptionsBuilt To EndureLocal-FirstOwn Your MemoryNo SubscriptionsBuilt To EndureLocal-FirstOwn Your MemoryNo Subscriptions
// 01 — FIELD NOTES

Three things we believe

Field Note01

Local-first

The vault is one file on your machine — ~/.cairn/cairn.db — and it stays there. No cloud, no accounts, no telemetry, no one peeking over your shoulder. Your memory isn't a product. We think you should own it.

Field Note02

Yours to keep

Plain text in open formats, append-only by law — the database itself refuses edits. Notes are voided, never deleted; the record can be corrected but never quietly rewritten. No link rot, no lock-in, no expiry date. What you learned outlasts the tool you learned it in.

Field Note03

Leave the why, not just the what

Every note is a marker for the next session on the trail — future you, or your next model or agent. Cairn keeps the path, not just the answers: the decisions, the dead ends, and the reasons why. The path is the retrieval.

// 02 — MANIFESTO

Knowledge is a trail. Not a destination.

Every session ends. Chats compress, context rolls over, and the why falls through the cracks. Cairn stacks what mattered — plain text you own, on your machine and nowhere else — so the decisions and dead ends outlast the conversation that made them. Every note is a marker the next session can follow: future you, or your next model or agent. Nothing disappears.

CAIRN REMEMBERS · SEALED MMXXVI
Hand-drawn trail map with cairn markers
// 03 — CONNECTIONS

One vault. Every model.

Model-agnostic by construction. Two rival vendors' models have already shared a single vault, live — one wrote, the other remembered.

MCP server

Any MCP-speaking agent connects and gets the full memory toolkit — orient, note, fetch, search. Claude, Codex, whatever ships next.

CLI

The whole vault from a terminal: capture, query, the nightly sleep, the Garden. Pure Python — no daemon, no service, no account.

Session hooks

Ambient capture while you work — decisions and context land in the vault on their own, and the right memory surfaces at the right moment.

// 04 — THE NIGHT SHIFT

While you sleep, it does too.

Every night, on your machine's clock — no server, no cron service in the cloud — the vault runs its sleep cycle:

01 · DREAM

The day's notes are embedded — findable by meaning, not just words.

02 · CONSOLIDATE

Repeated episodes distill into knowledge — the way sleep turns a day into memory.

03 · CONNECT

The graph rebuilds: topics find their names, every memory finds its place.

04 · AUDIT

The vault checks itself — stale threads, blind spots, drift — and files what it finds for your morning.

Built in the open.

Clone it, read it, run it, add your stone to the stack. Yours to read, run, and keep.

$ git clone https://github.com/CairnRemembers/cairn.git
Star on GitHub
Pure Python + NumPy  ·  Zero cloud  ·  Zero accounts  ·  Zero phone-home