install

Additional install commands

macOS

Homebrewverified · 100%

brew install nvimpager

provider-native install command

overview

Package summary

Use NeoVim as a pager to view manpages, diffs, etc.

Project links

Homepage

Commands and aliases

nvimpager

history

Project history and usage

nvimpager is a small pager wrapper that launches Neovim in a pager-like mode for man pages, files, pipes, and diffs. It is not trying to replace `less` for every workload; it exists for users who want Neovim syntax highlighting, mouse behavior, and familiar keybindings while reading output.

Project history

The nvimpager repository was created on 2017-10-23. Its README describes the project as a rewrite of vimpager with fewer but stricter dependencies and with Neovim as the target editor.

The project stayed deliberately small: a wrapper script, a man page, a separate configuration path under `~/.config/nvimpager`, and enough logic to choose pager mode or cat mode depending on input.

Adoption history

nvimpager's adoption follows the shell-customization path: people find it through Neovim, then set `PAGER=nvimpager` or use it for `man`, `git diff`, and piped command output. Homebrew packages version 0.14.0 and declares Neovim as a runtime dependency.

The package is also present in several Unix packaging ecosystems, including Homebrew, MacPorts, Nix, Alpine, and openSUSE, which is the right scale for a focused terminal utility.

How it is used

The README shows the practical workflow: run `nvimpager file`, pipe text into it, or export `PAGER=nvimpager` and then use `man bash` or `git diff`. Cat mode prints highlighted output directly when opening the full Neovim interface would be overkill.

Users configure nvimpager separately from their normal Neovim setup with `~/.config/nvimpager/init.vim` or `~/.config/nvimpager/init.lua`, which keeps pager behavior from being accidentally slowed or broken by a full editing config.

Why package nerds care

nvimpager matters because it turns an editor into a Unix pipeline component without pretending every terminal read needs a new pager implementation. It is a thin adapter around a powerful installed tool.

Its limitations are part of the package story: the README notes that large files and lazy pipe reading remain areas where `less` is faster or more memory efficient.

Timeline

2017-10-23: GitHub repository created.
2026-04-17: repository push date reported by GitHub API before Homebrew's 0.14.0 packaging.
2026 Homebrew metadata: stable version 0.14.0 listed with Neovim dependency.

Related projects

Neovim is the editor runtime nvimpager wraps.
vimpager is the earlier Vim-oriented pager project named by the nvimpager README.
`less` remains the conventional pager nvimpager complements rather than fully replaces.

Sources

security posture

Risk level: green

narrow executable package without higher-risk signals.

Risk classifier

green risk · low confidence · appliance

Why

narrow executable package without higher-risk signals

Signals

metadata:no-higher-risk-signals

Install behavior

No Homebrew bottle metadata was recorded.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: ~/.config/nvimpager/init.vim~/.config/nvimpager/init.lua

executables

Installed executables

Command	Kind	Exposure	Note
`nvimpager`	executable	indexed executable	Discovered from the local executable index.

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-08-03

manager version0.14.0

manager updated2026-05-18

local dataunknown

upstreamnot available

latest detectednot detected

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:nvimpager
Version	0.14.0
Package manager	Homebrew
Homepage	https://github.com/lucc/nvimpager
Repository	https://github.com/lucc/nvimpager
Last updated	2026-05-18T12:31:01-04:00
Pulse	updated
Bottle	not recorded
Service	none declared

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/nvimpager.yml

Used sources

Geiger risk classifier
Nucleus package database
curated configuration and credential file locations
curated package history
pkgdb category and tag curation

Install nvimpager with Homebrew