gitdirector 1.1.0

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

GitDirector

An interactive TUI for managing all your git repositories from one place — launch AI coding agents, spin up tmux sessions, and run multiple agents across repos in parallel.

Why GitDirector?

Stop context-switching between terminals. gitdirector console gives you a live dashboard of every repository you work on. Hit enter, pick a repo, and instantly drop into a tmux session with your AI agent of choice — OpenCode, Claude Code, GitHub Copilot, or Codex. Run them all at once, each in its own session, while you track sync state, branches, and changes across every repo in real time.

Installation

pip install gitdirector

Usage

Command	Description
gitdirector console	Open the interactive TUI dashboard
gitdirector link PATH [--discover]	Link a repository or discover all under a path
gitdirector unlink PATH|NAME [--discover]	Unlink 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 cd NAME	Open or switch to a tmux session for a repository
gitdirector autoclean links|sessions	Clean broken links or stale tmux sessions
gitdirector help	Show help

link

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

unlink

gitdirector unlink /path/to/repo         # unlink by full path
gitdirector unlink my-repo               # unlink by repository name
gitdirector unlink /path/to/folder --discover  # unlink 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.

cd

gitdirector cd my-repo

Opens a tmux session rooted at the repository directory, or switches to it if a session for that repo already exists.

• Inside tmux — switches the current client to the target session.
• Outside tmux — replaces the current process with tmux attach-session, handing the terminal over to tmux.

Requires tmux to be installed on your system.

macOS: brew install tmux
Debian/Ubuntu: sudo apt install tmux
Arch: sudo pacman -S tmux

console

gitdirector console

Opens a full interactive TUI dashboard built with Textual. All repositories load concurrently with live status updates.

Features:

• Live table with sync state, branch, changes, last commit, and active tmux sessions
• / to filter repositories by name or path
• s to cycle sort by any column
• r to refresh all statuses
• Press enter on any repository to open an action menu:
  • New tmux session — create and attach a session for the repository
  • Attach existing session — switch to any already-running tmux session
  • Launch AI agent — open OpenCode, Claude Code, GitHub Copilot, or Codex in a new tmux session
  • Remove session — kill a running tmux session

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
• tmux ≥ 3.2a (for gitdirector cd)

License

MIT