KEEP_

Open source · Apache-2.0 · Research preview

Memory your agents can't quietly rewrite.

Keep is open-source memory and knowledge for AI agents. Keep gives Claude Code, Codex and Copilot CLI one shared memory per project. Every change is a revision. When a fact changes, the old one is marked superseded, not deleted.

Get Keep on GitHubRead the setup docs

Keep is a research preview. It works, but it is early.

Works with Claude CodeCodexCopilot CLIAny MCP client

Stores in In memoryPostgres + pgvectorPostgres + Qdrant

Pick a date. See what was true.

Example data

  1. Pick a date
  2. See what was true
  3. See what changed
DATE2026-05-01

JanFebMarAprMayJunJulAugSepOctNov
Deploy target is Heroku
Deploy target is Fly.io
Run tests with npm test
Run tests with pnpm vitest run
Billing API uses Node 18
Billing API uses Node 22
  • True on this date
  • Replaced later. Still stored.
  • Not recorded yet
See the request an agent would send

Example call to knowledge_search. Sample data from an example project.

How it works

What goes in, what Keep stores, what it derives, what your agent gets.

  1. 1

    What goes in

    Your notes, documents and conversations.

  2. 2

    What Keep stores

    Memory files as revisions. Episodes that are never edited.

  3. 3

    What Keep derives

    Facts, each linked to the exact text behind it.

  4. 4

    What your agent gets

    Memory at session start. Cited search on demand.

Remembers what you decided.

Short Markdown files your agent reads at the start of every session.

Tracks what changed.

When a fact changes, the old one is closed, not deleted.

Shows where it came from.

Every fact links to the text that supports it.

Install in one step

Keep asks which database to use, then connects your coding agents.

Run the script

Builds Keep with Rust. You pick in memory, Postgres + pgvector, or Postgres + Qdrant.

curl -fsSL https://keep.tulipfarm.ai/install.sh | sh

Or ask your agent

Works in Claude Code, Codex and Copilot CLI. The agent follows the install file and asks you the same question.

Install https://keep.tulipfarm.ai/install.md

Where it runs

On your machine. Keep calls no hosted service.

On your laptop

Memory stays in the server's process. Nothing else to install.

keep --user me serve &

With your own Postgres

Memory survives restarts. Use pgvector, or add Qdrant.

docker compose --profile postgres-vector up -d

In Docker Compose

Run Keep itself in Compose, with generated secrets.

deploy/compose.yaml

Run with Docker Compose →

01

Memory files

Short Markdown files your agent reads at the start of every session.

  • Plain Markdown. Saved byte for byte.
  • Safe edits. A stale write fails with a conflict.
  • Undo is a new revision. It never rewrites history.
  • Revisions kept. Up to 100 per file, for 30 days.

How Memory works →

# my-app- Run tests with npm test- Deploy target is Heroku
# my-app- Run tests with npm test- Run tests with pnpm vitest run- Deploy target is Heroku
# my-app- Run tests with pnpm vitest run- Deploy target is Heroku- Deploy target is Fly.io- Never commit .env files
02

Knowledge

A record of what happened, and the facts drawn from it.

  • Episodes are never edited.
  • Sources. Each fact links to the exact text behind it.
  • Two kinds of time. Ask what was true on a date, or what Keep knew.
  • Disputes stay visible. If order is unclear, Keep keeps both.

How Knowledge works →

Run tests with npm testSuperseded2026-03-02 → 2026-09-14Run tests with pnpm vitest run2026-09-14 → now
Deploy target is HerokuSuperseded2026-01-20 → 2026-06-03Deploy target is Fly.io2026-06-03 → now
Billing API uses Node 18Superseded2026-02-11 → 2026-10-08Billing API uses Node 222026-10-08 → now

Example facts. An invented project.

03

One memory, every agent

Agents on the same project share the same memory.

  • MCP over stdio for coding agents.
  • HTTP for scripts and dashboards.
  • Local. Listens on 127.0.0.1 by default.
  • Scoped tokens limit what each agent can reach.

Copy-paste setup for each agent →

Install from source, then connect any MCP agent

$ cargo install --path crates/keep-server --features local-embeddings
$ keep --user me serve &
$ keep --project my-app mcp --server http://127.0.0.1:7357
04

Status

Keep is a research preview. We have not yet shown it beats simple baselines.

  • Runs today: Memory, Knowledge and the server.
  • Alpha. The server is an alpha.
  • No benchmark result is published yet.
  • Not passed. Our development runs have not passed the gate. We quote no numbers.

Read the methodology →

Not passed yet

development runs: NOT PASSED
sealed holdout: not run
published results: none

05

Open source, Apache-2.0

Read the code, run the benchmark, check our work.

  • Written in Rust.
  • One public repository holds Memory, Knowledge, the server and the benchmark.
  • Datasets keep their own licences. You download them yourself.

View the repository →

Questions

What is Keep?

Keep is an open-source memory and knowledge system for AI agents, written in Rust. It stores Memory files and a record of facts, and serves them to coding agents over MCP. It is a research preview.

How is Keep different from RAG or a vector database?

Keep does use search, both keyword and vector. It also stores facts with their source and the time range when they were true. When a fact changes, the old version is closed, not overwritten, so you can ask what was true on a date.

Which agents and models does Keep work with?

Claude Code, Codex and Copilot CLI have setup steps in the docs. Any MCP client that can start a stdio server works too. Keep sets no chat model for you. Your agent keeps its own.

Can I run Keep myself?

Yes. Install it from source with cargo install, run keep serve on your machine, and keep memory in process or in your own Postgres. Docker Compose files are in the repo.

Is Keep open source?

Yes. Keep is Apache-2.0 and the code is public on GitHub.

How much does Keep cost?

Keep is open source and you run it yourself. The repo states no hosted service and no price.

Is Keep ready for production?

No. Keep is a research preview and the server is an alpha. The benchmark that decides whether Keep is worth using is not finished. Use it where losing a note is acceptable.

Does Keep send my data to a model provider?

No. The server never calls a hosted model API. It embeds Knowledge with a local model, downloaded once on first start. It talks only to the Postgres and Qdrant you configure.

Does Keep ever delete anything?

Only when you ask. Edits, undos and changed facts become new revisions or fact versions. Old revisions are kept for up to 30 days, and the forget operation erases content for good.