ci.nvim

GitHub Actions CI in Neovim

Note

Development, issues, and pull requests happen on Forgejo. GitHub is maintained as a read-only mirror.

Experience the power of :CI. Native GHA logs in normal Neovim buffers with real ANSI colours, step-level folds, and more.

Requirements

• Neovim 0.13+
• gh, authenticated
• git

Installation

With vim.pack (Neovim 0.12+):

vim.pack.add({
  'https://forge.barrettruth.com/barrettruth/ci.nvim',
})

Or via luarocks:

luarocks install ci.nvim

Usage

" checks for the active pull request on this branch
:CI

" any git revision, resolved by GitHub rather than locally
:CI master
:CI v0.11.0
:CI HEAD~3

" any github.com CI URL
:CI https://github.com/neovim/neovim/actions/runs/30208531214/job/89810718120
:CI https://github.com/neovim/neovim/pull/40993
:CI https://github.com/neovim/neovim/actions/workflows/test.yml

" the <cWORD> under the cursor
:CI .

Work with a ci:// buffer via neovim-native mappings. <CR> opens the check under the cursor, - goes back to the list you came from, walk job steps with [[ and ]], and more.

Documentation

:help ci

Known limitations

• In Progress Jobs: GitHub/gh cli does not support this. In-progress checks/jobs display their step status only, until completion.