harivansh-afk/forge.nvim
1
0
Fork 0
mirror of https://github.com/harivansh-afk/forge.nvim.git synced 2026-04-15 06:04:41 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
forge.nvim/README.md
Barrett Ruth 25509a48ac
more tweaks
2026-03-27 18:17:12 -04:00

2.1 KiB
Raw Blame History

forge.nvim

Forge-agnostic git workflow for Neovim

PR, issue, and CI workflows across GitHub, GitLab, and more — without leaving your editor.

Features

  • Forge detection from git remote (GitHub via gh, GitLab via glab, Codeberg/Gitea/Forgejo via tea)
  • PR lifecycle: list, create, checkout, review, merge, approve, close/reopen, draft toggle
  • Issue management: list, browse, close/reopen
  • CI/CD: view runs, stream logs, filter by status
  • PR compose buffer with diff stat, template discovery, and syntax highlighting
  • Code review via diffs.nvim unified/split diff with quickfix navigation
  • Commit browsing with checkout, diff review, and URL yanking
  • Branch browsing with diff review and remote links
  • Worktree creation from PRs
  • File/line permalink generation (commit and branch URLs)
  • fzf-lua pickers with contextual keybinds throughout

Dependencies

  • Neovim 0.10.0+
  • fzf-lua
  • At least one forge CLI:
    • gh for GitHub
    • glab for GitLab
    • tea for Codeberg/Gitea/Forgejo
  • vim-fugitive (optional, for fugitive keymaps)
  • diffs.nvim (optional, for review mode)

Installation

Install with your package manager of choice or via luarocks:

luarocks install forge.nvim

Documentation

:help forge.nvim

FAQ

Q: How do I create a PR?

Press <c-g> to open the forge picker, select "Pull Requests", then <ctrl-a> to create. Or from a fugitive buffer: cpr (create), cpd (draft), cpf (instant), cpw (web).

Q: Does forge.nvim support review diffs?

Yes, with diffs.nvim installed. Select a PR and press <ctrl-d> to enter review mode with unified diff. Press s to toggle split/unified view. Navigate files with ]q/[q.