Portable memory for AI tools · Open source · MIT

One memory.
All your clankers.

Every AI tool knows you differently today - and most don't know you at all. Clankervault is one folder of plain markdown that all of them read: who you are, how you work, what you decided and why. On every machine, in every account, the same.

Read the source

No account. No cloud. Your files, on your disk, in a format you can read with cat.

Claude Code

on your other machine has no idea what you started yesterday.

Cursor

doesn't know why you built things the way you built them.

ChatGPT

doesn't remember you from the last six months.

Every session

everything you ever cleared up with them died when the window closed.

The mechanic

A vault is the database. Their context files are just views.

You keep one readable folder. clanker compile renders it into the native file each tool already loads automatically - so your agents don't need to learn anything. They just wake up knowing you.

~/vault
vault/
├── me/
│   ├── profile.md
│   └── taste/
└── projects/
    └── cettra/
        ├── project.md
        ├── records/
        │   └── ...one file
        │      per fact
        └── state.md
->clanker compile
CLAUDE.md Claude Code
AGENTS.md Codex & friends
.cursorrules Cursor
GEMINI.md Gemini CLI
.windsurfrules Windsurf
MCP server chat assistants
Setup is one command

It finds your tools and your projects by itself.

clanker setup detects what's installed, discovers your projects from real session transcripts, wires the hooks and MCP configs, and compiles everything. Real output from a real machine:

clanker setup
$ clanker setup
Detected tools: claude-code, codex, cursor, gemini, claude-desktop
Registered project cettra (/Users/you/Development/cettra-eshop)
Registered project verdikt (/Users/you/Development/verdikt-apps)
Wired Claude Code SessionStart hook
Wired Claude Desktop MCP config
Wired Cursor MCP config
Fast-forwarded 790 transcript(s); mining starts fresh from here.
skipped ~/Development/studio/CLAUDE.md: existing file is not
clankervault-generated (use --force to overwrite)
Compiled 14 project(s).

That skipped line is a feature: it never overwrites a context file you wrote by hand.

The format

One file per thing you know. Owned by you, readable forever.

records/2026-07-12-export-shorts.md
---
type: recipe
status: confirmed
source: claude-code   # where it came from
tags: [ffmpeg, shorts]
---

# Export shorts

## How
`ffmpeg -crf 18 -preset slow`

## Why
CRF 23 blurred the text after
the platform recompressed it.
18 is verified sharp.
  • append-only
    Changing your mind creates a new record and links the old one. History for free, zero sync conflicts.
  • provenance
    Every record knows where it came from. Nothing an assistant writes reaches your context until you confirm it.
  • yours
    If Clankervault disappears tomorrow, your memory is still a folder of markdown that opens in anything.
Mining

And you don't have to write it. Your sessions write it for you.

clanker mine distills decisions, recipes and work-in-progress out of your AI session transcripts - starting with Claude Code, more tools on the way. Everything mined lands as a pending record: nothing settles into your memory without your say.

Everywhere you work

Synced between machines. Encrypted end to end.

  • sync
    Any shared folder works as the remote today: iCloud Drive, Dropbox, a NAS, a USB stick. Or run your own clanker serve. The remote only ever sees ciphertext.
  • conflicts
    Append-only records merge cleanly. When two machines edit the same file, the newer wins and the loser is kept next to it. Never silent loss.
  • chat apps
    Over MCP your memory reaches chat assistants too - Claude Desktop and Claude Code today; ChatGPT and Gemini as soon as the hosted endpoint ships.
two machines, one memory
macbook $ clanker add fact "Deploy on Vercel"
macbook $ clanker sync
synced: 5 up, 0 down, 0 conflicts

mini $ clanker sync
synced: 0 up, 3 down, 0 conflicts
mini $ clanker list -p demo
fct-2026-07-24  [confirmed]  Deploy on Vercel

# what the cloud folder sees:
cloud $ ls objects/ | head -2
435f9bc30a013f8bf673226f...
8ab16c62d4a94dbdb00d1056...

Wherever you talk to AI, you're talking to someone who knows you.

Star on GitHub