@henryqw/pi-herdr-rename 2.1.10 → 2.1.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -16
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# `@henryqw/pi-herdr-rename`
|
|
2
2
|
|
|
3
|
-
Give each conversation one short human title across Pi and Herdr
|
|
3
|
+
Give each conversation one short human title across Pi and Herdr. Use meaningful Git branch names too.
|
|
4
4
|
|
|
5
5
|
## Why
|
|
6
6
|
|
|
7
|
-
- **Created for**:
|
|
8
|
-
- **Advantage**: Titles stay natural (≤4 words), map to semantic Git branch names, and
|
|
7
|
+
- **Created for**: Replace generated labels like `worktree-brave-meadow-4aa8` with human-readable display titles for every conversation.
|
|
8
|
+
- **Advantage**: Titles stay natural (≤4 words), map to semantic Git branch names, and reapply on resume without another model request.
|
|
9
9
|
|
|
10
10
|
## Install
|
|
11
11
|
|
|
@@ -14,26 +14,37 @@ pi install npm:@henryqw/pi-task-models
|
|
|
14
14
|
pi install npm:@henryqw/pi-herdr-rename
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
Requires Pi Coding Agent 0.84.4+.
|
|
18
|
-
|
|
19
17
|
## With
|
|
20
18
|
|
|
21
|
-
|
|
22
|
-
| --- | --- |
|
|
23
|
-
| `@henryqw/pi-task-models` | Required. Shared model profiles for title generation. |
|
|
19
|
+
`@henryqw/pi-task-models` is required for shared title-generation model profiles.
|
|
24
20
|
|
|
25
21
|
## Use
|
|
26
22
|
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
23
|
+
Use `/rename` to generate a display title and semantic branch from up to three recent user/assistant rounds.
|
|
24
|
+
|
|
25
|
+
### Trigger
|
|
26
|
+
|
|
27
|
+
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.
|
|
28
|
+
|
|
29
|
+
### Title and branch rules
|
|
30
|
+
|
|
31
|
+
Display titles are natural task phrases. They are preferably three or four words and always at most four words and 20 characters.
|
|
32
|
+
|
|
33
|
+
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`.
|
|
34
|
+
|
|
35
|
+
- In a linked worktree, a detached checkout or Herdr `worktree/...` branch is renamed.
|
|
36
|
+
- An existing non-generated branch stays.
|
|
37
|
+
- A generated workspace label such as `worktree-brave-meadow-4aa8` becomes the display title automatically.
|
|
38
|
+
- `/rename` also replaces a custom workspace name.
|
|
39
|
+
- The enclosing Herdr tab updates only when this pane is the tab's only pane.
|
|
40
|
+
- Outside Herdr, only the Pi session name changes.
|
|
30
41
|
|
|
31
|
-
|
|
42
|
+
### Model choice and resume
|
|
32
43
|
|
|
33
|
-
|
|
44
|
+
The shared [`pi-task-models` config](../pi-task-models#config) is at `~/.pi/agent/config/pi-task-models.json`. It can explicitly override the local `pi-herdr-rename/rename` declaration, which defaults to `fast`.
|
|
34
45
|
|
|
35
|
-
|
|
46
|
+
The extension tries the assigned profile primary, then fallback, while honoring the configured thinking level. It never substitutes the current session model. No viable route leaves titles unchanged.
|
|
36
47
|
|
|
37
|
-
|
|
48
|
+
Resuming a session created by this version reapplies the 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.
|
|
38
49
|
|
|
39
|
-
|
|
50
|
+
Older titles receive no migration.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@henryqw/pi-herdr-rename",
|
|
3
|
-
"version": "2.1.
|
|
3
|
+
"version": "2.1.11",
|
|
4
4
|
"description": "Generate short Pi display titles and rename the current Herdr location.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"pi-package",
|
|
@@ -15,9 +15,9 @@
|
|
|
15
15
|
},
|
|
16
16
|
"license": "MIT",
|
|
17
17
|
"files": [
|
|
18
|
+
"LICENSE",
|
|
18
19
|
"extensions",
|
|
19
|
-
"README.md"
|
|
20
|
-
"LICENSE"
|
|
20
|
+
"README.md"
|
|
21
21
|
],
|
|
22
22
|
"scripts": {
|
|
23
23
|
"test": "node --test test/*.test.ts",
|