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 --fetch
check-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 --tui
Navigate 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 linter
MIT