Open source CLI · MIT · plain markdown

Your AI tools,
sharing one memory.

Clankervault is a command line tool. You keep notes about yourself and your projects in one folder of plain markdown, and it generates the context files your AI tools already read: CLAUDE.md for Claude Code, AGENTS.md for Codex, .cursorrules for Cursor, GEMINI.md for Gemini, plus an MCP server for chat apps. Update the folder once, every tool gets it.

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.

What it does

You keep one folder. It generates the files each tool reads.

The vault holds one markdown file per thing worth remembering: a fact about a project, a proven how-to, a decision and its reason, a preference. clanker compile condenses them into the context file each tool auto-loads at start. Those generated files are disposable views; the folder is the source of truth.

~/vault 
vault/
├── me/
│   ├── profile.md
│   └── taste/
└── projects/
    └── shop-api/
        ├── 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

One command wires everything.

clanker setup looks at which AI tools you have installed, reads your existing session transcripts to find the projects you actually work in, registers them, installs a hook so the files stay fresh, and compiles. From then on it runs itself.

clanker setup 
$ clanker setup
Detected tools: claude-code, codex, cursor, gemini, claude-desktop
Registered project shop-api (~/Development/shop-api)
Registered project videos (~/Videos/channel)
Wired Claude Code SessionStart hook
Wired Claude Desktop MCP config
Wired Cursor MCP config
Fast-forwarded 312 transcript(s); mining starts fresh from here.
skipped ~/Development/legacy-app/CLAUDE.md: existing file is
not clankervault-generated (use --force to overwrite)
Compiled 6 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

clanker mine reads your session transcripts and drafts records for you.

It scans what changed in your AI sessions since last time (Claude Code first, more tools coming), pulls out decisions, recipes and work-in-progress, and saves them as pending records with a link back to the exact transcript. Pending means exactly that: nothing enters your compiled context until you confirm it, or until it sits unchallenged long enough to settle.

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