# Lockstep

Supplies AI coding agents with verified engineering decisions directly at session start. Catches changes that contradict agreed team rules before code ships.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Author: lockstep-team-agent
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lockstep-team-agent/lockstep/tree/HEAD/packages/cli
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/lockstep

## What it does

Lockstep extracts technical choices from Slack, Jira, Notion, and pull requests. Each entry requires confirmation from its owner. When a coding agent starts a session, the server provides the active rule set. If proposed code conflicts with a locked decision, the tool flags it immediately.

Repository setup relies on `lockstep-cli`. Running `lockstep login` authenticates the client, while `lockstep onboard` configures hooks and links the agent. Diagnostics run through `lockstep status` to inspect configuration health.

Teams can host the platform independently using `docker compose up` under the Apache-2.0 license. Without running authentication or passing `LOCKSTEP_VENDOR`, the agent will fail to retrieve team records.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `LOCKSTEP_VENDOR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env LOCKSTEP_VENDOR=<LOCKSTEP_VENDOR> --transport stdio cli -- npx -y lockstep-cli
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add cli --env LOCKSTEP_VENDOR=<LOCKSTEP_VENDOR> -- npx -y lockstep-cli
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cli": {
            "command": "npx",
            "args": [
                "-y",
                "lockstep-cli"
            ],
            "env": {
                "LOCKSTEP_VENDOR": "<LOCKSTEP_VENDOR>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cli": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "lockstep-cli"
            ],
            "env": {
                "LOCKSTEP_VENDOR": "<LOCKSTEP_VENDOR>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e LOCKSTEP_VENDOR=<LOCKSTEP_VENDOR> cli npx -y lockstep-cli
```
Replace <…> with your own values

## When to use it
- feed confirmed architectural decisions to coding agents at session start
- detect pull request changes that violate team agreements
- centralize engineering choices across Slack, Notion, Jira, and pull requests
- configure hooks and agent integration using `lockstep onboard`

## Example prompts
- Check my current changes against locked architecture decisions.
- List all confirmed technical guidelines for this repository.

## Similar
- [mcp](https://affpapa.org/en/nevibecode/mcp/waystation-ai-mcp.md) — MCP server · ★ 65
- [PipesHub](https://affpapa.org/en/nevibecode/mcp/pipeshub.md) — MCP server · ★ 17
- [management-talk](https://affpapa.org/en/nevibecode/skills/management-talk.md) — skill · 4600 installs
- [zapier](https://affpapa.org/en/nevibecode/plugins/zapier.md) — plugin · ★ 449
- [workflow-validate](https://affpapa.org/en/nevibecode/skills/workflow-validate.md) — skill · ★ 220
- [bitbucket-workflow](https://affpapa.org/en/nevibecode/skills/bitbucket-workflow.md) — skill · 759 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md