@tifan/pi-rename
Generate pi session names and rename the current Herdr tab.
Package details
Install @tifan/pi-rename from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@tifan/pi-rename- Package
@tifan/pi-rename- Version
0.3.0- Published
- Jun 10, 2026
- Downloads
- not available
- Author
- tifan
- License
- MIT
- Types
- extension
- Size
- 29.9 KB
- Dependencies
- 0 dependencies · 0 peers
Pi manifest JSON
{
"extensions": [
"./src/index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
@tifan/pi-rename
Generate session names for pi and Herdr.
Install
pi install npm:@tifan/pi-rename
For local development:
pi install /absolute/path/to/pi-extensions/packages/pi-rename
How it works
Run /rename to generate a fresh hyphen-separated session name. The extension applies the name to the pi session and, when pi is running inside Herdr, to the current Herdr tab.
When a named session starts or resumes in Herdr, the extension also applies the saved pi session name to the current tab if the tab still has its default Herdr label.
/rename builds naming context from the first user message plus up to three latest user messages. It ignores assistant replies, tool output, and attachments. Before sending context to the rename model, it redacts common secrets.
If the rename model is unavailable, /rename falls back to a local name from the latest user message.
Commands
/rename: Generate and apply a session name./rename status: Show model and rename status./rename config: Choose a rename model./rename help: List rename commands.
Manual names are not supported. Use pi's built-in /name command when you want an exact name.
Configuration
Out of the box, pi-rename uses this default model: openai-codex/gpt-5.4-mini.
Run /rename config to choose a different model.
After you choose a model, pi-rename uses only that model. Choose Use default in /rename config to return to the default.
You can also edit ~/.config/pi/extensions/pi-rename.json manually:
{
"model": "openai-codex/gpt-5.4-mini"
}
Herdr behavior
The extension uses HERDR_PANE_ID to find the current Herdr pane, then renames that pane's tab.
On session startup or resume, it only auto-renames tabs that still have the default Herdr label, such as the tab number. It does not overwrite custom Herdr tab labels.
On quit, if the Herdr tab still matches the saved pi session name, the extension resets the tab label to its tab number. Custom Herdr tab labels are preserved.
If pi is not running inside Herdr, only the pi session name is updated.