Skip to content
MCP server

LockIn

Open-source notebook where coding agents save notes tied to the commit they describe

Install
Pricing
Open source
Platforms
Web, self-hosted, API
Runs
Remotely
Version
1.0.0
Listing updated
2 days ago

About LockIn

LockIn is an open-source MCP server for knowledge and memory. It runs as a hosted remote server, so there is nothing to install locally.

Most of what you learn in a Claude Code, Codex or Cursor session disappears when it ends. LockIn gives those agents a shared notebook they write to over MCP, and each note is stamped with the agent's name and waits for you to read and witness it before it counts.

Notes record the git commit they were true at, so an agent does not trust one the code has moved past. When two notes disagree, witnessing the newer one removes the old one from search. A handoff pair of tools lets one agent leave its goal, state and next steps so another can pick up mid-task. A Claude Code plugin files each session automatically.

You can also chat with a model about your notes; answers cite the pages they used. The model can run in the browser on WebGPU, locally through Ollama or LM Studio, or via Anthropic, OpenAI, Gemini or OpenRouter with your own key, which stays in the browser. LockIn is AGPL-3.0 and self-hosts with Docker Compose using Postgres; a hosted notebook also exists.

Install

Run in a terminal

claude mcp add --transport http lockin https://lockin.namankhandelwal.dev/api/mcp

Add to Settings → Connectors → Add custom connector

https://lockin.namankhandelwal.dev/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "lockin": {
      "url": "https://lockin.namankhandelwal.dev/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "lockin": {
      "type": "http",
      "url": "https://lockin.namankhandelwal.dev/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "lockin": {
      "serverUrl": "https://lockin.namankhandelwal.dev/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "lockin": {
      "type": "http",
      "url": "https://lockin.namankhandelwal.dev/api/mcp"
    }
  }
}

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

save_note
Saves a note with title, body and subject.
search_notes
Searches the notebook.
get_note
Reads a note by id.
save_handoff
Saves goal, state and next steps for another agent.
pickup_handoff
Picks up the latest handoff.

What it does

Agent-written notes
Agents save, search and read notes through MCP tools, each stamped with who wrote it.
Witnessing
Notes wait for you to read and sign them before they are trusted.
Commit tracking
Every note records the commit it was true at, so stale notes can be spotted.
Agent handoffs
save_handoff and pickup_handoff pass work between agents mid-task.
Ask your notes
Chat with a model of your choice and see which pages each answer came from.
Self-hosting
Run it with Docker Compose; everything exports to Markdown or JSON.

Good for

  • Keep lessons from a coding session beyond the session
  • Hand a half-finished task from Claude Code to Codex
  • Retire outdated notes when the code changes
  • Ask questions answered from your own notes

Pricing

Open source

AGPL-3.0; hosted notebook available

Prices change. Check lockin.namankhandelwal.dev before you buy.

LockIn FAQ

Which agents can connect?

Claude Code, Codex, Cursor and any MCP client, using a token made in Settings.

What licence is it under?

AGPL-3.0.

Where do my model keys go?

They stay in your browser; the site says no keys are kept on its servers.

How do I self-host?

Clone the repository, set AUTH_SECRET in .env and run docker compose up -d.

Can I revoke an agent?

Yes, revoke its token at any time.

Is LockIn free?

Yes. LockIn is open source, so you can use and self-host it for free.

How do I add LockIn to Claude Code?

Run this command in your terminal: claude mcp add --transport http lockin https://lockin.namankhandelwal.dev/api/mcp

What are the best alternatives to LockIn?

The closest alternatives to LockIn are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to LockIn

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools