# LockIn

> LockIn is an open-source MCP server for knowledge and memory. Open-source notebook where coding agents save notes tied to the commit they describe. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, self-hosted, API
- **Website:** https://lockin.namankhandelwal.dev
- **Repository:** https://github.com/sky-walkerx/lockin
- **MCP Registry name:** io.github.Sky-walkerX/lockin
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://lockin.namankhandelwal.dev/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "lockin": {
      "url": "https://lockin.namankhandelwal.dev/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/lockin
