# Lockstep AI

> Lockstep AI is an open-source MCP server for knowledge and memory. Shared team memory for Claude Code: approved decisions, standards and skills. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://www.getlockstep.dev
- **Repository:** https://github.com/lockstep-team-agent/lockstep/tree/HEAD/packages/cli
- **MCP Registry name:** io.github.lockstep-team-agent/lockstep
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-14

## About

Lockstep treats a team decision as something with an owner, evidence and a version. It collects candidate decisions from PRDs, Slack, Jira and pull requests, but AI drafts never bind themselves: the named owner confirms them. New versions replace old ones without erasing them.

At the start of a Claude Code session the CLI briefs the agent on the approved rules that apply to the work, including why each exists and what was rejected. An opt-in check flags pull requests that may conflict with a binding decision and shows affected teams. From any change you can trace back to the originating request, evidence, owner and approval.

The npm CLI is installed globally and run with lockstep login, onboard and status; onboarding wires hooks and MCP for your agent. Self-hosting is documented, under Apache-2.0 with docker compose.

## Features

- **Owned decisions:** Each rule has a named owner and attached evidence.
- **Session briefing:** Claude Code sessions start with relevant approved rules.
- **Conflict checks:** An opt-in check flags pull requests against binding decisions.
- **Version history:** Replaced calls stay visible.
- **Standards rollout:** Distributes team standards and skills.
- **Self-hostable:** Apache-2.0 with a docker compose setup.

## Good for

- Make a new engineer's agent follow the team's current checkout rules
- Trace a code change back to the PRD sentence behind it
- Catch a pull request that contradicts an approved decision
- See which sessions received which decisions

## Install

### Claude Code (Terminal)

```sh
claude mcp add lockstep -- npx -y lockstep-cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "lockstep": {
      "command": "npx",
      "args": [
        "-y",
        "lockstep-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "lockstep": {
      "command": "npx",
      "args": [
        "-y",
        "lockstep-cli"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "lockstep": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lockstep-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "lockstep": {
      "command": "npx",
      "args": [
        "-y",
        "lockstep-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "lockstep": {
      "command": "npx",
      "args": [
        "-y",
        "lockstep-cli"
      ]
    }
  }
}
```

## FAQ

### Which agents does it work with?

It targets Claude Code, and the README says any MCP client can call the same tools.

### How do I install it?

npm install -g lockstep-cli, then lockstep login and lockstep onboard.

### Can AI decide for the team?

No. AI drafts do not bind until the owner approves.

### Can I self-host?

Yes, under Apache-2.0 with docker compose.

### Is Lockstep AI free?

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

### How do I add Lockstep AI to Claude Code?

Run this command in your terminal: claude mcp add lockstep -- npx -y lockstep-cli

### What are the best alternatives to Lockstep AI?

The closest alternatives to Lockstep AI 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/lockstep-ai
