agent-git-0.1.0 is not a library.

                          _            _ _
   __ _  __ _  ___ _ __ | |_      __ _(_) |_
  / _` |/ _` |/ _ \ '_ \| __|    / _` | | __|
 | (_| | (_| |  __/ | | | |_    | (_| | | |_
  \__,_|\__, |\___|_| |_|\__|    \__, |_|\__|
        |___/                    |___/

agent-git

A git wrapper that tracks cloned repos and prevents duplicate clones.

Why?

You've cloned the same repo twice. Maybe three times. They're scattered across ~/projects, ~/work, ~/tmp, and that random folder you made last Tuesday.

🔍 "Where did I clone that repo?"
🗑️ "Is this a duplicate?"
📁 "I have 200 repos and no idea where half of them are"

agent-git wraps your git command transparently. Every git clone is intercepted and tracked. Try to clone something you already have? It tells you where it is instead of wasting your disk space.

Install

cargo install agent-git

Quick Start

# Install the alias (wraps git command)
agent-git alias install
source ~/.zshrc

# Now git clone is tracked automatically!
git clone https://github.com/user/repo

# Try cloning again — blocked!
git clone https://github.com/user/repo
# Error: Already cloned at /Users/you/projects/repo

# See all tracked repos
git list

# Find where a repo is
git whereis user/repo

Commands

Command	Description
`agent-git alias install`	Install shell alias (wraps `git`)
`agent-git alias uninstall`	Remove shell alias
`git clone <url>`	Clone with tracking (via alias)
`git list`	List all tracked repos
`git whereis <query>`	Find where a repo is cloned
`git scan [dir]`	Scan directory for existing repos and track them
`git status`	Passthrough to real git (all non-agent commands work normally)

Comparison

Feature	agent-git	ghq	git-repo-manager	sirup
Transparent git wrapper	✅	❌ (separate command)	❌ (separate command)	❌
Duplicate prevention	✅	❌	❌	❌
Clone tracking	✅	✅ (enforced paths)	✅	✅
Free directory structure	✅	❌ (ghq root required)	❌	✅
Repo search	✅	✅	✅	❌
Existing repo scanning	✅	❌	❌	❌
Shell alias approach	✅	❌	❌	❌
Zero behavior change	✅	❌	❌	❌

Key difference: ghq and others force you into their directory structure. agent-git lets you clone wherever you want — it just remembers where everything went.

How It Works

┌──────────────┐     ┌───────────────┐     ┌──────────────┐
│  git clone   │────▶│  agent-git    │────▶│  real git    │
│  (alias)     │     │  intercept    │     │  clone       │
└──────────────┘     └───────┬───────┘     └──────┬───────┘
                             │                     │
                     ┌───────▼───────┐     ┌──────▼───────┐
                     │  Check TOML   │     │  Track new   │
                     │  registry     │     │  clone path  │
                     └───────────────┘     └──────────────┘

Shell alias — agent-git alias install adds a function to your shell that routes git through agent-git
Transparent proxy — Non-clone commands pass straight through to real git
Clone interception — git clone checks the TOML registry first. Already cloned? Error with location. New? Clone normally and register.
TOML registry — ~/.agent-git/repos.toml stores all tracked repos

Configuration

Registry lives at ~/.agent-git/repos.toml:

[[repos]]
url = "https://github.com/user/repo"
path = "/Users/you/projects/repo"
cloned_at = "2025-01-15T10:30:00Z"

agent-git 0.1.0