Local-first · cross-vendor · pre-merge

Regente

Claude, Codex, and Gemini on one repo — Regente gives each cooperating agent a lane, blocks claim collisions before they reach main, calls the right agent when work needs a handoff, and keeps announcements visible to the whole fleet. Local-first, cross-tool, pre-merge.

Early access · free & open source · local-first

regente — command center · acme-app · live
The Regente desktop command center: a live three-vendor fleet (Claude Code, Codex, Gemini CLI) with roles, owned lanes, the files each agent is editing now, and per-agent presence

Coordinate the agents you already have open.

Regente attaches to your running agents through MCP and session hooks. No new runtime, no orchestrator, no rewriting your workflow. It joins, it doesn't spawn — a neutral coordination layer for the vendors you already run.

  • Join, don't spawn. It coordinates the sessions you've already started — never replaces your agents.
  • Every vendor, one repo. Claude Code, Codex, and Gemini CLI have repo-local adapters today; Cursor and other agent CLIs are MCP/manual attach until native hooks are real.
  • Five-second setup. Run regente install, restart/open agents, and each tool gets a Regente onboarding file or MCP attach path.
  • Local-first. The engine, state, and event log live in .regente/ inside your repo. No cloud account, nothing leaves your machine.
~/acme-app $ regente install
↳ wrote MCP + session hooks for 3 tools
~/acme-app $ claude
↳ joined Regente · role: frontend
~/acme-app $ codex
↳ joined Regente · role: backend
~/acme-app $ regente usage --agent codex --tokens-used 12000 --tokens-limit 50000
● onboarding files written · hooks repaired · calls visible in Overview
Claude Code Codex Gemini CLI

MCP/manual Cursor · Aider · OpenCode


lanes & collisions · live
The Lanes and Collisions panel: a pre-merge collision blocked on src/components/CartSummary.tsx between Claude Code and Codex, an interleaved-edits warning on src/utils/format.js, the auto-handoff queue with codex-backend waiting at position 1, and the in-flight lanes board to main

Caught before merge — not after the PR.

With hooks installed, the first agent to edit a file auto-claims it, and a second agent's edit is blocked before it lands. Claude Code and Gemini CLI block at edit time via hooks; Codex is guarded at commit; Cursor coordinates over MCP. Give each agent a role and the files it owns, and everyone (you included) can see who holds what at a glance.

  • Pre-merge, cross-vendor. Hook-guarded agents are stopped at edit time; Codex is caught at the commit guard.
  • Interleaved edits flagged. Touching a file another online agent edited in the last 30 minutes warns, even when nothing is claimed.
  • A lane for every role. Roles own file globs, so territory is explicit and shared.

It doesn't just block. It hands off.

A lock would tell the second agent “no” and leave it stuck. Regente queues it, tells it exactly what to do, and the instant the first agent releases the file, hands it to the next one in line — automatically, with a note. No idle agents, no clobbered work, no human merging.

  1. 01 · claim
    claude public/index.html editing now
  2. 02 · queue
    #1 codex ⤳ granted on release
  3. 03 · release
    claude public/index.html ✓ released
  4. 04 · owned
    codex public/index.html ✓ auto-handed off

to the blocked agentpublic/index.html is held by claude (frontend). You're #1 in the auto-handoff queue — it's granted to you the moment claude releases. Meanwhile, take an unclaimed file in your lane.” A coordination layer, not a lock.


Worktrees just defer the problem.

The industry's answer to parallel agents is to isolate each one in its own git worktree — which only moves the collision to merge time, with no warning, across no shared view.

“Why did two agents touch the same file again?”

Because nothing was watching across them. Regente sees participating agents at once, auto-claims a file for its first editor, and blocks a hook-guarded second editor before the edit lands.

“Where do the conflicts actually get caught?”

At edit time for hook-guarded agents, at commit for Codex. Worktrees defer conflicts to merge; review tools catch them after the PR. Regente sits in the pre-merge gap.

“Which tool is neutral across all my agents?”

None of them. Agent Teams is Claude-only; GitHub is merge-time. Regente is vendor-neutral by design — repo adapters for Claude, Codex, and Gemini today, with MCP/manual attach for Cursor and other CLIs.


Where the collision actually gets caught.

Worktrees defer it to merge. Agent Teams is one vendor. Review tools catch it after the PR. Regente is the local layer that’s pre-merge and cross-vendor, catching the second editor at edit time for hook-guarded agents and at commit for Codex.

