# Dibs

> Dibs is an open-source MCP server for developer tools. Local board that warns coding agents when their work overlaps. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, CLI, self-hosted
- **Website:** https://agenxy.org/projects/dibs/
- **Repository:** https://github.com/agenxy/dibs
- **MCP Registry name:** io.github.Agenxy/dibs
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-14

## About

Dibs reports and does not act. Agents declare what they are working on, and when two of them claim the same issue or directory, Dibs returns an overlap entry such as `same-objective` with the issue reference. The agents can then split the work or hand it over. Claims are advisory: nothing stops an agent writing to a claimed directory, and Dibs does not assign, schedule, spawn or drive agents.

Beyond overlap detection it carries typed mail, questions and handoffs between agents, and can move files without pasting attachments into model context. When an agent needs a decision, the question appears as a desktop notification you can answer in place, and the board keeps the conversation while you are away.

It is written in Go and runs locally with no account and no database. Coordination state lives in an encrypted, append-only, hash-chained ledger that is rebuilt after a crash. The README lists support for Claude Code, Codex, Claude Desktop, Gemini CLI, OpenCode, Pi and Hermes, plus other machines and ChatGPT conversations on the same board.

## Features

- **Overlap reports:** Tells agents when they declare the same issue so they can divide the work.
- **Typed agent mail:** Sends questions and handoffs between agents as structured messages.
- **Desktop questions:** Agent questions arrive as notifications you can answer in place.
- **File transfer:** Passes files between agents without placing them in model context.
- **Crash-safe ledger:** An encrypted, hash-chained, append-only ledger rebuilds state after crashes.
- **Web board:** Open the board with `dibs web` to see what every agent is doing.

## Good for

- Stop two coding agents from fixing the same issue
- Hand a half-finished task from one agent to another
- Answer an agent's question from a desktop notification
- Watch several agent sessions on one board
- Share a file between agents without pasting it into chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add dibs -- npx -y https://github.com/Agenxy/dibs/releases/download/v0.0.18/dibs.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "dibs": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Agenxy/dibs/releases/download/v0.0.18/dibs.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "dibs": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Agenxy/dibs/releases/download/v0.0.18/dibs.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "dibs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Agenxy/dibs/releases/download/v0.0.18/dibs.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "dibs": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Agenxy/dibs/releases/download/v0.0.18/dibs.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "dibs": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Agenxy/dibs/releases/download/v0.0.18/dibs.mcpb"
      ]
    }
  }
}
```

## FAQ

### Does Dibs block an agent from editing a claimed directory?

No. Claims are advisory, and Dibs does not stop writes or assign or schedule agents.

### Does it need an account or database?

No. The README says it runs locally with no account and no database.

### Which agent harnesses does it work with?

Claude Code, Codex, Claude Desktop, Gemini CLI, OpenCode, Pi and Hermes are listed.

### How is it licensed?

GPL-3.0-or-later since v0.0.14; earlier releases through v0.0.13 are Apache-2.0, and a separate commercial licence exists for Agenxy-authored portions.

### Is Dibs free?

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

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

Run this command in your terminal: claude mcp add dibs -- npx -y https://github.com/Agenxy/dibs/releases/download/v0.0.18/dibs.mcpb

### What are the best alternatives to Dibs?

The closest alternatives to Dibs 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.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [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.

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