Repolode
pwntester

pwntester/octo.nvim

A Neovim plugin for viewing, editing, and reviewing GitHub issues, pull requests, and discussions from inside the editor.

Stars
3,402
Forks
251
Open issues
252
Last commit
9 days ago

What is it?

octo.nvim brings GitHub issues, pull requests, and discussions into Neovim. Each item opens in a regular buffer, so you can edit the title, body, or comments as text and run :w to sync the changes back to GitHub. Commands cover adding and editing comments, managing labels, reactions, assignees, reviewers and project cards, and listing or searching items with filters.

The plugin relies on the GitHub CLI (gh) for API access, so authentication is handled by gh. It supports GitHub Enterprise hosts, either through a configured hostname or by passing enterprise URLs and octo:// links directly. Pull request review is a dedicated workflow with a changed-files panel, diff views, comment threads, and submission of approve, comment, or request-changes reviews.

It requires Neovim 0.10 or later and plenary.nvim, and can use telescope.nvim, fzf-lua, or snacks.nvim as the picker for list views.

Key features

  • 01Edit issue, PR, and discussion titles, bodies, and comments as regular buffers and sync with :w
  • 02Add, modify, and delete comments, labels, reactions, assignees, and reviewers
  • 03Review pull requests with a changed-files panel, diff views, and comment threads
  • 04Open items from GitHub URLs, including GitHub Enterprise hosts, or octo:// links
  • 05List and search issues and PRs with filters, using telescope, fzf-lua, snacks.nvim, or the built-in picker

Use cases

  • Triaging and replying to issues without leaving Neovim
  • Reviewing pull requests with diffs and inline comment threads in the editor
  • Working across GitHub.com and GitHub Enterprise instances from one editor
  • Managing PR merges, labels, and reviewers from the command line

Quick start

  1. 1

    Install Neovim 0.10+, GitHub CLI, and plenary.nvim

  2. 2

    Add octo.nvim with lazy.nvim using the Installation config

  3. 3

    Verify your setup with checkhealth

    :checkhealth octo

Things to know

  • Requires Neovim 0.10 or newer and the GitHub CLI installed.
  • Projects v2 features need an extra token scope added to gh.

Topics

FAQ

What is octo.nvim?
A Neovim plugin for viewing, editing, and reviewing GitHub issues, pull requests, and discussions from inside the editor. octo.nvim brings GitHub issues, pull requests, and discussions into Neovim. Each item opens in a regular buffer, so you can edit the title, body, or comments as text and run :w to sync the changes back to GitHub. Commands cover adding and editing comments, managing labels, reactions, assignees, reviewers and project cards, and listing or searching items with filters.
Is octo.nvim free to use? What license does it have?
octo.nvim is open source under the MIT license. Check the license terms before using it in commercial products.
Is octo.nvim still maintained?
Actively maintained. The last commit to octo.nvim was on Oct 13, 2026.
What can I use octo.nvim for?
Triaging and replying to issues without leaving Neovim Reviewing pull requests with diffs and inline comment threads in the editor Working across GitHub.com and GitHub Enterprise instances from one editor Managing PR merges, labels, and reviewers from the command line
How do I install octo.nvim?
Install Neovim 0.10+, GitHub CLI, and plenary.nvim Add octo.nvim with lazy.nvim using the Installation config Verify your setup with checkhealth: :checkhealth octo
Where can I get octo.nvim?
The source code and installation instructions are on GitHub: https://github.com/pwntester/octo.nvim

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects