Stats
Links
Categories
Auto-discovered marketplace from el-mundos/claude-pua-unicode
npx claudepluginhub el-mundos/claude-pua-unicodeWorkaround for Claude Code filtering BMP Private Use Area Unicode characters (U+E000-U+F8FF). Provides placeholder syntax for icons (primarily Nerd Fonts) and automatic conversion.
Workaround for Claude Code filtering BMP Private Use Area Unicode characters (U+E000-U+F8FF). Nerd Font icons are the primary use case, but this applies to any PUA characters in this range.
Claude Code strips characters in the BMP PUA range before tools receive them. This makes it impossible to directly write icons from sets like Powerline, Devicons, Font Awesome, and Octicons.
Characters in the Supplementary PUA-A range (U+F0000+), like Material Design Icons, work fine.
This plugin provides:
{{U+E0A0}} or {{nf-fa-star}} instead of literal icons/icon-lookup command to search for icons by nameUse placeholder syntax for icons in the filtered BMP PUA range:
# By codepoint
git_branch.symbol = "{{U+E0A0}} ";
# By name
git_branch.symbol = "{{nf-dev-git_branch}} ";
The hook automatically converts placeholders after the file is saved.
When Claude reads a file containing PUA characters, a hook automatically identifies them:
[Icons: 61 known + 12 unknown PUA, 73 total]
L7: = nf-md-battery (U+F0079)
L14: nf-fa-aws (U+F0EF) (filtered)
...
Use the /icon-lookup command:
/icon-lookup git branch
/icon-lookup folder
/icon-lookup star
Identify a specific character directly:
# Direct argument
scripts/identify-icons.py -c ""
# From stdin
echo "" | scripts/identify-icons.py -
# From file
scripts/identify-icons.py /path/to/file
Run the conversion script directly:
scripts/convert-placeholders.py /path/to/file
commands/icon-lookup.md - Icon lookup commandskills/icon-lookup/SKILL.md - Skill for proactive icon handlinghooks/hooks.json - PostToolUse hooks for conversion and identificationscripts/convert-placeholders.py - Placeholder to Unicode conversionscripts/lookup-icon.py - Search icons by namescripts/identify-icons.py - Identify icons in files or stringsdata/nerdfont-icons.json - Icon database (sourced from Nerd Fonts)