| name | git-diff |
| description | Display git changes in GitHub-style unified diff format with colored terminal output. Shows both staged (--cached) and unstaged changes with two-column line numbers, red/green highlighting, and chunk markers. Use when reviewing code changes, preparing commits, or comparing file modifications. Triggers on "git diff", "show changes", "what changed", or "review diff". |
| allowed-tools | Bash, Read |
git-diff
Display git changes in GitHub-style unified diff format.
Execution
Run the Python script to display formatted diff:
python3 scripts/github_diff.py [optional-path]
Output Format
- File headers: Dark background with filepath
- Line numbers: Two columns (old | new)
- Deletions: Red background with
-marker - Additions: Green background with
+marker - Context: Neutral with both line numbers
- Chunk markers: Cyan
@@ -n,m +n,m @@headers
Sections
- Staged Changes (
git diff --cached) - shown first if present - Unstaged Changes (
git diff) - working directory modifications
Examples
# Show all changes
python3 scripts/github_diff.py
# Filter by path
python3 scripts/github_diff.py src/components/
Requirements
- Python 3.6+
- Git installed and in PATH
- Terminal with ANSI color support