Foremerge
Coding · tested 2026-09-28 · by the Hlido desk, not the vendor
In short: A deterministic, MCP-first coordination protocol for multi-agent coding — unusually honest about its own limits, and exactly the plumbing a fleet-of-agents future needs.
5 PASS · 0 FAIL of 5 public-surface claims
Quick answer
Foremerge scores 80/100 (STEADY) on Hlido’s independent, hands-on test (reviewed 2026-09-28). STEADY (80) for a coherent, genuinely agent-native protocol with an excellent trust posture — Apache-2.0, local-first with no cloud dependency, a deterministic (no-LLM) detection path, an honest limitations section, and Pricing: Open source (free entry point documented).
Foremerge answers a problem the agent ecosystem is only starting to feel: two coding agents in separate worktrees can each finish clean work that silently undoes the other's, because Git compares text, not intent. Foremerge sits above Git as a shared, queryable store where every agent publishes its intent and semantic scopes (symbol, api, schema, migration, contract, env) before it edits, so collisions surface as an explainable finding while both trees are still clean. Two design choices earn Hlido's respect. First, the conflict detector is deterministic and heuristic with no LLM in the detection path, so the same inputs always produce the same answer — the right call for infrastructure agents must trust. Second, the surface is refreshingly honest: a whole 'what it does not claim' section, a docs/limitations.md, an explicit 'no performance claims until there are' on the missing benchmarks, and a verification lifecycle that treats agent-reported test results as provenance, never proof. It is genuinely agent-native — CLI plus a JSON/OpenAPI loopback daemon plus an 18-tool MCP server over stdio, provider-agnostic by design so mixed Claude+Codex fleets are the design center. The reasons it isn't scored higher are all maturity, not integrity: it's a pre-1.0 (0.5.0) local-first MVP, multi-machine coordination is roadmap not shipped, and there are no published coordinated-vs-uncoordinated results yet — the authors say so themselves. This is a promising, well-designed building block reviewed from its public surface; Hlido did not install it or drive a live multi-agent run here.
Why STEADY
STEADY (80) for a coherent, genuinely agent-native protocol with an excellent trust posture — Apache-2.0, local-first with no cloud dependency, a deterministic (no-LLM) detection path, an honest limitations section, and real traction (512 GitHub stars) for a young project. Held below VITAL because this is a public-surface review (medium confidence, no hands-on multi-agent run by Hlido), the project is explicitly pre-1.0 (0.5.0), multi-machine coordination is not yet in the box, and the authors have published no reproducible coordinated-vs-uncoordinated benchmark yet.
Public-surface checklist
- PASS Homepage loads (required) — foremerge.com returned a full product page (page_title 'Foremerge: catch intent conflicts before code conflicts')
- PASS Primary value prop (required) — 'Catch intent conflicts before code conflicts' — an open-source coordination protocol for coding agents, built above Git
- PASS Cta present (required) — 'Quickstart' / 'View on GitHub' / 'curl -fsSL https://foremerge.com/install.sh | sh'
- PASS Pricing or access — Free and open source (Apache-2.0); binaries for macOS/Linux, or 'cargo install --locked foremerge'
- PASS Evidence or demo — Worked quickstart with a two-agent example, a JSON conflict finding (destructive_vs_additive, rule FM-C001), and an intent→committed lifecycle diagram; benchmark fixtures cited but no published results yet
What it does well
- Names a real, emerging failure mode precisely — two agents making individually-correct edits in separate worktrees that Git merges without conflict but that undo each other's work
- Deterministic, explainable conflict detection with no LLM in the detection path — the same inputs always produce the same finding, which is the correct property for trusted infrastructure
- Maximally agent-native distribution: one Rust binary exposing a CLI, an authenticated JSON/OpenAPI loopback daemon, and an 18-tool MCP server over stdio, with a one-line 'tell your agent to install it' path
- Provider-agnostic by design — mixed Claude + Codex fleets are the design center, and every ChangeSet records which agent/model did what against an exact Git fingerprint
- Unusually honest public surface — an explicit 'what it does not claim' section, docs/limitations.md, advisory-not-locking coordination, and 'no performance claims until there are'
What it fails at
- Explicitly pre-1.0 (0.5.0) MVP with schemas that 'may still change' — an early dependency risk the authors flag themselves
- No published, reproducible coordinated-vs-uncoordinated benchmark yet, so the core value ('catch conflicts before they land') is argued rather than measured
- Local-first only — a single SQLite store shared across worktrees on one machine; multi-machine shared mode is on the roadmap, not shipped
- Deterministic heuristics can miss synonymous concepts and warn on compatible work, as the docs acknowledge — coverage is advisory, not guaranteed
- No hands-on run by Hlido — the conflict-detection quality, tool reliability, and lifecycle gating are asserted by the project, not independently confirmed here
Best for
- Developers running two or more coding agents (Claude Code, Codex, Cursor) in parallel worktrees on the same repository
- Teams building agent harnesses who want a deterministic, scriptable (--json) coordination layer above Git rather than an LLM-judged one
- Open-source-preferring shops comfortable running a self-hosted Rust binary and following an MCP/CLI protocol
- Researchers and platform builders interested in cross-model coordination data (which agent/model did what, validated how)
Not recommended for
- Teams needing coordination across multiple machines today — that mode is roadmap, not shipped
- Buyers who require a published, reproducible benchmark before adopting a coordination claim
- Non-technical users, or anyone unwilling to run a CLI/MCP server and follow a per-repo setup protocol
- Environments where a pre-1.0, single-maintainer open-source dependency is unacceptable
Pricing & access
- ModelOpen source
- Free entry pointYes — a free tier or open-source edition is documented
- Pricing findable on the public surfacePASS Free and open source (Apache-2.0); binaries for macOS/Linux, or 'cargo install --locked foremerge' (tested 2026-09-28)
Derived from Hlido-held evidence only (engine checklist + editorial text); quotes are verbatim from the scorecard; not vendor-supplied; re-derived daily. Verify current prices on the vendor's pricing page. Last verified 2026-09-28.
Related agents
Agent relevance
API CLI MCP Behavioral-testable
Native, MCP-first: an agent (or its harness) installs the Foremerge binary, runs 'foremerge init' and 'foremerge setup all' per repo, then drives coordination through an 18-tool MCP server over stdio (publish_intent, claim_work, check_conflicts, publish_changeset, run_verification, accept_changeset, and more). A CLI with --json and an authenticated JSON/OpenAPI loopback daemon offer the same operations for harnesses preferring HTTP. Provider-agnostic by design — any MCP-capable client drives the identical tools.
Agent-friendly score: 9/10
Score over time
The longitudinal record — every point is the score as published on that date. Raw series.
Evidence
- Open-source (Apache-2.0) coordination protocol for coding agents built above Git — agents publish intent and semantic scopes before editing so conflicts surface while both worktrees are still clean — source (2026-09-28) verified
- Deterministic conflict detection with no LLM in the detection path — the same inputs always produce the same answer; coordination is advisory and never locks a file — source (2026-09-28) verified
- Ships as one binary exposing a CLI, a JSON/OpenAPI loopback daemon, and an 18-tool MCP server over stdio; coordination state lives in a SQLite store under the repo's Git common directory — source (2026-09-28) verified
- Provider-agnostic — mixed Claude + Codex fleets are the design center; every ChangeSet records which agent and model did what against an exact Git fingerprint — source (2026-09-28) verified
- Pre-1.0 (0.5.0) local-first MVP with no published coordinated-vs-uncoordinated benchmark yet and multi-machine coordination out of scope — stated by the project itself — source (2026-09-28) verified