Work with GitHub PRs in Neovim. Wraps the GitHub gh CLI with a minimalist yet effective workflow.

Guh is ~2k lines of unimpeachable code, leveraging builtin Nvim mechanisms such as diagnostics and 'scrollbind' buffers, and otherwise delegating to the gh CLI in a :terminal buffer.

Run :Guh to see status.

:Guh

Run :Guh <target> to view a PR/issue/commit/repo.

" PR or issue number (current repo)
:Guh 35951
" Commit SHA
:Guh a1b2c3d
" GitHub URL
:Guh https://github.com/neovim/neovim/pull/35951
:Guh https://github.com/neovim/neovim/commit/a1b2c3d
" Slug ("owner/repo#123" or "owner/repo")
:Guh neovim/neovim#35951
:Guh neovim/neovim
" guh:// URI
:Guh guh://neovim/neovim/pr/35951
" Cursor target
:Guh .

Inside any guh:// buffer,

• Hit g? to see the keymaps.
• Hit <Enter> to open the target at cursor.

When viewing a PR,

• Diff comments are presented (1) in a 'scrollbind' split, (2) as "diagnostics" (vim.diagnostic), (3) loaded in quickfix.
• Files marked as "Viewed" are collapsed to a (viewed) <path> line.
• You can view the most-recent CI logs for all "jobs" in the CI matrix.

Editable buffers (comments, merge message) confirm the action on write-and-close (ZZ submits, ZQ discards).

Keymaps are provided as <Plug>(guh-…). To customize, just define a mapping to the relevant <Plug>(guh-…) and Guh will skip its default.

See help file for details.

vim.pack.add{ 'https://github.com/justinmk/guh.nvim' }

Requirements:

• Nvim 0.13+
• "gh" (GitHub CLI)
• (Optional) For working with Git, use a plugin such as vim-fugitive.
• (Optional) For highlighting diffs, use a plugin such as diffs.nvim.

• https://github.com/pwntester/octo.nvim

guh.nvim was originally forked (and completely rewritten) from https://github.com/daliusd/ghlite.nvim by Dalius Dobravolskas.