mrepo

mrepo

A CLI and TUI tool for managing multiple Git repositories within a monorepo workspace.

Features

• Clone & sync — bootstrap repos from config with mrepo clone or mrepo sync
• Parallel status — query all repos concurrently, see branch, worktree status, ahead/behind, missing
• Parallel pull/fetch — git pull or git fetch all repos with bounded concurrency
• Run commands — mrepo forall -- make build runs a command in every repo
• Group filtering — --group services to operate on a subset of repos
• Shallow clones — --depth 1 for fast bootstrap of large repos
• Interactive TUI — terminal dashboard with clone/sync/pull/fetch, built with Bubble Tea
• Config-driven — .repos.toml or .repos.yaml tracks repos, remotes, branches, and groups
• Auto-discovery — scan finds untracked Git repos and auto-detects remote URLs
• JSON output — --json flag on all reporting commands for scripting integration
• Cross-platform — single Go binary, works on Linux, macOS, Windows

Install

go install github.com/pinealctx/mrepo@latest

Or download a binary from Releases.

Quick Start

# Scan for Git repos in current directory
mrepo scan

# Add all found repos (auto-detects remote URL and branch)
mrepo scan --add

# Check status of all repos
mrepo status

# Pull latest for all repos
mrepo pull

# Tune network concurrency and the per-repository timeout
mrepo pull --parallel 4 --timeout 45s

# Clone missing repos + pull existing in one step
mrepo sync

# Run a command in every repo
mrepo forall -- go test ./...

# Launch interactive TUI
mrepo tui

Configuration

mrepo looks for .repos.toml, .repos.yml, or .repos.yaml in the root directory.

Each repo can optionally specify a remote (clone URL) and branch to enable clone and sync.

TOML Example (.repos.toml)

version = 1

[repos.backend]
path = "services/backend"
remote = "https://github.com/org/backend.git"
branch = "main"
description = "Go API server"

[repos.frontend]
path = "web/frontend"
remote = "git@github.com:org/frontend.git"
branch = "main"
description = "React web app"

[groups.services]
repos = ["backend", "frontend"]

YAML Example (.repos.yaml)

version: 1
repos:
  backend:
    path: services/backend
    remote: https://github.com/org/backend.git
    branch: main
    description: Go API server
  frontend:
    path: web/frontend
    remote: "git@github.com:org/frontend.git"
    branch: main
    description: React web app
groups:
  services:
    repos:
      - backend
      - frontend

Commands

Global Flags

TUI Keyboard Shortcuts

License

MIT