gitpp

日本語

Git Personal Parallel Manager — manage 100+ Git repos with one command.

Why gitpp?

When you maintain 100+ repos across multiple machines, the session start ritual gets old fast:

# Without gitpp — repeated for every repo
cd ~/repos/private/project-a && git pull
cd ~/repos/private/project-b && git pull
cd ~/repos/2025/tool-x       && git pull
# ... 97 more times

With gitpp — one command, all repos in parallel, with a live TUI:

gitpp pull

That covers the basic case. gitpp also solves a subtler problem: commit author identity.

If you have personal OSS repos, work repos, and hobby side-projects on the same machine, setting user.name/user.email in ~/.gitconfig means one identity wins and the others get wrong attribution. gitpp takes the opposite approach — it sets git config --local on each repo based on the YAML file in that directory tree, so identity follows location, not a global config file.

Features

• Parallel clone/pull/push with configurable concurrency (jobs, default 20)
• 7 subcommands beyond clone/pull/push — status, diff, fetch, branch, switch, stash list, gc
• Full-screen TUI (ratatui) with 6-state icons (Waiting/Running/Updated/Unchanged/Failed/Untracked)
• Per-directory git config — user.name, pull.rebase, and any other git config key, applied locally to every repo in the group
• Push opt-in — push is disabled unless comments.default is explicitly set; clone/pull work without it
• AI-friendly summary — plain-text output after completion, paste directly to your AI assistant for diagnosis
• Clean terminal teardown — exits without enabling terminal mouse capture, avoiding stray mouse-report bytes in the shell prompt
• Interactive REPL mode with tab completion and history
• Quiet mode for scripts and CI (no TUI, summary to stdout)
• Pre-commit hook auto-retry — retries once on hook failure
• Single binary, zero runtime dependencies

What it does

Put a gitpp.yaml in your repos directory, then:

gitpp clone        # Clone all repos in parallel
gitpp pull         # Pull all repos in parallel
gitpp push         # Add, commit, push all repos in parallel
gitpp status       # Show uncommitted changes across all repos
gitpp diff         # Show staged+unstaged diff stats
gitpp fetch        # Fetch from remotes
gitpp branch       # Show current branch (highlights non-default)
gitpp switch       # Switch to default branch (Git 2.23+)
gitpp stash list   # Detect forgotten stashes
gitpp gc           # Garbage collection (-j recommended)

A full-screen TUI shows real-time progress for every repository:

List mode (default):

┌──────────────────────────────────────────────────────────────┐
│ gitpp  j/k:move  Enter:detail  h/l:scroll  n/N:err  q:quit  │
│        g/G:top/bottom  y:copy  Esc:close pane                │
└──────────────────────────────────────────────────────────────┘
┌─ Repositories [1-20/101] ────────────────────────────────────┐
│▸✓ freeza                           Done                     │
│  [████████████████████████████████████████] 100%             │
│ ▶ sss                              Pulling...               │
│  [████████████████████░░░░░░░░░░░░░░░░░░░░]  50%            │
│ ⏸ noun-gender                       Waiting...              │
│  [░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░]   0%           │
└──────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────┐
│ Total: 103 | Done: 52 (Updated: 48 / Unchanged: 0 / Failed: 2 / Untracked: 2) │
└──────────────────────────────────────────────────────────────┘

Repositories that exist under base_dir but are not listed in gitpp.yaml appear as Untracked (? icon, magenta). This helps you notice manually cloned repos or repos you forgot to add to the config.

The detail pane is shown by default. Press Enter to toggle it off/on:

Detail mode (default):

┌──────────────────────────────────────────────────────────────┐
│ gitpp  j/k:move  Enter:detail  h/l:scroll  n/N:err  q:quit  │
│        g/G:top/bottom  y:copy  Esc:close pane                │
└──────────────────────────────────────────────────────────────┘
┌─ Repositories [1-20/101] ──────┬─ sss ───────────────────────┐
│   ✓ freeza         Done  100% │ remote: Enumerating objects:  │
│▸▶ sss           Pull..   50% │   12, done.                  │
│   ⏸ noun-gender   Wait..   0% │ Receiving objects:  60%      │
│                                │   (7/12) 1.2 MiB            │
└────────────────────────────────┴──────────────────────────────┘
┌──────────────────────────────────────────────────────────────┐
│ Total: 103 | Done: 52 (Updated: 48 / Unchanged: 0 / Failed: 2 / Untracked: 2) │
└──────────────────────────────────────────────────────────────┘

After all repos finish, a plain-text summary is printed to stdout — paste it directly to your AI assistant for diagnosis:

gitpp pull: 98/101 succeeded, 3 failed

--- freeza (/Users/you/repos/private/freeza) ---
  error: Your local changes to the following files would be overwritten by merge:
    src/main.rs

--- sss (/Users/you/repos/2025/sss) ---
  fatal: refusing to merge unrelated histories

Install

cargo install gitpp

Or build from source:

git clone https://github.com/kako-jun/gitpp.git
cd gitpp
cargo install --path .

Configuration

Create gitpp.yaml in the root of your repos directory:

config:
  user.name: your-name
  user.email: your-email@example.com
  pull.rebase: "true"
comments:
  default: sync.
jobs: 20
repos:
  - enabled: true
    remote: git@github.com:user/repo-a.git
    branch: main
    group: "projects"
  - enabled: true
    remote: git@github.com:user/repo-b.git
    branch: main
    group: "projects"
  - enabled: false           # skip this repo
    remote: git@github.com:user/archived.git
    branch: main
    group: "archive"

Multiple identities on one machine

Create separate YAML files in separate directories, each with its own config: block:

~/repos/
  personal/
    gitpp.yaml   # user.email: me@personal.dev
  work/
    gitpp.yaml   # user.email: me@company.com
  hobby/
    gitpp.yaml   # user.email: me@hobbyaccount.io

No global ~/.gitconfig user needed — missing global config is a feature, not a bug. A repo without local config will refuse to commit, which is the correct fail-safe.

Usage

# One-shot mode
gitpp pull              # Pull all enabled repos
gitpp push -j 10        # Push with max 10 parallel jobs
gitpp clone             # Clone (skips already-cloned repos)

# Inspection subcommands (short aliases available)
gitpp status            # or: gitpp st
gitpp diff              # or: gitpp di
gitpp fetch             # or: gitpp fe
gitpp branch            # or: gitpp br
gitpp switch            # or: gitpp sw  (Git 2.23+ required)
gitpp stash list        # or: gitpp sl
gitpp gc -j 4           # I/O heavy — limit parallelism

# Use a config file from another location
gitpp pull --config ~/shared/gitpp.yaml

# Specify both config and repo root
gitpp clone -c /mnt/ssd/gitpp.yaml -r /mnt/ssd/repos

# Quiet mode (no TUI — summary to stdout, progress to stderr)
gitpp pull -q

# Help / Version
gitpp --help            # or: gitpp -h
gitpp --version         # or: gitpp -V

# Interactive mode with tab completion
gitpp
gitpp> pull
gitpp> exit

TUI Controls

When all repos finish, gitpp waits 3 seconds (footer shows a hint). Press any key to enter browse mode and inspect results; or do nothing and it exits automatically.

Clone duplicate detection

If the target directory already contains a .git:

License

MIT