By default, dirty provides a formatted output with color-coded status indicators:
$ dirty ~/code
* apps/dashboard
apps/storefront
* libs/ui-kit [local]
libs/common
4 repos, 2 dirty, 1 local-only
- Color coding (red for
*, yellow for [local])
- Visual alignment with spacing
- Summary line with counts
Raw output mode
Use the --raw or -r flag to get machine-readable output with one path per line:
Example output
$ dirty -r ~/code
apps/dashboard
apps/storefront
libs/ui-kit
libs/common
- No status indicators or decorations
- No colors or formatting
- No summary line
- One repository path per line
Raw mode outputs relative paths from the scanned directory, making it ideal for piping to other commands.
Use cases for raw output
Piping to xargs
Process each repository with another command:
# Pull all repositories
dirty -r ~/code | xargs -I {} git -C {} pull
# Show git status for all repositories
dirty -r ~/code | xargs -I {} sh -c 'echo "=== {} ===" && git -C {} status'
# Count commits in each repository
dirty -r ~/code | xargs -I {} git -C {} rev-list --count HEAD
Using while read loops
Iterate over repositories in a shell script:
# Archive all dirty local-only repositories
dirty -dlr ~/code | while read repo; do
echo "Backing up $repo..."
tar -czf "backup-$(basename $repo).tar.gz" "$repo"
done
Combining with filters
Combine raw output with filters for targeted operations:
# Add remote to all local-only repositories
dirty -lr ~/code | while read repo; do
git -C "$repo" remote add origin "[email protected]:user/$repo.git"
done
# Commit all dirty repositories
dirty -dr ~/code | xargs -I {} git -C {} commit -am "Auto-commit"
Combine -dlr flags to get raw output of repositories that are both dirty and local-only, perfect for scripting backup operations.
Comparison
$ dirty ~/code
* apps/dashboard
apps/storefront
2 repos, 1 dirty, 0 local-only
Raw output (-r)
$ dirty -r ~/code
apps/dashboard
apps/storefront
When using raw output in scripts, be careful with paths containing spaces. Always quote variables: git -C "$repo" status