terminal-native agent coordination

Coordinate agents through GitHub. 

Gitmoot installs as an agent skill and local CLI, then coordinates goals, reviews, jobs, locks, PR comments, multi-agent orchestration, and SkillOpt loops across Codex, Claude Code, Kimi Code, and shell agents.

DocsGitHub
agent prompt
Install Gitmoot from https://gitmoot.io/install.sh, read https://gitmoot.io/SKILL.md, enable the Gitmoot skill/plugin for this agent runtime, run the Gitmoot doctor checks, and tell me what is ready.
Gitmoot character illustration.
skill

Start by asking the agent you already use.

You do not need to memorize the Gitmoot command surface first. Ask the runtime to install, read the skill, run the checks, and report readiness.

  1. 01

    Ask your agent

    Paste the prompt into Codex, Claude Code, Kimi Code, or your local runtime.

    Read the Gitmoot skill and prepare this repo.
  2. 02

    Install and check

    The agent installs the CLI, enables the skill/plugin, and runs doctor checks.

    gitmoot plugin doctor
  3. 03

    Coordinate work

    Goals, reviews, jobs, locks, and PR comments move through Gitmoot with attribution.

    gitmoot goal template
stats

Local-first. Zero friction.

One prompt, four runtimes, no hosted control plane. Gitmoot runs on your machine and keeps GitHub as the audit trail.

  • 0

    Runtime adapters

    Codex · Claude · Kimi · Shell

  • 0%

    Local-first

    No hosted control plane

  • $0

    To run

    MIT licensed, self-hosted

  • 0

    Prompt to start

    Paste it, done

tui

A real operator surface for local agent work.

Gitmoot gives you a local cockpit for the things that disappear in ad hoc prompt chains: agent sessions, job state, branch locks, health, reviews, and SkillOpt training.

  • agents
  • sessions
  • jobs
  • locks
  • health
  • reviews
  • SkillOpt training
Gitmoot dashboard with agent rows and dashboard controls.
local

No hosted control plane required.

Gitmoot keeps execution close to your checkout while GitHub remains the collaboration surface and audit trail.

What runs here

A local daemon, repo state, checkout locks, runtime handoff, and job history on your machine or server.

What GitHub keeps

PR comments, review context, task requests, and the durable audit trail your team already uses.

What is not required

No hosted control plane is needed to route local Codex, Claude Code, Kimi Code, or shell agents.

Local daemon and state

Gitmoot owns job routing and recovery close to the checkout.

GitHub-native workflow

Maintainers keep working in issues, PRs, comments, and reviews.

Branch and job locks

Agents claim work instead of colliding in the same repo.

Runtime-flexible agents

Codex, Claude Code, Kimi Code, custom prompts, and shell agents can all participate.

relay

One request becomes a local, attributed result.

Maintainers ask in GitHub or agent chat. Gitmoot claims the job, locks the branch, routes the runtime, and posts the result with context.

  1. 01

    Maintainer asks

    @planner review this PR through Gitmoot

    A request starts in GitHub or in the current agent chat.

  2. 02

    Gitmoot claims

    claim job and lock branch

    The daemon records ownership, checkout state, and runtime target.

  3. 03

    Agent executes

    route to Codex, Claude, or shell

    The selected runtime works locally with the repo and goal context.

  4. 04

    Result returns

    post attributed update

    GitHub receives the status, findings, or follow-up commit context.

orchestra

One request, many coordinated agents.

A coordinator can fan work out to many agents — running in parallel or in dependency order — and reconvene the results, with bounded, attributed jobs.

Structured delegation

A coordinator returns a delegations DAG; independent steps run in parallel and a continuation synthesizes the results.

Ephemeral workers

Spawn throwaway agents from an inline spec — runtime, model, prompt — with no pre-registration, auto-disposed after the job.

Per-model selection

Pick the right model per agent, job, or delegation across Codex, Claude Code, and Kimi Code — a cheap model for easy steps, a stronger one to verify.

skillopt

Optimize the reusable skill, not just one run.

Gitmoot SkillOpt is based on Microsoft SkillOpt, then tuned for human-feedback optimization loops around reusable agent skills.

optimizer preflight
Check whether gitmoot-skillopt is installed and usable. If it is missing, install the current release and verify the optimizer can run before starting a SkillOpt optimization.
  1. Capture

    Collect examples, rankings, repo context, and review packets.

  2. Generate

    Create candidate skill or template behavior from the training set.

  3. Review

    Rank outputs and preserve the human signal that made them better.

  4. Optimize

    Run gitmoot-skillopt after verifying the optimizer binary is usable.

  5. Promote

    Accept, reject, or continue from an explicit candidate decision.

compare

Where Gitmoot fits.

Gitmoot is for teams that want GitHub-native coordination without giving up local execution, locks, review routing, or dashboard visibility.

CapabilityAd hoc promptsPlain GitHub issuesManual PR reviewHosted orchestratorsGitmoot
Agent can install/use directlypartialnonopartialyes
GitHub-native workflownoyesyespartialyes
Local-first executionpartialnopartialnoyes
Branch/job lockingnononopartialyes
Attributed PR commentsnopartialyespartialyes
Review coordinationmanualmanualmanualpartialyes
Skill/template optimizationnononopartialyes
TUI/dashboard visibilitynononopartialyes

Agent can install/use directly

Gitmootyes

Ad hoc prompts
partial
Plain GitHub issues
no
Manual PR review
no
Hosted orchestrators
partial

GitHub-native workflow

Gitmootyes

Ad hoc prompts
no
Plain GitHub issues
yes
Manual PR review
yes
Hosted orchestrators
partial

Local-first execution

Gitmootyes

Ad hoc prompts
partial
Plain GitHub issues
no
Manual PR review
partial
Hosted orchestrators
no

Branch/job locking

Gitmootyes

Ad hoc prompts
no
Plain GitHub issues
no
Manual PR review
no
Hosted orchestrators
partial

Attributed PR comments

Gitmootyes

Ad hoc prompts
no
Plain GitHub issues
partial
Manual PR review
yes
Hosted orchestrators
partial

Review coordination

Gitmootyes

Ad hoc prompts
manual
Plain GitHub issues
manual
Manual PR review
manual
Hosted orchestrators
partial

Skill/template optimization

Gitmootyes

Ad hoc prompts
no
Plain GitHub issues
no
Manual PR review
no
Hosted orchestrators
partial

TUI/dashboard visibility

Gitmootyes

Ad hoc prompts
no
Plain GitHub issues
no
Manual PR review
no
Hosted orchestrators
partial
start

Paste one prompt and let Gitmoot become available.

Read docsReleases