Open GitHub URLs for files, blame, commits, PRs, and repos directly from any Neovim buffer.

:GH! copies the URL to the clipboard — without !, it opens in your browser.

• Neovim 0.10+
• GitHub CLI (gh) — installed and authenticated

brew install gh
gh auth login

Install via your preferred plugin manager. The following example uses lazy.nvim.

{
  'wassimk/gh-navigator.nvim',
  version = "*",
  config = true
}

The plugin provides a single :GH command. The fastest way to use it is with no sub-command at all — it figures out what you mean.

Place your cursor on a commit SHA or PR number and run :GH with no arguments — the word under the cursor is used automatically. You can also pass an argument directly. GH tries to interpret it as a commit SHA first, then falls back to a PR search.

GH eef4a114e0bacc929d8335ef52b1b859d40097f4
GH 1234
GH refactor the actor class

When you want to skip the inference and be explicit, use a sub-command. Tab completion is available for all sub-commands and their arguments.

Both GH browse and GH blame accept a visual range. Select lines in visual mode (V) and run the command to open that exact selection on GitHub.

" Select lines, then:
:'<,'>GH browse
:'<,'>GH blame

Append ! to any command to copy the URL to the system clipboard instead of opening it in the browser.

GH! pr 1234
GH! browse
GH! blame
GH! repo issues

Use GH repo to jump to top-level pages of the current repository. Tab completion lists all available paths.

GH repo issues
GH repo pulls
GH repo actions
GH repo releases

Open GitHub's compare view for the current branch against the default branch.

GH compare

The plugin detects the Git repository from the current buffer's file path, not from Neovim's working directory. This means you can open Neovim in a parent folder and edit files across multiple repos without any issues.

No keymaps are set by default. Here are some examples:

-- Open and navigate
vim.keymap.set('n', '<leader>go', '<cmd>GH<cr>', { desc = 'GH: open commit or PR' })
vim.keymap.set('n', '<leader>gf', '<cmd>GH browse<cr>', { desc = 'GH: browse file' })
vim.keymap.set('n', '<leader>gb', '<cmd>GH blame<cr>', { desc = 'GH: blame file' })
vim.keymap.set('n', '<leader>gc', '<cmd>GH compare<cr>', { desc = 'GH: compare branch' })

-- Visual mode (line ranges)
vim.keymap.set('v', '<leader>gf', ':GH browse<cr>', { desc = 'GH: browse selection' })
vim.keymap.set('v', '<leader>gb', ':GH blame<cr>', { desc = 'GH: blame selection' })

-- Copy URL to clipboard (! variant)
vim.keymap.set('n', '<leader>gF', '<cmd>GH! browse<cr>', { desc = 'GH: copy file URL' })
vim.keymap.set('n', '<leader>gB', '<cmd>GH! blame<cr>', { desc = 'GH: copy blame URL' })
vim.keymap.set('v', '<leader>gF', ':GH! browse<cr>', { desc = 'GH: copy selection URL' })
vim.keymap.set('v', '<leader>gB', ':GH! blame<cr>', { desc = 'GH: copy blame selection URL' })

Run tests and lint:

make test
make lint

Enable the local git hooks (one-time setup):

git config core.hooksPath .githooks

This activates a pre-commit hook that auto-generates doc/gh-navigator.nvim.txt from README.md whenever the README is staged. Requires pandoc.