gitdirector 0.1.6

A Python CLI tool for managing and synchronizing multiple git repositories with ease

GitDirector

A Python CLI tool for managing and synchronizing multiple git repositories.

Installation

pip install gitdirector

Usage

gitdirector add PATH [--discover]          Add a repository or discover all under a path
gitdirector remove PATH|NAME [--discover]  Remove a repository by path, name, or all under a path
gitdirector list                           List all tracked repositories with live status
gitdirector status                         Show dirty repositories with staged/unstaged files
gitdirector pull                           Pull latest changes for all tracked repositories
gitdirector help                           Show help

add

gitdirector add /path/to/repo
gitdirector add /path/to/folder --discover   # recursively find and add all repos

remove

gitdirector remove /path/to/repo         # remove by full path
gitdirector remove my-repo               # remove by repository name
gitdirector remove /path/to/folder --discover  # remove all repos under a path

If multiple tracked repositories share the same name, gitdirector will refuse and list the conflicting paths so you can use the full path instead.

list

Displays a live table of all tracked repositories with:

• Sync state: up to date, ahead, behind, diverged, or unknown
• Current branch
• Staged/unstaged changes
• Last commit (relative time)
• Tracked file size
• Path

Checks run concurrently (default: 10 workers).

status

Shows repositories with uncommitted changes (staged and/or unstaged files). Prints a summary of total, clean, and changed repo counts.

pull

Pulls all tracked repositories concurrently using fast-forward only (git pull --ff-only). Reports success or failure per repository.

Configuration

Config is stored at ~/.gitdirector/config.yaml.

repositories:
  - /path/to/repo1
  - /path/to/repo2
max_workers: 10   # optional, default 10

Requirements

• Python 3.9+
• Git

License

MIT