How Regente compares to git worktrees, Claude Agent Teams, and merge-time review across vendor-neutrality, pre-merge conflict prevention, auto-handoff, live fleet visibility, file-level claims, joining running agents, and a cross-vendor record.
Regente Git worktrees Claude Agent Teams Merge-time review
Vendor-neutral repo adapters for Claude · Codex · Gemini; MCP/manual attach for others Yes Not applicable tool-agnostic, but blind across agents No Claude-only Yes
Catches conflicts pre-merge at claim time, before the edit lands Yes at claim No surfaces at merge Partial task-level No after the PR
Auto-hands the file to the next agent the moment the holder releases it Yes No No No
One live view of the whole fleet native and manually joined agents, one screen Yes No each worktree isolated Partial Claude agents only No
File-level claims across vendors not just task assignment Yes Not applicable No task-level Not applicable
Joins the agents you already run never spawns or replaces them Yes Not applicable No spawns teammates Not applicable
Cross-vendor record of who changed what the pre-merge system of record Yes No No Partial at merge

“Merge-time review” = GitHub PRs, CodeRabbit, Greptile — they run once a pull request exists, after the work diverged. The closest tool in spirit is the open-source MCP Agent Mail — its file leases are advisory by default, with optional enforcement only at commit time (a pre-commit guard), and no live cross-vendor GUI. Regente blocks at claim time, adds live edit guards where the client exposes hooks, uses a Codex pre-commit guard where it does not, and shows the whole fleet in one local view — pre-merge and cross-vendor at once.


Setup that verifies itself. Claims that cannot outlive agents.

0.5 makes the two ends of fleet life honest. The first open walks you through a wizard whose steps tick only when the live engine confirms them, and one command wires every vendor end to end. At the long tail, a dead or idle session can no longer sit on your files: claims expire, queued waiters expire, and tasks assigned to gone agents go back to todo.

  • Verified install. regente install writes hooks, MCP, and an agent skill for all four vendors, verifies each with per-tool checkmarks, then waits for your first agent.
  • First-open wizard. The desktop app gates each setup step on live verification, not on clicking next. Runs once, skippable, self-verifying checklist after.
  • Claim expiry. Claims of a holder dark past claim_expiry_minutes (default 60) are released, orphaned auto-claims are swept, and stale assignments revert.
  • In-session delivery. Direct messages land inside the recipient's agent session via the hook heartbeat; the dashboard shows not delivered, delivered, or read.
~/acme-app $ regente install
Wrote 13 adapter, skill, and onboarding files.
✓ Claude Code  ✓ Codex  ✓ Gemini CLI  ✓ Cursor
Waiting for your first agent… (start claude, codex, or gemini here)
● claude-frontend joined (claude-code) — fleet is live
~/acme-app $ regente sweep
↳ expired 2 claims from a holder dark 74 min · 1 task reverted to todo
~/acme-app $ regente inbox --agent codex-backend
✓ 1 direct message delivered in-session · sender sees ✓✓ on ack

One engine, five live views.

The desktop app is the same engine your agents drive over MCP and hooks: Overview for the fleet, Claims for ownership and the auto-handoff queue, Messages for the backchannel, Tasks for the plan, assign, and drive board, and Calls for delegation.

claims · ownership + queue
The Claims view: active claims grouped by agent and directory, and the auto-handoff queue with a pending grant
Who owns what, and who gets it next.
messages · the backchannel
The Messages view: a fleet-wide announcement, a task-linked report-back, a call, and a coordination note from the queue
Announcements, calls, and report-backs with delivery receipts.
tasks · plan → assign → drive
The Tasks view: an orchestration board with todo, assigned, in-progress, and done tasks routed to lane owners
The board your agents actually work from.

Questions, answered.

Is it free?
Yes. Regente is free and open source under the MIT License. Access is rolling out through the waitlist, so join above and we'll send your invite.
Does it work with my agents?
Claude Code, Codex, and Gemini CLI have repo-local adapters today. Cursor and other agent CLIs are MCP/manual attach until native hooks are real.
Where does my code go?
Nowhere. Regente is local-first — its coordination data (claims, lanes, history) stays on your machine and never leaves it. Your agents still talk to their own model providers, just as they do today; Regente adds no server and sends your code nowhere.
Is it a security boundary?
No. Regente is a cooperative guardrail for agents that load its hooks and MCP tools. It prevents accidental collisions among participating agents, but it is not an OS sandbox and a local process can bypass it.

Join the waitlist.

Local-first, cross-vendor coordination for your whole agent fleet. Join the waitlist and we'll send your invite when the next build opens.