navcom - Navigate Git Commits
A simple bash script to navigate through git repository commits chronologically, perfect for studying a codebase's evolution.
What It Does
- Lets you step through commits in chronological order (oldest to newest)
- Jump to first commit with
first, navigate forward withnext, or backward withprev - Automatically tracks your progress
- Shows commit details at each step
Installation
MacOS/Linux
This installs the script as navcom in /usr/local/bin.
Manual Installation
sudo cp bin /usr/local/bin/navcom sudo chmod +x /usr/local/bin/navcom
Usage
Navigate to any git repository and run:
# Jump to first commit navcom first # Move to next commit (chronologically) navcom next # Move to previous commit navcom prev
On first run, it will initialize by scanning the repository's commit history.
How It Works
- First Run: Creates a chronological list of all commits in the default branch
- Navigation: Checks out commits in order and tracks your position
- Progress: Stores tracking data in
.git/nc-progressand.git/nc-commits
Reset Progress
To start over from the beginning:
rm .git/nc-progress .git/nc-commits
