Feature Request: Customizable Spinner Messages

Resolved 💬 8 comments Opened Feb 4, 2026 by summersjc Closed Mar 25, 2026

Feature Request: Customizable Spinner Messages

Summary

Allow users to customize the spinner/status words that appear while Claude Code is working (e.g., "Meandering", "Pondering", "Fluttering") via a configuration file.

Motivation

The current 225 spinner words are delightful, but I'd love to personalize this experience. I work at FamilySearch.org and would like to replace the spinner verbs with names of my ancestors. Watching "Great-grandpa William" or "Ancestor Sarah" appear while Claude works would add a meaningful personal touch to my daily workflow.

This small customization would make Claude Code feel more personal and could benefit others who want to:

  • Display names of family members, pets, or colleagues
  • Use words in their native language
  • Add company/team-specific humor
  • Create themed experiences (holidays, projects, etc.)

Proposed Implementation

Option A: Configuration file
Add support for ~/.claude/spinners.txt (one word/phrase per line):

Great-grandpa William
Ancestor Sarah
Grandma Rose
Uncle Thomas
...

Option B: Settings array
Add a spinners field to ~/.claude/settings.json:

{
  "spinners": [
    "Great-grandpa William",
    "Ancestor Sarah",
    "Grandma Rose"
  ]
}

Behavior:

  • If the custom file/array exists and is non-empty, use it instead of the built-in list
  • If empty or missing, fall back to the default 225 words
  • Optionally support a spinnerMode: "append" setting to add custom words to the existing list rather than replacing

Additional Context

The spinner words are currently hardcoded in the compiled binary. Making them configurable at runtime via a simple text file would be a low-complexity change with high personalization value.

View original on GitHub ↗

This issue has 8 comments on GitHub. Read the full discussion on GitHub ↗