[DOCS] `/rename` command docs show argument as required, but it's now optional (auto-generates name)

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/interactive-mode

Section/Topic

"Built-in commands" table and session management documentation

Current Documentation

The built-in commands table in interactive-mode.md shows:

| /rename <name> | Rename the current session for easier identification |

The <name> angle brackets suggest the argument is required.

In common-workflows.md, the only example is:

`` > /rename auth-refactor ``

And the guidance says:

"Name sessions early: Use /rename when starting work on a distinct task"

All documentation shows /rename exclusively with an explicit name argument.

What's Wrong or Missing?

v2.1.41 improved /rename to auto-generate a session name from conversation context when called without arguments. This means:

• /rename (no argument) now works — it generates a descriptive name based on the conversation
• The <name> parameter is optional, not required

The current documentation:

1. Shows the syntax as /rename <name> which implies the argument is required
2. Only provides examples with explicit names
3. Does not mention the auto-generate behavior at all

Suggested Improvement

1. Update the built-in commands table entry to:

| /rename [name] | Rename the current session. Without a name, auto-generates one from conversation context |

1. Add an example of the no-argument usage in common-workflows.md:

/rename — Auto-generates a descriptive name based on your conversation (e.g., "auth-refactor-jwt-migration") /rename my-custom-name — Uses the specified name

Impact

Medium - Makes feature difficult to understand

Additional Context

• Added in v2.1.41 (released 2026-02-13)
• Related feature requests exist (#15762 "Smart Session Rename", #25450 "Auto-rename sessions on exit") — this partially addresses those requests but the implementation is undocumented
• The common-workflows.md session management section and best-practices.md also reference /rename and would benefit from mentioning the auto-generate option