| 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.