Give each conversation one short human title across Pi and Herdr while keeping semantic naming for Git branches.
- Created for: Replacing generated labels like
worktree-brave-meadow-4aa8with human-readable display titles for every conversation. - Advantage: Titles stay natural (≤4 words), map to semantic Git branch names, and are reapplied on resume without another model request.
pi install npm:@henryqw/pi-task-models
pi install npm:@henryqw/pi-herdr-renameRequires Pi Coding Agent 0.84.3+.
| Package | Why |
|---|---|
@henryqw/pi-task-models |
Required. Shared model profiles for title generation. |
| 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.
Shared pi-task-models config at ~/.pi/agent/config/pi-task-models.json routes task pi-herdr-rename/rename to the fast profile by default.
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 the display title automatically; /rename also replaces a custom workspace name. 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. Herdr and Git synchronization failures appear as warnings; cancellation by a newer rename remains silent. Older titles receive no migration.