[DOCS] `spinnerVerbs` settings entry incorrectly says custom verbs apply to turn duration messages

Resolved 💬 2 comments Opened May 19, 2026 by coygeek Closed May 23, 2026

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/settings

Section/Topic

spinnerVerbs and showTurnDuration in the settings reference table

Current Documentation

The settings reference currently says:

showTurnDuration | Show turn duration messages after responses, e.g. "Cooked for 1m 6s". Default: true. Appears in /config as Show turn duration spinnerVerbs | Customize the action verbs shown in the spinner and turn duration messages. Set mode to "replace" to use only your verbs, or "append" to add them to the defaults

What's Wrong or Missing?

This is outdated as of v2.1.144. The changelog for v2.1.144 says Claude Code restored built-in past-tense post-turn duration text such as "Worked for 5s" instead of applying custom spinnerVerbs there.

The current settings entry still tells users that spinnerVerbs customizes both the live spinner and the turn duration message after the response. That now overstates the setting's behavior and sets the wrong expectation for anyone trying to customize the post-turn duration text.

Suggested Improvement

Update the spinnerVerbs description so it no longer says custom verbs apply to turn duration messages after the response.

For example:

Before:

Customize the action verbs shown in the spinner and turn duration messages.

After:

Customize the action verbs shown in the live spinner. Post-turn duration messages keep the built-in past-tense wording (for example, "Worked for 5s"); use showTurnDuration to show or hide those messages.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/settings | spinnerVerbs currently says custom verbs apply to turn duration messages |
| https://code.claude.com/docs/en/changelog | v2.1.144 says the post-turn duration message was changed back to built-in past-tense wording |

Total scope: 2 pages involved

View original on GitHub ↗

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