@tifan/pi-rename

Generate pi session names and rename the current Herdr tab.

Packages

Package details

extension

Install @tifan/pi-rename from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@tifan/pi-rename
Package
@tifan/pi-rename
Version
0.2.0
Published
Jun 5, 2026
Downloads
not available
Author
tifan
License
MIT
Types
extension
Size
27.2 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.

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

If pi is not running inside Herdr, only the pi session name is updated.

License

MIT