<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.

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` |
<!-- config:end -->

[Changelog](./CHANGELOG.md).