nerdfont-icons

Resolve Nerd Font icon names into Unicode code points and escape sequences.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/bugabinga/pi-ext --skill nerdfont-icons
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nerdfont-icons
Source: https://github.com/bugabinga/pi-ext/tree/main/skills/nerdfont-icons
Command: npx skills add https://github.com/bugabinga/pi-ext --skill nerdfont-icons

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Nerd Font icon names like nf-*-style strings often don’t directly map to reliable Unicode code points, so developers waste time guessing glyphs and escaping them correctly.

Core Features & Use Cases

  • Verified icon lookup: Finds Nerd Font icon entries and returns the corresponding Unicode code point and actual glyph.
  • Multi-target escaping formats: Outputs representations for hex, JavaScript, HTML, CSS, Python, Rust, Go, C/C++, Swift, Lua, shell, printf, TOML, YAML, Vim, Emacs Lisp, and WezTerm.
  • Reference-backed accuracy with refresh: Uses a compressed local reference database and can auto-refresh from the Nerd Fonts cheat sheet when results are empty.
  • Disambiguation for partial/ambiguous queries: Shows multiple matches instead of inventing an answer.

Quick Start

Run the skill script with the Nerd Font icon name and choose an output format, for example: node scripts/get-nerdfont-codepoint.js nf-md-brain wezterm.

Frequently Asked Questions about nerdfont-icons

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resolve Nerd Font icon names to Unicode codepoints for terminal configuration?

You can resolve Nerd Font icon names by querying a local reference database that maps nf-* identifiers to verified Unicode code points and glyphs. This prevents guessing glyphs when configuring terminal emulators or code editors.

What is the correct character escaping format for Nerd Font glyphs in CSS and Python?

Character escaping for Nerd Font glyphs requires language-specific formats like CSS or Python escape sequences. A dedicated resolver extracts verified codepoints and outputs exact representations for these languages directly.

Does Nerd Font icon lookup support escape sequences for WezTerm and Vim?

Yes, Nerd Font icon lookup supports generating escape sequences for WezTerm and Vim. It resolves nf-* names into verified codepoints and formats the output specifically for these environments.

What happens when a Nerd Font icon name search returns ambiguous matches?

When a Nerd Font icon name search returns ambiguous matches, the resolver displays multiple valid choices without inventing values. This disambiguation ensures you select the correct verified codepoint for your rendering needs.

Can I auto-refresh the Nerd Font codepoint database when results are empty?

Yes, you can auto-refresh the Nerd Font codepoint database when lookup results are empty. The resolver uses a local Brotli-compressed database and can fetch updates from the Nerd Fonts cheat sheet to find missing icons.