@henryqw/pi-herdr-rename

Replace hard-to-identify generated workspace labels with one short Pi conversation title. The title labels Pi and Herdr, maps to Git, and returns on resume without another model call.

Install

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

Run /task-models and configure the fast profile. Open /task-models again and verify that fast no longer says not configured. Herdr is required for pane, tab, workspace, and branch updates.

Outside Herdr, the extension still changes the Pi session name.

Works with

Package	Relationship	Purpose
@henryqw/pi-task-models	Required	Provides shared title-generation model profiles.

Use

Send the first real prompt. A title appears in the background without delaying the reply.

Run /rename after the task changes. It generates a new display title and semantic branch from up to five recent user messages.

Flow

Trigger

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

Title and branch rules

A semantic branch is a Git-safe branch name made from a task type and the display-title words. Model classification stays internal. For example, refactor: update task logic displays as Update task logic and maps to 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.
• The enclosing Herdr tab updates only when this pane is the tab's only pane.
• Outside Herdr, only the Pi session name changes.

Model route and resume

The shared pi-task-models config is at ~/.pi/agent/config/pi-task-models/config.json. It can explicitly override the local pi-herdr-rename/rename declaration, which defaults to fast.

The extension tries the assigned profile primary, then fallback, while honoring the configured thinking level. It never substitutes the current session model.

Resuming a session created by this version reapplies the saved display title and semantic branch without another model request.

Limits and recovery

Display titles are natural task phrases. They are preferably three or four words and always at most four words and 20 characters.

A missing shared task-model config warns once at session start. Run /task-models to configure rename routing. No viable route leaves titles unchanged.

Herdr and Git synchronization failures appear as warnings. Cancellation by a newer rename remains silent. Older titles receive no migration.