HTTP status code viewer for neovim
  • Lua 77.2%
  • Shell 11.3%
  • Nix 8.6%
  • Just 2.9%
Find a file
Barrett Ruth f5481146cd
All checks were successful
quality / Format (push) Successful in 9s
quality / Lint (push) Successful in 6s
deploy / LuaRocks (nightly) (push) Successful in 43s
docs: add quick start and rename vimdoc (#39)
## Checklist

- [x] I have read [CONTRIBUTING.md](https://git.barrettruth.com/barrettruth/http-codes.nvim/src/branch/main/CONTRIBUTING.md).
- [ ] No AI was used to generate, edit, or review any part of this contribution.

## Problem

The README still points users at legacy `.nvim` help topics, and the vimdoc filename does not match the clean help topic convention.

## Solution

- Rename `doc/http-codes.nvim.txt` to `doc/http-codes.txt` while preserving legacy help tags.
- Add concise Quick Start sections to the README and vimdoc for picker install, backend pinning, `:HTTPCodes`, and `<Plug>(http-codes-pick)`.
- Prefer `:help http-codes` and `:help http-codes-forgejo` in README references.

## Verification

- `git diff --check`
- `vimdoc-language-server format doc/`
- `vimdoc-language-server format --check doc/`
- `vimdoc-language-server check doc/`
- `nix develop --command just ci`

Reviewed-on: https://git.barrettruth.com/barrettruth/http-codes.nvim/pulls/39
2026-05-09 16:14:14 +00:00
.forgejo add contributing guide (#37) 2026-05-05 17:01:44 +00:00
.github/workflows ci: redirect GitHub PRs to Forgejo (#18) 2026-05-03 15:57:29 +00:00
doc docs: add quick start and rename vimdoc (#39) 2026-05-09 16:14:14 +00:00
lua Normalize notification prefix (#36) 2026-05-05 16:31:25 +00:00
plugin fix(ci): run pre-commit 2026-02-07 14:01:22 -05:00
.editorconfig chore: add project configs 2026-02-03 21:16:52 -05:00
.gitignore chore: add project configs 2026-02-03 21:16:52 -05:00
.luarc.json fix: resolve linting warnings 2026-02-03 21:19:02 -05:00
biome.json ci: replace prettier with biome (#16) 2026-04-25 16:11:09 -04:00
CONTRIBUTING.md docs: add quick start and rename vimdoc (#39) 2026-05-09 16:14:14 +00:00
flake.lock ci: adopt nix flake and just-based quality checks (#15) 2026-04-20 17:37:09 -04:00
flake.nix ci: replace prettier with biome (#16) 2026-04-25 16:11:09 -04:00
http-codes.nvim-scm-1.rockspec docs: use Forgejo source URLs (#19) 2026-05-03 16:16:28 +00:00
justfile docs: normalize port cleanup metadata (#32) 2026-05-04 21:29:18 +00:00
LICENSE chore: switch license to GPL 2026-04-30 23:41:53 +00:00
README.md docs: add quick start and rename vimdoc (#39) 2026-05-09 16:14:14 +00:00
selene.toml chore: add project configs 2026-02-03 21:16:52 -05:00
stylua.toml chore: add project configs 2026-02-03 21:16:52 -05:00
vim.toml chore: add project configs 2026-02-03 21:16:52 -05:00

http-codes.nvim

Quickly investigate HTTP status codes with Mozilla, with telescope, fzf-lua, and snacks.nvim integrations.

Note

Due to GitHub's historic unreliability, active development is hosted on Forgejo. GitHub is maintained as a read-only mirror. See :help http-codes-forgejo for canonical project links.

Installation

With vim.pack (Neovim 0.12+):

vim.pack.add({
  'https://git.barrettruth.com/barrettruth/http-codes.nvim',
})

Or via luarocks:

luarocks install http-codes.nvim

Dependencies

One of:

Quick Start

Install one picker backend first, then http-codes.nvim so the command has a UI to open.

vim.pack.add({
  'https://github.com/ibhagwan/fzf-lua',
  'https://git.barrettruth.com/barrettruth/http-codes.nvim',
})

Set the backend before http-codes.nvim loads if you want deterministic picker selection.

vim.g.http_codes = {
  use = 'fzf-lua',
}

Open the picker when you need to inspect a response code; type 404, 429, or 500, then press <CR> to open the selected MDN page.

:HTTPCodes

Bind the <Plug> mapping if you look up status codes often.

vim.keymap.set('n', '<leader>hc', '<Plug>(http-codes-pick)')

Documentation

:help http-codes