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
• 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 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

• 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