lazynf

Install Nerd Fonts from your terminal.

Status: early development. Interactive TUI plus full CLI: install, import, update, remove, list, search, cache clean, cache refresh, doctor, and shell completion on Linux and macOS. No release tagged yet — build from source.

Interactive mode

Run lazynf with no arguments on a real terminal to open the interactive TUI: browse the full Nerd Fonts catalog, mark fonts with space, install / update / remove with i / u / r, and watch progress streamed in the log pane below. Doctor diagnostics with actionable fixes are available via d. Press ? inside the TUI for the full key map.

CLI sub-commands (lazynf install foo, lazynf doctor, etc.) remain available and behave exactly as before. The TUI is only launched when stdout is a TTY; piping or redirecting falls back to the help output.

Install

go install github.com/lazynop/lazynf@latest

Usage

lazynf install JetBrainsMono FiraCode    # install one or more fonts
lazynf import --all                      # adopt fonts already on disk into lazynf state
lazynf import JetBrainsMono --detect     # adopt and hash-match against upstream tag
lazynf update                            # refresh stale or imported fonts
lazynf update --force                    # refresh even fonts already at the latest tag
lazynf remove FiraCode                   # uninstall a font (deletes files + state entry)
lazynf remove --purge JetBrainsMono      # also delete files for fonts that were imported
lazynf remove --all --yes                # remove every font from the manifest (non-interactive)
lazynf list                              # color grid of available fonts (TTY) / plain on pipe
lazynf list --installed                  # bordered table of installed fonts
lazynf search mono                       # find fonts by substring
lazynf cache clean                       # clear catalog cache and kept archives
lazynf doctor                            # diagnose paths, auth, manifest, catalog, orphans

Global flags: -q/--quiet (errors only), -v/--verbose (extra diagnostics on stderr).

Run lazynf --help for full options.

Shell completion

source <(lazynf completion bash)              # bash
lazynf completion zsh > ~/.zfunc/_lazynf      # zsh
lazynf completion fish | source               # fish

Tab completion suggests font names dynamically: catalog entries for install, manifest entries for update/remove, orphan candidates for import. Run lazynf list once to populate the catalog cache.

Authentication

lazynf makes one GitHub API call per command in the steady state (cached against the upstream release tag). It picks up credentials from, in order: GITHUB_TOKEN, gh auth token, then unauthenticated. Anonymous use is fine for occasional installs; authenticate to avoid GitHub's anonymous rate limits on heavy use.

Build from source

git clone https://github.com/lazynop/lazynf
cd lazynf
just build
./bin/lazynf --help

Requires Go 1.25+ and (optionally) just.

Status

MVP. Implemented on Linux and macOS: install, import, update, remove, list, search, cache clean, doctor, and shell completion. Planned: Windows support and an interactive TUI.

License

MIT