# corralctl

> corralctl is an open-source MCP server for developer tools. Search code and symbols across every repository you have cloned, with no network calls. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux
- **Website:** https://doc.corrallib.com
- **Repository:** https://github.com/sebastienrousseau/corralctl
- **MCP Registry name:** io.github.sebastienrousseau/corralctl
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

corralctl is a Go command-line tool that clones all of an owner's repositories from GitHub, GitLab, Gitea, Forgejo, Codeberg or Bitbucket into one tidy hierarchy, sorted into Public, Private and Forks and then by ecosystem. On macOS it writes native Finder tags for lifecycle, visibility, ecosystem, owner and fork status while keeping tags you added yourself. Repeat runs compare each remote's pushed_at time to skip needless calls, which the site says makes them 10 to 50 times faster.

The MCP server is the part that matters here. It lets a coding agent search code and symbols across every clone in the workspace at once, rather than only the project it has open. It is read-only by default, makes no network calls and does not touch a forge API unless you opt in.

It ships as an OCI image for the registry and is also installable through mise, Homebrew, AUR, Nix or the Go toolchain. The site says releases carry cosign-signed checksums and SLSA provenance.

## Features

- **Workspace-wide search:** Agents search code across all cloned repositories at once.
- **Symbol lookup:** Finds where something is defined across every clone.
- **Offline by default:** The MCP server makes no network calls.
- **Multi-forge cloning:** Clones from six forges into a Finder-friendly layout.
- **Finder tags:** Applies native macOS tags and preserves your own.
- **Smart syncing:** Skips unchanged repositories using pushed_at metadata.
- **Signed releases:** Checksums are cosign-signed with SLSA provenance.

## Good for

- Ask an agent where a function is defined across all your repos
- Clone every repository for an owner in one command
- Keep a local mirror organised by ecosystem
- Search old projects for a code pattern
- Run Git commands across many clones

## Install

### Claude Code (Terminal)

```sh
claude mcp add corralctl -- docker run -i --rm ghcr.io/sebastienrousseau/corralctl:0.0.54
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "corralctl": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/sebastienrousseau/corralctl:0.0.54"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "corralctl": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/sebastienrousseau/corralctl:0.0.54"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "corralctl": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/sebastienrousseau/corralctl:0.0.54"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "corralctl": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/sebastienrousseau/corralctl:0.0.54"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "corralctl": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/sebastienrousseau/corralctl:0.0.54"
      ]
    }
  }
}
```

## FAQ

### Does the MCP server use the network?

No. It makes no network calls and does not reach the GitHub API unless you opt in.

### Is it read-only?

Yes, by default.

### Which forges does it support?

GitHub, GitLab, Gitea, Forgejo, Codeberg and Bitbucket.

### How do I install the CLI?

Through mise, Homebrew on macOS, AUR, Nix, go install or from source.

### Is corralctl free?

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

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

Run this command in your terminal: claude mcp add corralctl -- docker run -i --rm ghcr.io/sebastienrousseau/corralctl:0.0.54

### What are the best alternatives to corralctl?

The closest alternatives to corralctl 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/corralctl
