[FEATURE] Add custom entries for the spinner

Resolved 💬 3 comments Opened May 21, 2026 by ahbradford Closed Jun 20, 2026

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"
}

View original on GitHub ↗

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