GitNav: Git History & Workflows

GitNav adds visual repository history and guarded Git workflows to Visual Studio Code. It works independently in any Git repository and does not require .NET or C#.

Highlights

Explore branches, tags, commits, worktrees, stashes, and changed files in a visual Git Log panel.
Render real graph lanes with paging, filters, repository status, and commit details.
Compare files or editor selections with another branch.
Inspect commit history for a selected range of lines.
Preview diffs and navigate historical revisions without changing the working tree.
Run guarded branch, commit, stash, worktree, reset, cherry-pick, revert, and rebase operations.
Recover from conflicts with operation-aware continue, skip, and abort actions.
Protect important branch patterns from history-rewriting commands.
Fetch repositories automatically while the Git Log panel is active.

Installation

code --install-extension tuna-ex.gitnav-workflows

Requirements

Visual Studio Code 1.92 or newer
Git available on PATH
An open folder containing a Git repository

Getting started

Open a Git repository in VS Code.
Open the bottom Panel and select GitNav.
Use the branch tree, history list, changed-file pane, and context menus to inspect or manage the repository.
Select code in an editor and open the GitNav context submenu for line history and comparisons.

Configuration

Open Settings and search for GitNav. Available settings include automatic fetch, fetch interval, protected branches, and the maximum line-history commit count.

Safety

GitNav blocks history-rewriting operations on configured protected branches and uses explicit confirmations for destructive actions. Always review the displayed branch, commit, and working-tree state before confirming a mutation.

Feedback

Open an issue with reproduction steps, your operating system, VS Code version, Git version, and relevant output logs.

License

GitNav is available under the MIT License. Third-party attributions are listed in THIRD_PARTY_NOTICES.md.