git-kura

git-kura is an advanced, conflict-aware keyed worktree coordinator designed specifically for Git users. This tool enables developers, AI coding agents, and project reviewers to manage multiple task-specific worktrees concurrently, significantly reducing the risk of conflicting edits.

Key Features

• Conflict Awareness: git-kura detects potential conflicts early in the development process, preventing disruptions during edits and merges.
• Keyed Worktrees: Each worktree is associated with a unique key, which resolves to a specific branch, ensuring that users work within a controlled environment.
• Path Seals: By claiming specific repository-relative paths, tasks can signal their intended edits, allowing for better coordination and conflict avoidance.

Why Choose git-kura?

In multi-agent development scenarios, confusion often arises from:

• Agents mistakenly editing incorrect worktrees due to manual path selections.
• Reviewers working on different checkouts from those used by implementers.
• Uncoordinated changes to the same files by different agents, leading to late-stage conflicts.
• Drift in local setups across various worktrees and agents.

Kura addresses these challenges with powerful primitives that streamline workflows and improve collaboration among team members.

Quick Start Example

To utilize git-kura, agents can easily generate worktrees and manage path seals to safeguard their changes:

# Agent A
 git kura open issue-54
 cd "$(git kura get issue-54)"
 git kura seal claim README.md
 # edit, test, commit

# Agent B
 git kura open issue-55
 cd "$(git kura get issue-55)"
 git kura seal test README.md   # fails before Agent B edits a path claimed by issue-54

Core Commands

A set of core commands enables effective management of worktrees and path seals:

git kura open <key>             # Create a worktree and branch for a task key
git kura ls                     # List open Kura worktree keys
git kura close <key>            # Remove a managed worktree and release its seals

For detailed command functionality, refer to the commands reference documentation.

Tool Components

git-kura also supports the installation of repository-local components such as pre-commit hooks and specialized skills for AI agents. This functionality enhances safety by preventing conflicting changes before they occur.

Documentation

Comprehensive documentation is available to assist users in installation, command references, and design principles:

• Installation Guide
• Commands Overview

git-kura simplifies multi-agent workflows, allowing for a more manageable and conflict-free development experience.