Your next session.
Already in context.
Context Vault gives Claude Code, Cursor, and Codex a memory that outlasts the chat. Your agent saves decisions as markdown and finds them again next time.
npx context-vault setupFree locally / No account / Read the docs
Three days later. New editor, empty chat.
Add the logout endpoint.
query: "auth logout refresh tokens" 1 match, decisions/jwt-with-rotating-refresh-tokensThere is no sessions table, so logout has to revoke the refresh token chain. That follows the decision saved on Monday.
- edit
src/routes/logout.ts+22 -0 - edit
src/auth/refresh.ts+9 -1
Illustrative session with made-up project details. The tools, the file layout and the frontmatter are the real ones.
- Claude Codesetup
- Cursorsetup
- Windsurfsetup
- Codexmanual entry
How it works
One setup.
Then it runs on its own.
Connect your editors
One command finds the clients on your machine and adds the MCP entry to each. Codex needs the entry pasted by hand. Then add the agent rules file so the agent knows when to search and save.
$ context-vault setup claude-code cursor windsurf MCP entry written codex: add the entry by hand
Illustrative output Your agent saves what matters
With the rules in place, the agent calls save_context when it makes a decision or learns a convention. Each call writes one markdown file. You type nothing.
> save_context kind decision tags auth, api saved decisions/jwt-with-rotating…
Illustrative output The next session starts informed
Before it asks you again, the agent calls get_context. The match comes back as text, in the same editor or a different one.
> get_context "auth logout" 1 match decisions/jwt-with-rotating… Logout must revoke the refresh token chain. No sessions table.
Illustrative output
What is on disk
It is just a folder.
Read it like one.
The vault is a directory of markdown files with a small index beside it. A local background process, shared by your agent sessions, reads and writes it. There is no cloud service in the loop, and if you uninstall, the files stay.
--- id: 01JX4M8Q2T9KZ3V7B5N6R7QF4X title: JWT with rotating refresh tokens kind: decision tags: ["auth", "api"] source: claude-code created: 2026-09-28T09:14:07Z --- Access tokens last 15 minutes. Refresh tokens rotate on use. No sessions table. Logout revokes the whole chain.
{
"mcpServers": {
"context-vault": {
"command": "context-vault",
"args": ["mcp"]
}
}
}get_contextSearch the vault, full-text and semanticsave_contextWrite or update an entrylist_contextBrowse by kind, tag, or datesession_endSave a summary of the session
Example vault with made-up entries. File layout, frontmatter fields, config and tool names match version 4.
MIT, no limits locally
The engine and the local vault are open source. No account, no entry cap.
Read the licensePlain markdown on disk
Each memory is one file in ~/.vault. Open it, edit it, commit it.
See the pathsFull-text plus embeddings
Hybrid search over a local index. The embedding model runs on your machine.
Read the docsA standard MCP server
Setup writes the config for Claude Code, Cursor, and Windsurf. Codex takes one pasted entry.
Connect a clientPlans
Local is free.
Sync is $9 a month.
The full vault on your machine. MIT licensed, no account, no entry limits.
The same vault synced across machines, a web dashboard, 50K hosted entries, and 10 GB.
Compare plansWhat does Context Vault actually remember?
The context your agent saves: architecture decisions, working patterns, useful references, and session notes. You can inspect and edit the entries as plain markdown files.
Does my context leave my computer?
With the local vault, entries, search and the embedding model all stay on your machine. Hosted mode is an optional, separate service for accessing your vault across devices.
Which AI tools can I use?
Context Vault connects through the Model Context Protocol (MCP). The setup guide covers Claude Code, Cursor, and Windsurf, with configuration options for other MCP-compatible clients.
Is the local vault really free?
Yes. The local vault is open source under the MIT license, with no account required and no entry limits. Optional hosted plans are available when you need a web dashboard and access across machines.