← AI Lab
04 / AI LAB / ARIADNE

Ariadne

ShippedPrivate repo

Coding agents forget everything between sessions. Ariadne fixes that.

Every Claude Code session starts from zero. You re-explain the project, the plan, the decisions. Ariadne fixes this with a tiny engine and a plain-markdown vault: it captures what happened at the end of each session and recalls the right context at the start of the next — automatically, on every machine.

The engine is a single Node script, no dependencies, no install step. It hooks into Claude Code's SessionStart and SessionEnd lifecycle so memory just works. The vault is a private git repo — ordinary markdown files you can read, edit, and version like any other notes.

Named for the thread that leads you back out of the labyrinth.

ZERO DEPENDENCIES

Node stdlib only — fs, path, os, child_process. No npm install, no lockfile, nothing to update. It works on any machine with Node 20+.

AUTOMATIC HOOKS

SessionStart and SessionEnd hooks in Claude Code settings capture context and surface it without any manual steps. The thread just exists.

PLAIN MARKDOWN VAULT

Memory lives in a private git repo as ordinary .md files. If the project ever stops working, the notes stay readable in any editor.

MULTI-MACHINE SYNC

Git handles distribution. The same vault is available on every machine you work on — no cloud account, no API key, no monthly bill.

WORK / PERSONAL SPLIT

Work repos are gitignored locally and never enter the shared vault. Personal projects sync freely. The boundary is explicit and auditable.

CONSOLIDATION

A background librarian distills raw session logs into durable notes over time, so the vault gets smarter rather than just bigger.