[FEATURE] Add custom entries for the spinner
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] This is a single feature request (not multiple features)
Problem Statement
Why
- Personalization makes long-running sessions feel less repetitive and more enjoyable.
- Teams and individuals could match Claude Code's voice to their own culture (gamer-speak, sysadmin gallows humor, project-specific in-jokes, language preferences, etc.).
- The existing statusLine script already gives custom output below the prompt — letting spinnerTips follow the same spirit of "your terminal, your tone" feels consistent.
- Disabling tips entirely loses the playful affordance that the tips originally provide; opt-in customization is the middle ground.
Proposed behavior
- spinnerTips (array of strings, optional): user-supplied tip pool.
- spinnerTipsMode (enum, optional, default "extend"):
- "extend" — user tips appended to the built-in pool.
- "replace" — only the user-supplied tips are shown.
- If spinnerTipsEnabled: false, the pool is ignored regardless.
- Validation: skip empty strings, cap individual tip length to whatever the spinner can render without truncating, cap total list size at something sensible (e.g., 100).
Alternative considered
A statusLine script can already emit rotating text below the prompt. That works, but the spinner tips themselves are the moment people actually see — that's what's playful about Claude
Code, and it's currently the one user-facing piece of personality that isn't user-editable.
Additional context
- macOS, Claude Code (terminal). Most likely cross-platform applicable.
- No security concerns I can see — these are purely cosmetic strings rendered locally.
Proposed Solution
add the ability to add to, or replace the current set.
"Grinding…",
"Looking for healers…",
"Farming XP…",
"Stuck in tutorial…",
"Quaffing potion…",
"Re-rolling stats…",
"Waiting on raid…"
],
"spinnerTipsMode": "extend" // or "replace"
}
Alternative Solutions
_No response_
Priority
Low - Nice to have
Feature Category
CLI commands and flags
Use Case Example
I spend a lot of time staring at it waiting for things, and it would be fun to have some different words in there.
Additional Context
allow us to update the settings files with additional entries, or replace the existing set.
"Grinding…",
"Looking for healers…",
"Farming XP…",
"Stuck in tutorial…",
"Quaffing potion…",
"Re-rolling stats…",
"Waiting on raid…"
],
"spinnerTipsMode": "extend" // or "replace"
}
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