agit

Infrastructure-aware Git orchestration for AI agents.

agit gives AI coding agents persistent, queryable awareness of their Git infrastructure. It manages a local registry of repositories, orchestrates Git worktrees for agent isolation, detects cross-worktree conflicts, and coordinates task assignment across multiple agents.

The Problem

AI coding agents (Claude Code, Cursor, Codex, OpenClaw) operate without persistent memory of their infrastructure. Each session starts blind — no knowledge of available repos, active work, or what other agents are doing. When multiple agents work on the same repo, conflicts are discovered only at merge time.

The Solution

agit provides:

• Persistent registry — agents always know what repos are available via MCP
• Worktree isolation — each agent gets its own workspace, no stepping on toes
• Conflict detection — know about overlapping changes before merge time
• Task coordination — agents claim work atomically, preventing duplication
• Hook system — trigger custom scripts on worktree, task, and conflict events

Quick Start

# Install (binary)
curl -sSfL https://raw.githubusercontent.com/Fato07/agit/main/install.sh | sh

# Or install from source
go install github.com/fathindos/agit@latest

# Initialize
agit init

# Register your repos
agit add ~/projects/my-app --name my-app
agit add ~/projects/api --name api

# Spawn isolated worktrees for agents
agit spawn my-app --task "refactor auth" --agent claude-1
agit spawn my-app --task "add tests" --agent cursor-1

# Check for conflicts
agit conflicts my-app

# See everything at a glance
agit status

# Merge completed work back
agit merge <worktree-id> --cleanup

Demo

MCP Integration

Add agit to your agent's MCP config for automatic infrastructure awareness:

{
  "mcpServers": {
    "agit": {
      "command": "agit",
      "args": ["serve"]
    }
  }
}

Now any MCP-compatible agent can call agit_list_repos() on startup and immediately know what's available.

Commands

Global Flags

Configuration

agit stores its configuration in ~/.agit/config.toml. Use agit config subcommands or edit the file directly.

[server]
transport = "stdio"       # "stdio" or "sse"
port = 3847               # Port for SSE transport

[defaults]
branch_prefix = "agit/"           # Prefix for auto-generated branch names
worktree_dir = ".worktrees"       # Directory for worktrees within repos
cleanup_stale_after = "24h"       # Duration before stale worktrees are cleaned
auto_conflict_check = true        # Check for conflicts automatically

[agent]
heartbeat_interval = "30s"        # Agent heartbeat frequency
stale_after = "5m"                # Duration before agents are marked disconnected

[ui]
color = ""                # "auto", "always", or "never" (empty = auto)
output_format = ""        # "text" or "json" (empty = text)
compact = false           # Compact output mode

[updates]
enabled = true            # Enable automatic update checking
check_interval = "24h"   # How often to check for updates

hook_timeout = "30s"      # Maximum execution time for hooks

[hooks]
# Run shell commands on events (async, non-blocking)
# "worktree.created" = "notify-send 'New worktree created'"
# "task.claimed" = "echo $AGIT_TASK_ID >> /tmp/claimed.log"
# "task.completed" = "./scripts/on-task-done.sh"
# "task.failed" = "curl -X POST https://hooks.example.com/fail"
# "worktree.removed" = "echo cleaned"
# "conflict.detected" = "slack-notify 'Conflict found'"

Supported hook events: worktree.created, worktree.removed, task.claimed, task.completed, task.failed, conflict.detected

Hooks receive environment variables: AGIT_EVENT, plus event-specific variables like AGIT_WORKTREE_ID, AGIT_TASK_ID, AGIT_REPO.

All dot-notation keys for agit config set:

server.transport, server.port, defaults.branch_prefix, defaults.worktree_dir, defaults.cleanup_stale_after, defaults.auto_conflict_check, agent.heartbeat_interval, agent.stale_after, ui.color, ui.output_format, ui.compact, updates.enabled, updates.check_interval, hook_timeout, hooks.<event>

MCP Tools Reference

When running as an MCP server (agit serve), the following tools are available to agents:

License

MIT