ws-scout 0.1.0

Scan a workspace of git repos and rank the ones that need attention — triage CLI with LLM-friendly output

ws-scout

ws-scout is a small WSL-friendly CLI that scans ~/workspace, finds git repositories, and ranks the projects that probably deserve attention.

Unlike most multi-repo status tools, it does not just list repository states: it scores each repository (dirty tree, unpushed commits, TODO notes, recent activity) and sorts them into a triage list, with a --brief mode designed to be pasted into an LLM coding assistant as context.

It is useful when the workspace has many active projects and you want a quick morning triage before opening Claude Code.

What It Checks

• Dirty git working trees
• Local commits ahead of the remote
• Branches behind the remote
• Recent commits
• TODO/FIXME/HACK notes
• Common package.json scripts

Usage

./ws_scout.py
./ws_scout.py --brief
./ws_scout.py --json
./ws_scout.py ~/workspace --top 20 --depth 2

Install a ws-scout command from PyPI:

pipx install ws-scout
# or
uv tool install ws-scout

Or install from a local checkout:

./install.sh
ws-scout --brief

The --brief output is intentionally compact so it can be pasted into Claude Code as context.

Requirements

• Python 3.10+
• git
• ripgrep (optional — used for TODO/FIXME scanning; without it the TODO column is simply empty)

License

MIT