Auto-Rename Session
Automatically generates meaningful titles for sessions using AI.
Automatically generates meaningful 2-5 word titles for Claude Code sessions using AI.
How It Works
- Stop hook triggers when Claude stops
- Parses transcript for first user/assistant exchange
- Skips if already titled
- Calls Claude Haiku to generate title
- Writes
custom-titleto transcript
Title Rules
- 2-5 words, starts with verb
- Always English (even for non-English input)
- Examples: "Build React Auth", "Debug API Error", "Fix Code Bug"
Commands
| Command | Description |
|---|---|
auto-rename:start | Run the hook handler |
auto-rename:rename-all | Batch rename all sessions in a project |
auto-rename:test | Run tests |
Setup
Add to ~/.claude/settings.json:
JSON
{
"hooks": {
"Stop": [
{
"command": "bun ~/.claude/scripts/auto-rename-session/src/index.ts"
}
]
}
}Batch Rename
Rename all existing sessions in a project:
BASH
cd ~/.claude/scripts && bun run auto-rename:rename-all