# keelyard

> keelyard is an open-source MCP server for developer tools. Proof gate, edit snapshots and output trimming for Claude Code, Codex and OpenCode. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://akobirjontulqinovfuture.github.io/keelyard/
- **Repository:** https://github.com/akobirjontulqinovfuture/keelyard
- **MCP Registry name:** io.github.akobirjontulqinovfuture/keelyard
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

keelyard sits between a coding agent and the repository. Its proof gate stops a session from finishing until there is a checklist, evidence for each item and a passing test run after the last edit, and it writes a one-file HTML report. Every edit is snapshotted in a separate git repo, so `keelyard rewind to <n>` undoes a step and you can fork from any one without touching your own .git.

It also shortens tool output: filters keep every failure while removing repeated passing lines, reads are deduplicated, and project_map, outline and find_symbol tools reduce what the agent has to read. Further pieces cover memory search across past sessions, token and cost reports from local logs, a Swarm mode that offloads bulk reading to a cheaper model with citations checked, and an Arena for comparing agents on one task.

The project reports one measured result: on OpenCode with a free model, the lean preset cut session input tokens 14.2x on a noisy 1,566-test suite and 6.0x on a small one, and says Claude Code and Codex savings are not yet measured. It runs locally with no telemetry under Apache-2.0; `keelyard init` wires up hooks, MCP entries and guide files.

## Features

- **Proof gate:** Blocks the agent finishing until a passing test run follows its last edit.
- **Rewind snapshots:** Snapshots every edit in a separate git repo for undo and forking.
- **Output trimming:** Filters long logs but keeps every failure.
- **Context navigation tools:** project_map, outline and find_symbol reduce file reading.
- **Memory and usage:** Searches past sessions and reports tokens and cost from local logs.
- **One-command setup:** `keelyard init` configures hooks, MCP and guides for detected agents.

## Good for

- Stop an agent from saying done while tests fail
- Roll back a bad agent edit, including shell-made changes
- Cut token use on noisy test output
- Compare several agents on the same task
- Search what earlier sessions did

## Install

### Claude Code (Terminal)

```sh
claude mcp add keelyard -- uvx keelyard
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "keelyard": {
      "command": "uvx",
      "args": [
        "keelyard"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "keelyard": {
      "command": "uvx",
      "args": [
        "keelyard"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "keelyard": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "keelyard"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "keelyard": {
      "command": "uvx",
      "args": [
        "keelyard"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "keelyard": {
      "command": "uvx",
      "args": [
        "keelyard"
      ]
    }
  }
}
```

## Tools

- `project_map`: Overview of the project structure.
- `outline`: Outline of a file.
- `find_symbol`: Locate a symbol in the codebase.

## FAQ

### Which agents does it support?

Claude Code, Codex and OpenCode.

### Does it send data anywhere?

No. It runs locally with no telemetry and is not a proxy; it only uses the network if you configure a helper model for swarm.

### Is it open source?

Yes, Apache-2.0.

### How much does it save?

The README reports measured OpenCode savings of 14.2x and 6.0x and says Claude Code and Codex savings are not measured yet.

### Is keelyard free?

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

### How do I add keelyard to Claude Code?

Run this command in your terminal: claude mcp add keelyard -- uvx keelyard

### What are the best alternatives to keelyard?

The closest alternatives to keelyard 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.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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