nerdflair

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 and randomizable icon and texture decorations (flair)
• 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 output style indicator
• Active MCP servers
• Session cost, API duration, and token throughput

Prerequisites

A Nerd Font is required. The statusline uses Nerd Font glyphs for icons, Powerline caps, and context bar textures. 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

• Random style per session — one of 20 chime styles is chosen at random each time the editor opens
• Audio chimes via Cursor hooks — SessionStart, Stop, and SessionEnd sounds
• Status bar — shows the current style; click to cycle through all 20

Install

Clone the repo and symlink the extension into your editor's extensions directory:

git clone https://github.com/jcraigk/nerdflair.git ~/nerdflair

# Cursor
ln -s ~/nerdflair/cursor-extension ~/.cursor/extensions/nerdflair-chimes