# Fagan

> Fagan is an open-source MCP server for developer tools. Autonomous coding pipeline pairing frontier models for planning and review with local. It is available on CLI, macOS, Linux, API, self-hosted and Web.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, API, self-hosted, Web
- **Repository:** https://github.com/motock/fagan
- **MCP Registry name:** io.github.motock/fagan
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README says Fagan splits software work by cost: a frontier model decomposes goals, plans stories, reviews diffs and handles risky decisions, while a local open-weight model writes the implementation. Stories are run test-first in isolated git worktrees, reviewed, and merged through a gate that re-runs the suite on the rebased branch.

The project is built around review gates rather than trusting the author model. It includes an overlord that parks high-risk decisions for a human, an acceptance-oracle grading step, and a risk-tiered decision policy. Plans and stories are tracked as JSON, with a dashboard and an optional scheduler daemon that advances ready stories unattended.

It suits developers who already use Claude Code and want to experiment with routing implementation work to local models on macOS or Linux. The README is candid that local dispatch is the weak point for larger stories, and that the cost target is a design goal rather than a benchmarked result.

## Features

- **Model role routing:** Each pipeline role can be assigned to Claude, Ollama, LM Studio, MLX or a LiteLLM-routed vendor through a registry or environment variables.
- **Test-first story execution:** Stories run in isolated git worktrees with tests written before implementation, followed by an independent review pass.
- **Risk-tiered overlord:** High-risk decisions such as irreversible actions, auth or money changes are held for a human in dry-run and gated modes.
- **Merge gate with rebase re-test:** Branches are rebased on master, CI is polled, and the suite is re-run before merging.
- **Plan dashboard and scheduler:** A FastAPI dashboard shows a kanban view of plans and stories, and a scheduler daemon can advance ready work unattended.
- **Stuck-story triage:** Optional auto-triage can escalate a struggling local attempt to Claude, split a story, or hold it for review.

## Good for

- Break a feature goal into dependency-ordered stories and deliver them through review gates
- Route small, well-scoped implementation tasks to a local model to reduce token spend
- Run an unattended coding loop on a repository while keeping merges human-gated
- Add an overlord decision and acceptance-oracle layer to an existing agent setup via the companion server

## FAQ

### Which platforms does it run on?

The README says it is developed on macOS and CI tests it on Ubuntu. MLX requires Apple Silicon, and Windows is untested.

### Do I need a local model to start?

No. With nothing configured, dispatch and review fall back to the Claude Code CLI backend.

### What is the licence?

The repository is licensed under AGPL-3.0-only. Releases through commit 98550bb were Apache-2.0. A separate commercial distribution called Fagan Enterprise is also described.

### Does it merge code automatically?

With PIPELINE_AUTONOMY=gated, low-risk stories that pass review merge unattended. Setting PIPELINE_AUTO_MERGE=0 keeps merges manual.

### Is Fagan free?

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

### What are the best alternatives to Fagan?

The closest alternatives to Fagan are Fable, lake-gate, Claudexor, featureloom and Lm.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.

## Alternatives

- [Fable](https://ai-powered.com/mcp/fable): Fable is an open-source MCP server for ai models and llm tooling.
- [lake-gate](https://ai-powered.com/mcp/lake-gate): lake-gate is an open-source MCP server for developer tools.
- [Claudexor](https://ai-powered.com/mcp/claudexor): Claudexor is an open-source MCP server for developer tools.
- [featureloom](https://ai-powered.com/mcp/featureloom): featureloom is an MCP server for productivity.
- [Lm](https://ai-powered.com/mcp/lm): Lm is an open-source MCP server for ai models and llm tooling.
- [KittyClaw](https://ai-powered.com/mcp/kittyclaw): KittyClaw is an open-source MCP server for developer tools.
- [Fjord](https://ai-powered.com/mcp/fjord): Fjord is an open-source MCP server for developer tools.
- [Board Planner](https://ai-powered.com/mcp/board-planner): Board Planner is a freemium MCP server for productivity.

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