Docs
Adapter matrix.
Regente is built for agents you already start yourself. The repo adapter is hooks + MCP:
hooks make a session join and heartbeat, while MCP gives the agent tools to claim files, release them,
check conflicts, message the fleet, and accept handoffs. Every Regente MCP tool call also refreshes the
calling agent's presence (throttled to once per 20 seconds by default;
REGENTE_AUTO_HEARTBEAT_INTERVAL_MS overrides), so MCP-attached agents stay online while
working and hook heartbeats and MCP auto-heartbeats behave the same. Existing sessions may need a
restart or fresh terminal before repo-local config is loaded.
Install, repair, discover
regente installEnd to end: initialize .regente/ if needed, install the repo-local Claude Code, Codex, Gemini, and Cursor adapters plus a regente agent skill for each, verify every wiring step with a per-tool checkmark, then wait until the first agent connects (--no-wait skips).regente doctor --adaptersCheck session hooks, heartbeat hooks, edit/commit guard, MCP command, args, env, and cwd.regente doctor --repairRepair missing or stale default adapter wiring; same repair path as --adapters --repair.regente discover --jsonShow running agent sessions, collapsed from helper process trees, with connected/detected/external status. doctor --adapters is deliberately exact: it checks the session hook, heartbeat hook,
edit guard or Codex pre-commit guard, MCP command validity, MCP args, env.REGENTE_ROOT,
and cwd. Workspace roots are compared through realpath, so a repo reached
via a symlinked path (/tmp vs /private/tmp, pnpm-style links) still
verifies instead of reading as stale. If a config really is stale, doctor --repair
rewrites the Regente block without removing existing Entire hooks.
Install also writes a regente skill / onboarding doc beside each tool's config:
.regente/AGENT-ONBOARDING.md, .claude/skills/regente/SKILL.md,
.codex/skills/regente/SKILL.md, .gemini/regente.md, and
.cursor/rules/regente.mdc. Those files teach agents the full loop: claim and release
discipline, the auto-handoff queue, putting a task's outcome on the task itself
(update_task with result), exact usage reporting
(report_usage — never guessed), acking direct messages, and messaging an idle holder
instead of editing around it.
Current support
Claude Code Native repo adapter. SessionStart hook joins; UserPromptSubmit/PostToolUse heartbeat; Stop/SessionEnd mark stale.MCP: .mcp.json → regente-mcp with command, args, env.REGENTE_ROOT, cwd.
Guard: Live PreToolUse edit guard for Edit, Write, MultiEdit, and NotebookEdit. The guard auto-claims an unclaimed file at the first real edit (released when the session ends; set auto_claim: false in .regente/config.json to disable) and warns when a different online agent edited the same file within the last 30 minutes.
Install:
Included in regente install Codex Native repo adapter. .codex/hooks.json joins on SessionStart and heartbeats on prompts/tool use.MCP: .codex/config.toml → [mcp_servers.regente] with command, args, env.REGENTE_ROOT, cwd.
Guard: No live pre-tool edit guard in this release; Regente installs a git pre-commit guard with regente verify-commit. Edits are recorded at commit time, so there is no edit-time auto-claim or block for Codex.
Install:
Included in regente install Gemini CLI Native repo adapter. .gemini/settings.json joins on SessionStart and heartbeats on BeforeModel/AfterTool.MCP: .gemini/settings.json → mcpServers.regente with command, args, env.REGENTE_ROOT, cwd.
Guard: Live BeforeTool edit guard, plus AfterTool heartbeat and SessionEnd stop hook. The guard auto-claims an unclaimed file at the first real edit and warns on interleaved edits by a different online agent.
Install:
Included in regente install Cursor MCP/manual only. No native repo hook is claimed yet; Cursor joins on its first Regente tool call (join_workspace). Every Regente MCP tool call refreshes the session's presence automatically, so an attached Cursor agent does not go stale while it works.MCP: .cursor/mcp.json → mcpServers.regente, written by the default install, plus .cursor/rules/regente.mdc onboarding rules.
Guard: Manual/cooperative only until a real Cursor hook adapter exists: agents claim files with claim_path, and check_edit returns a file's recent editors. No live edit-time guard or auto-claim.
Install:
Included in regente install Aider MCP/manual only. No native repo hook is claimed yet.MCP: Manual MCP attach path while native adapter support is evaluated.
Guard: Manual/cooperative only until a real Aider hook adapter exists.
Install:
Manual MCP attach OpenCode MCP/manual only. No native repo hook is claimed yet.MCP: Manual MCP attach path while native adapter support is evaluated.
Guard: Manual/cooperative only until a real OpenCode hook adapter exists.
Install:
Manual MCP attach Detected vs connected
Discovery is macOS/Linux-first. Regente scans local processes, collapses helper process trees into
one visible agent session, filters renderers/crash handlers/app servers, resolves each process cwd
with lsof where possible, and classifies the result:
connectedRunning in this repo and has a fresh Regente heartbeat.detectedRunning in this repo, but no Regente heartbeat yet. Restart, open a fresh session, or paste the attach prompt.externalRunning elsewhere, so it is not part of this workspace.regente discover --json
regente doctor --repair
# attach prompt for a detected-but-unconnected session:
This repo is coordinated by Regente. Call join_workspace, then claim files before editing.