1.3 KiB
Git Scout
Git Scout monitors local Git working trees and remote default branches. It uses Python 3.9+ and Git, with no additional packages.
python3 git_scout.py ~/Projects
python3 git_scout.py ~/Projects --needs-attention
python3 git_scout.py ~/Projects --gitea-imac --record
Local scans include linked worktrees and skip hidden subdirectories. The attention view shows modified or untracked paths, ahead or behind counts, and errors. Ahead and behind counts use locally recorded upstream refs.
Use --remote URL repeatedly to include other remotes. Remote checks read the
default branch and commit without fetching objects. The --gitea-imac shortcut
uses the iMac's existing SSH alias to check personal-site and python-project.
Compare scans
Run the same scan twice with --record, then use:
python3 git_scout.py ~/Projects --history
python3 git_scout.py ~/Projects --compare
Snapshots are grouped by absolute scan directory. Keep the same remote options
across recordings to compare the same set of targets. SQLite history is stored
at ~/.local/state/git-scout/history.sqlite3 by default. Use --db PATH to
choose a different location. Snapshots record Git status and commit IDs, not
file contents. A scan with an error returns status 1 and still saves the
results when --record is set.