A fast, cross-platform CLI tool to check the git status of multiple projects organized by categories.
x mozilla
* M firefox
✱ ✚ thunderbird
✔ godot
x gamedev
⬆ flying-ones
* M avindi- Interactive TUI mode - Navigate projects with a modern terminal UI
- Multi-category organization - Group projects by team, client, or category
- Auto-discovery - Automatically scan directories for git repositories
- Fast concurrent checks - Parallel git status checks
- Smart filtering - Hide clean projects, search by name
- Cross-platform - Single binary for macOS, Linux, and Windows
curl -fsSL https://raw.githubusercontent.com/uralys/check-projects/main/install.sh | shCreate ~/check-projects.yml:
categories:
- name: personal
root: ~/Projects/personal
- name: work
root: ~/Projects/work
ignore:
- "*-deprecated"
display:
hide_clean: true
# Optional: set defaults
use_tui_by_default: false # Set to true to always use TUI mode
fetch: true # Set to true to always fetch from remote# CLI mode (simple output)
check-projects
# TUI mode (interactive)
check-projects --tui
# Fetch from remote before checking
check-projects --fetchcheck-projects # Check all projects
check-projects -v # Show all (including clean)
check-projects --category work # Check specific category
check-projects -f # Fetch from remote first
check-projects --fetch # Same as -f
check-projects -f --yes # Apply the safe branch fixes without askingcheck-projects --tuiNavigate with ↑↓ • Switch categories with ←→ • Git status shown automatically on right
✔Clean (synced with remote)⬆Ahead of remote⬆⬆Diverged from remote* MModified files* DDeleted files✱ ✚Untracked files❌Error
Every local branch with an upstream is checked, not only the current one.
With --fetch, the remote-tracking refs of deleted remote branches are pruned,
and their last tip is kept for the run to tell what the local branch still holds.
| Symbol | State | Fix offered |
|---|---|---|
↓ |
Behind: the remote moved forward | fast-forward |
↻ |
Rewritten: the remote was rebased or force-pushed, the local branch adds nothing | reset onto the remote |
✂ |
Merged: the remote branch was deleted, everything local had been pushed or is in the default branch | delete the branch |
⇅ |
Diverged: local commits are missing from the remote | none, rebase by hand |
✗ |
Gone: the MR was merged and the remote branch deleted, but some local commits are not in the default branch | delete the branch, default no |
"Adds nothing" means the local commits are contained in the target, have patch-identical counterparts (rebase), or leave the target unchanged when merged (squash merge). When only the commit messages match (a rebase that resolved conflicts), the fix is offered with a default of no.
Fixes never merge, never push, and never touch a checkout with uncommitted
changes. Each prompt prints the former tip (was <sha>) so a fix can be undone
with git branch -f <branch> <sha>. Deleting a branch checked out in another
worktree removes that worktree, ignored files included: its default is no.
Without a terminal (script, agent, CI), nothing is applied unless --yes is
given, and --yes only applies the fixes whose default is yes.
make deps # Install dependencies
make build # Build binary
make test # Run tests
make lint # Run linterMIT
