@henryqw/pi-herdr-rename

Give each conversation one short human title across Pi and Herdr while keeping semantic naming for Git branches.

Install

pi install npm:@henryqw/pi-task-models
pi install npm:@henryqw/pi-herdr-rename

Requires Pi Coding Agent 0.84.2+.

With

| Package | Why | | --- | --- | | @henryqw/pi-task-models | Required. Shared model profiles for title generation. |

Use

| Surface | Type | Purpose | | --- | --- | --- | | /rename | command | Generate a display title and semantic branch from up to three recent user/assistant rounds. |

First real user prompt generates a title in the background after Pi expands skill and prompt-template shorthand. It does not delay main reply. Extension-injected prompts, empty prompts, and image-only input are ignored.

Display titles are natural task phrases, preferably three or four words and always at most four words and 20 characters. Model classification stays internal: refactor: update task logic displays as Update task logic and maps to Git branch refactor/update-task-logic.

In a linked worktree, a detached checkout or Herdr worktree/... branch is renamed; an existing non-generated branch stays. A generated workspace label such as worktree-brave-meadow-4aa8 becomes display title; custom workspace names stay. Enclosing Herdr tab updates only when this pane is tab's only pane. Outside Herdr, only Pi session name changes.

Tries assigned profile primary, then fallback, while honoring configured thinking level. Never substitutes current session model. No viable route leaves titles unchanged. Resuming a session created by this version reapplies saved display title and semantic branch without another model request. Older titles receive no migration.

Remove

pi remove npm:@henryqw/pi-herdr-rename

Development

npm test --workspace @henryqw/pi-herdr-rename
npm run typecheck --workspace @henryqw/pi-herdr-rename
npm run pack:check --workspace @henryqw/pi-herdr-rename