# Canopod

> Canopod is a free, open-source Git worktree and local development service manager with an optional local MCP server for coding agents.

Documentation for Canopod 0.5.0.

Canopod manages Git worktrees, configured development services, ports, logs, terminals, and Postgres database workflows on your own machine. Its source license is AGPL-3.0-only, and downloads are free.

The optional MCP server uses Streamable HTTP on loopback. MCP is off by default. Access is granted per registered repository and capability. It can expose cached status, bounded redacted logs and configuration; create worktrees and run configured setup; manage configured services; and update supported configuration fields with revision checks. It exposes no general shell tool. Dedicated worktree-removal and database-management tools are not exposed in version 0.5. Configured setup and service commands do execute; configuration permission can change an existing service command. Remote MCP exposure is unsupported.

Claude Code and Codex have client setup support. The packaged canopod-backend supports headless operation. The desktop app and an independent headless backend must not own the same runtime directories at the same time.

macOS on Apple Silicon is the validated desktop platform. Linux and Windows packages compile and ship but remain experimental and have not been validated on a desktop. There is no Intel Mac build. The macOS app is not notarized, and the Windows installer is not code-signed. Follow the installation guide for your platform.

Database tooling is Postgres-specific. Other databases can run as services. Canopod sends no analytics; release checks and update downloads contact GitHub. Connected coding agents have their own data handling settings. The limitations and security pages describe the current boundaries.

This optional index helps readers and tools find public documentation. It does not grant permissions or guarantee search or AI visibility.

## Start here

- [Canopod — Git worktree manager & local MCP server](https://canopod.com/content/index.md): Run branches side by side with Canopod. Manage Git worktrees, service ports, Postgres workflows and a local MCP server for Claude Code and Codex. Free and open source.
- [Canopod features — Worktrees, services, databases & agents](https://canopod.com/content/features.md): Explore Canopod’s Git worktree management, stable service ports, Postgres tools, terminals, agent handoffs and local MCP integration.
- [Canopod MCP — Connect Claude Code & Codex to your worktrees](https://canopod.com/content/canopod-mcp.md): Connect local coding agents to Canopod with 15 MCP tools for worktree context, configured setup, services and supported configuration. Choose repositories and permissions.
- [Canopod workflows — PR reviews, hotfixes & coding agents](https://canopod.com/content/workflows.md): Keep PR reviews, hotfixes, agent tasks and database experiments in separate Git worktrees with Canopod. Practical workflows and setup guides.
- [Download Canopod — macOS, Linux & Windows](https://canopod.com/content/download.md): Download Canopod 0.5.0 for macOS on Apple Silicon. Get experimental Linux and Windows packages, Homebrew installation, requirements and first-launch help.

## More pages



## Project

- [Source code](https://github.com/emidhun/canopod): Public source and AGPL-3.0-only license.
- [Releases](https://github.com/emidhun/canopod/releases): Published builds and release notes.
- [All page text](https://canopod.com/llms-full.txt): A combined copy of the public pages on this site.
- [Canopod website](https://canopod.com/): Features, workflows, and downloads.
- [Canopod documentation](https://docs.canopod.com/): Installation, configuration, and MCP setup.