nvf

name	nvf
description	Search nvf options and read nvf manual pages from a specific branch, tag, or commit.
compatibility	Option search requires nix with flakes enabled. Manual commands require curl, jq, and network access.

nvf Skill

Use for authoritative nvf data. Prefer commit SHAs for reproducible answers; branch names like main can move.

Scripts print compact output. Nix option search suppresses normal Nix chatter and shows stderr only on failure.

Commands

Search nvf options

./scripts/search-options.sh REF QUERY [LIMIT]
./scripts/search-options.sh main vim.lsp 20

JSON array fields: name, description, type, default. Search is case-insensitive and limited to option names.

List manual pages

./scripts/list-manual.sh REF
./scripts/list-manual.sh main

Returns a sorted JSON array of paths under docs/manual/, without .md.

Read a manual page

./scripts/read-manual.sh REF MANUAL_PATH
./scripts/read-manual.sh main configuring/languages/lsp

Prints raw Markdown from docs/manual/MANUAL_PATH.md.

Notes

• Option search evaluates github:NotAShelf/nvf/REF and imports local <nixpkgs>.
• GitHub API rate limits can affect manual listing.