A configurable bash statusline and audio/spinner pack for Claude Code
Layout and color variations
Quick Start
/plugin marketplace add jcraigk/nerdflair
/plugin install nerdflair@jcraigk/nerdflair
/nerdflair install
Restart Claude Code after install for the changes to take effect.
Features
- 3 layout modes: full (3 rows), compact (2 rows), minimal (1 row)
- Context bar: color shifts from green to red as context fills, with a compaction threshold marker
- 3 color palettes: vibrant (full color), muted (desaturated), mono (grayscale)
- Custom spinner verbs: 150 themed thinking/working phrases
- Terminal bell: (tab indicator) on Notification, PermissionRequest, and Stop events
- Audio chimes (macOS, Linux): 20 styles, configurable per-event, adjustable volume
- Project folder display: always shows the launch directory, not the current subdirectory Claude may have navigated to
- Git branch, files edited, and lines added/removed
- Model name with indicators for output style, reasoning effort, extended thinking, and fast mode
- Active MCP servers
- Session cost, API duration, and token throughput
- Chime style label (shown for the random style before any cost is incurred)
Prerequisites
jq is required. The statusline parses Claude Code's session JSON with jq; without it the statusline exits and renders nothing.
brew install jq # macOS
sudo apt install jq # Debian/Ubuntu
A Nerd Font is required. The statusline uses Nerd Font glyphs for icons and Powerline caps. Without one installed, characters render as boxes.
Install via Homebrew or download from nerdfonts.com:
brew install --cask font-jetbrains-mono-nerd-font
Terminal font configuration
Installing only puts the font files on disk; your terminal won't use it until you select it:
| Terminal | Where to set the font |
|---|
| iTerm2 | Settings -> Profiles -> Text -> Font -> select "JetBrainsMono Nerd Font" |
| Terminal.app | Settings -> Profiles -> (your profile) -> Font -> Change -> select "JetBrainsMono Nerd Font" |
| Warp | Settings -> Appearance -> Terminal font -> select "JetBrainsMono Nerd Font" |
| Ghostty | Add font-family = JetBrainsMono Nerd Font to ~/.config/ghostty/config |
| VS Code terminal | Settings -> search "terminal font" -> set Terminal > Integrated: Font Family to JetBrainsMono Nerd Font |
Usage
Use the /nerdflair command to configure the statusline:
Command reference
| Command | Effect |
|---|
/nerdflair | Show current settings and command reference |
/nerdflair install | Install or upgrade (font check, settings.json config; preserves existing settings) |
/nerdflair uninstall | Remove nerdflair from settings and clean up data |
/nerdflair info | Show current settings without changing anything |
/nerdflair chime-events | Show/toggle which events play chimes |
/nerdflair chime-session [style] | Set chime style for this session only (plays preview) |
/nerdflair chime-style [style] | Set or cycle global chime style (random, BalladPiano, ...) |
/nerdflair chime-volume [0-100] | Set chime volume (0 = muted) |
/nerdflair color-palette [mode] | Set or cycle palette (vibrant, muted, mono) |
/nerdflair layout [mode] | Set or cycle layout (full, compact, minimal) |
/nerdflair spinner-verbs | Toggle custom spinner verbs on/off |
/nerdflair terminal-bell | Toggle terminal bell on/off (tab indicator) |
/nerdflair width [auto|50-150] | Set layout width |
Cursor / VS Code Extension
A lightweight extension brings NerdFlair's audio chimes to Cursor (or VS Code). It reuses the same 20 chime styles from the Claude Code plugin.
What's included
