Keep Pi sessions easy to recognize with short names based on their work.
Use it in Pi
Nothing to invoke for automatic names.
After meaningful conversation and agent activity, Pi uses current model to suggest a one to three word session name.
It waits for Pi to become idle, then refines names as work changes without replacing a name you set yourself.
Run /session-rename to request a naming pass now.
Run /session-rename fix auth flow to set that exact name and keep automatic renaming off for this session.
Automatic naming needs a selected model with available credentials.
Naming sends a bounded conversation excerpt to that provider in an additional model request, which may incur usage charges.
Change idle delay with Pi settings when useful:
{ "session-rename": { "idleDelayMs": 5000 } }
Set PI_SESSION_RENAME_IDLE_DELAY_MS=5000 for an environment-specific delay.
Generate/refine session name, or set exact name with args
Setting names
Setting
Environment
session-rename.idleDelayMs
PI_SESSION_RENAME_IDLE_DELAY_MS
Setting values
Setting
Default
Valid values
Purpose
session-rename.idleDelayMs
10000
Integer 0–2147483647
Rename idle delay: Milliseconds to wait before automatic session renaming.
<img src="assets/banner.svg" alt="session-rename" height="70">
# session-rename
Keep Pi sessions easy to recognize with short names based on their work.
## Use it in Pi
Nothing to invoke for automatic names.
After meaningful conversation and agent activity, Pi uses current model to suggest a one to three word session name.
It waits for Pi to become idle, then refines names as work changes without replacing a name you set yourself.
Run `/session-rename` to request a naming pass now.
Run `/session-rename fix auth flow` to set that exact name and keep automatic renaming off for this session.
Automatic naming needs a selected model with available credentials.
Naming sends a bounded conversation excerpt to that provider in an additional model request, which may incur usage charges.
Change idle delay with Pi settings when useful:
```json
{ "session-rename": { "idleDelayMs": 5000 } }
```
Set `PI_SESSION_RENAME_IDLE_DELAY_MS=5000` for an environment-specific delay.
Restart Pi after changing settings.
Install through [Installation](../../README.md#install).
## Reference
<!-- config:start -->
### Commands
| Command | Purpose |
| --- | --- |
| `/session-rename` | Generate/refine session name, or set exact name with args |
### Setting names
| Setting | Environment |
| --- | --- |
| `session-rename.idleDelayMs` | `PI_SESSION_RENAME_IDLE_DELAY_MS` |
#### Setting values
| Setting | Default | Valid values | Purpose |
| --- | --- | --- | --- |
| `session-rename.idleDelayMs` | `10000` | Integer 0–2147483647 | Rename idle delay: Milliseconds to wait before automatic session renaming. |
<!-- config:end -->