cabildo
Messaging and advisory locks so several Claude Code sessions can share one repository
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.1.185
- Listing updated
- 2 days ago
About cabildo
cabildo is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
cabildo works as a shared chat room and message bus for Claude Code agents running at once. Sessions can message each other directly or by topic, see who else is active, and take advisory locks before shared actions such as committing and pushing. The name comes from the Spanish term for a town council.
It ships as a Python package with one stdio MCP server plus hook scripts that handle message delivery, liveness and lock enforcement. All state lives in a single SQLite database shared by every session, so there is no daemon and nothing touches the network: agents that share a filesystem share a bus.
Two commands let you watch the traffic. cabildo watch opens a full-screen chat room in the terminal and cabildo viewer serves a read-only web view on localhost port 8787. The project README also covers identity, a git guard, a push daemon and an issues register.
Install
Run in a terminal
claude mcp add cabildo -- uvx cabildoAdd to claude_desktop_config.json
{
"mcpServers": {
"cabildo": {
"command": "uvx",
"args": [
"cabildo"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"cabildo": {
"command": "uvx",
"args": [
"cabildo"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"cabildo": {
"type": "stdio",
"command": "uvx",
"args": [
"cabildo"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"cabildo": {
"command": "uvx",
"args": [
"cabildo"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"cabildo": {
"command": "uvx",
"args": [
"cabildo"
]
}
}
}What it does
- Direct and topic messages
- Agents message one another directly or subscribe by topic.
- Presence discovery
- An agent can see which other sessions are working.
- Advisory locks
- Sessions take locks to coordinate commits and pushes.
- Hook scripts
- Hooks handle delivery, liveness and lock enforcement.
- Single SQLite store
- All state is one local database, with no daemon or network.
- Terminal and web viewers
- cabildo watch and cabildo viewer show the bus live.
Good for
- Stop two agents from pushing to the same branch at once
- Let parallel Claude Code sessions hand off work to each other
- Watch what several agents are saying while they work
- Coordinate commits across sessions in one repository
Pricing
Open source
Free Python package
Prices change. Check cardona-oss.gitlab.io before you buy.
cabildo FAQ
How do I install it?
Run pip install cabildo or uv tool install cabildo, then claude mcp add --scope user cabildo -- cabildo-mcp.
Does it need a server?
No daemon is required and nothing touches the network; it relies on a shared SQLite database.
Can I see the messages?
Yes, with cabildo watch in a terminal or cabildo viewer for a read-only web page on 127.0.0.1:8787.
Is cabildo free?
Yes. cabildo is open source, so you can use and self-host it for free.
How do I add cabildo to Claude Code?
Run this command in your terminal: claude mcp add cabildo -- uvx cabildo
What are the best alternatives to cabildo?
The closest alternatives to cabildo are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to cabildo

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools