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 -fcheck-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
make deps # Install dependencies
make build # Build binary
make test # Run tests
make lint # Run linterMIT