CLI tool that scans directories for git repos and reports their sync status.

Working across multiple git repositories? It's easy to forget uncommitted changes, unpushed commits, or branches without upstreams.

gitsync gives you a quick overview of all repos in a directory so nothing falls through the cracks.

• Detect uncommitted changes
• Track ahead/behind status vs remote
• Find branches without upstream tracking
• Multiple output formats: JSON, table, minimal
• Recursive directory scanning
• Config file support (cosmiconfig)

npm install -g @roeus/gitsync

Or build locally:

git clone https://github.com/syz51/gitsync.git
cd gitsync
pnpm install
pnpm run build
pnpm link --global

gitsync [options] [paths...]

# scan current dir, show only repos with issues
gitsync

# show all repos as table
gitsync -a -f table

# recursive scan, filter to repos with uncommitted changes
gitsync -r --filter changes

# scan specific directories
gitsync ~/projects ~/work

# combine filters
gitsync --filter changes,ahead

Supports .gitsyncrc, .gitsyncrc.json, .gitsyncrc.yaml, gitsync.config.js, or package.json field.

Example .gitsyncrc.json:

{
  "format": "table",
  "recursive": true,
  "depth": 2
}

CLI args override config file values.

By default shows repos with issues:

• uncommitted changes
• ahead/behind remote
• no upstream
• untracked branches

[{"name": "repo", "uncommittedChanges": 3, "ahead": 1, ...}]

REPO     BRANCH  CHANGES  AHEAD  BEHIND  UNTRACKED
my-repo  main    3        1      0       feature-x

my-repo (main): 3 changes, 1 ahead, [feature-x]

• Node.js >= 24
• git

git clone https://github.com/syz51/gitsync.git
cd gitsync
pnpm install
pnpm run build

# test locally
pnpm link --global
gitsync

1. Fork the repo
2. Create a feature branch
3. Make changes
4. Submit a PR

MIT