agit (Fato07)

煽动

   ](https://github.com/Fato07/agit/blob/main/go.mod) 

面向AI代理的基于基础架构的Git编排。

煽动 为AI编码代理提供对其Git基础架构的持久、可查询的感知。它管理本地存储库注册表，编排Git工作树以实现代理隔离，检测跨工作树冲突，并协调多个代理之间的任务分配。

问题

AI编码代理（Claude Code、Cursor、Codex、OpenClaw）在没有基础设施持久内存的情况下运行。每个会话都是盲目开始的——不知道可用的存储库、活动工作或其他代理正在做什么。当多个代理在同一个仓库上工作时，只有在合并时才会发现冲突。

解决方案

agit提供：

• 持久注册表 --代理始终知道通过MCP可以获得哪些存储库
• 工作树隔离 --每个代理都有自己的工作区，不需要踩脚趾
• 冲突检测 --在合并时间之前了解重叠的更改
• 任务协调 --代理以原子方式声明工作，防止重复
• 钉钩系统 --在工作树、任务和冲突事件上触发自定义脚本

快速开始

# 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  --cleanup

演示

agit demo

MCP集成

将agit添加到代理的MCP配置中，以实现自动基础设施感知：

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

现在，任何兼容MCP的代理都可以调用 agit_list_repos() 在启动时，立即知道有什么可用的。

命令

全球旗帜

配置

agit将其配置存储在 ~/.agit/config.toml.使用 agit config 子命令或直接编辑文件。

[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'"

支持的挂钩事件: worktree.created, worktree.removed, task.claimed, task.completed, task.failed, conflict.detected

钩子接收环境变量： AGIT_EVENT，加上特定于事件的变量，如 AGIT_WORKTREE_ID, AGIT_TASK_ID, AGIT_REPO.

所有点符号键 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.

MCP工具参考

作为MCP服务器运行时(agit serve)，代理可以使用以下工具：

许可证

麻省理工学院