---
slug: "pi-auto-rename"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/victor-software-house/pi-auto-rename@main/README.md"
repo: "https://github.com/victor-software-house/pi-auto-rename"
source_file: "README.md"
branch: "main"
---
# pi-auto-rename

Pi extension that auto-renames sessions using AI. Provides a single `/rename` command with subcommands for manual renaming, model configuration, and state inspection.

## Install

```bash
pi install npm:pi-auto-rename
```

Or from git:

```bash
pi install git:github.com/victor-software-house/pi-auto-rename
```

## Commands

### `/rename`

No arguments -- rename the current session from the full conversation history.

### `/rename model`

Open an interactive model picker to choose which model generates session names.

### `/rename model <provider/model>`

Set the naming model directly without the picker.

```text
/rename model anthropic/claude-haiku-4-5
/rename model openai/gpt-4o-mini
```

### `/rename show`

Print the current naming model.

### `/rename reset`

Restore the default naming model (`anthropic/claude-haiku-4-5`).

### `/rename help`

Print the usage string.

## Auto-naming

Sessions are named automatically after the first assistant response. The extension uses the first user message to generate a 2-6 word Title Case name. Use `/rename` (no args) at any point to regenerate the name from the full conversation history.

## Configuration

The selected naming model persists in `~/.pi/agent/extensions/pi-auto-rename.json` across sessions and restarts.

## Acknowledgments

Inspired by [pi-session-auto-rename](https://github.com/egornomic/pi-session-auto-rename) by Egor.

## License

MIT