# @normful/pi-auto-name
Nomme automatiquement ta session Pi et les surfaces du multiplexeur de terminal en fonction de la conversation。
Prend en charge le renommage d'un panneau herdr ou d'un onglet herdr contenant Pi：
Prend également en charge le renommage d'une fenêtre tmux contenant Pi：
Et prend en charge le renommage d'un panneau zellij ou d'un onglet zellij contenant Pi：
Plusieurs langues sont également prises en charge，comme le français：
Liste de toutes les langues prises en charge：English、Español、Deutsch、Français、Italiano、Nederlands、Português、Bahasa Indonesia、Tiếng Việt、Türkçe、Polski、Українська、فارسی、العربية、हिन्दी、简体中文、繁體中文、日本語、한국어、ไทย
## Installation
```bash
pi install npm:@normful/pi-auto-name
```
## Utilisation
L'extension est entièrement automatique; il n'y a rien à exécuter。
Configure-le une fois，c'est tout。Règle-le et oublie-le。
## Comment ça marche
Après la première entrée utilisateur（ou le premier événement `agent_settled` — voir la config ci-dessous），il renomme la session Pi et renomme ce qui contient：
- fenêtre tmux
- panneau herdr et onglet herdr
- panneau zellij et onglet zellij
De plus，tu peux aussi le configurer pour renommer en continu au fur et à mesure que la conversation évolue，en configurant `reRenameEveryNTurns`。
## Configuration
Enregistre la configuration dans：
- Globalement：`~/.config/pi-auto-name/config.json`（respecte `XDG_CONFIG_HOME`）
- Remplacement par projet：`.pi/pi-auto-name.json`
Configuration par défaut complète：
```json
{
"enabled": true,
"initialRenameTrigger": "first-input",
"language": "en",
"namingContextDepth": "recent-user-messages",
"namingModel": "",
"namingStyle": "natural",
"replaceExistingName": "always",
"reRenameEveryNTurns": 0,
"respectExternalRenames": true,
"sessionNameMaxLength": 200,
"skipSessionNameDedup": false,
"surfaces": {
"renameHerdrPane": true,
"renameHerdrTab": true,
"renamePiSession": true,
"renameTmuxWindow": true,
"renameZellijPane": true,
"renameZellijTab": true
},
"windowNameMaxLength": 30
}
```
Chaque clé de configuration est optionnelle。
## Référence de configuration
| Key | Type | Default | Meaning |
| --------------------------- | --------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `enabled` | `boolean` | `true` | `false` désactive cette extension entièrement。 |
| `initialRenameTrigger` | `string` | "first-input" | Quand le premier renommage est déclenché：
"first-input" — après avoir envoyé le premier prompt"first-agent-settled" — après la première exécution LLM est terminée（après le premier événement `agent_settled`）。
|
| `language` | `string` | `"en"` | L'un de：en、es、de、fr、it、nl、pt/pt-BR/pt-PT、id、vi、tr、pl、uk、fa、ar、hi、zh/zh-CN/zh-Hans、zh-Hant/zh-TW/zh-HK、ja、ko、th |
| `namingContextDepth` | `string` | "recent-user-messages" | Quelle quantité de conversation envoyer au LLM dans chaque prompt de renommage：
"first-user-message" — seulement le premier message utilisateur"recent-user-messages" — premier message utilisateur plus les 3 derniers messages utilisateur"full-conversation" — toute la conversation（utilisateurs，assistants，appels d'outils et résultats），limitée à ~60k caractères en conservant à la fois l'ouverture（intention principale）et la queue la plus récente
|
| `namingModel` | `string` | "" | Remplacement provider/modelId pour l'appel LLM de renommage。Exemple："openrouter/nvidia/nemotron-3-nano-30b-a3b:free"。Laisse vide pour utiliser ton modèle et fournisseur Pi par défaut configuré。 |
| `namingStyle` | `string` | "natural" | Le style de renommage utilisé pour les deux noms：
"natural" — phrase libre"slug" — minuscules avec tirets。"topic-project" — `｜`，projet dérivé du répertoire de travail actuel
|
| `replaceExistingName` | `string` | "always" | Quand remplacer un nom de session Pi，nom de fenêtre tmux，nom de panneau/onglet herdr，nom de panneau/onglet zellij existant：
"always" — toujours remplacer"never" — ne jamais remplacer
|
| `reRenameEveryNTurns` | `integer` | `0` | Renommer tous les N tours（chaque événement `agent_settled`）。`0` ne renomme jamais。 |
| `respectExternalRenames` | `boolean` | `true` | Lorsque `true`，désactive le renommage de cette extension après la détection d'un renommage externe（par exemple après avoir exécuté manuellement `/name`）。 |
| `sessionNameMaxLength` | `integer` | `200` | Limite maximale de caractères pour le nom de session Pi。 |
| `skipSessionNameDedup` | `boolean` | `false` | `true` saute l'envoi des noms de session Pi existants dans le prompt de renommage。`false`（par défaut）envoie jusqu'à 15 noms de session existants pour éviter les doublons。 |
| `surfaces.renamePiSession` | `boolean` | `true` | `false` désactive le renommage de la session Pi。 |
| `surfaces.renameHerdrPane` | `boolean` | `true` | `false` désactive le renommage du panneau herdr où Pi s'exécute。 |
| `surfaces.renameHerdrTab` | `boolean` | `true` | `false` désactive le renommage de l'onglet herdr dans lequel ce processus s'exécute。 |
| `surfaces.renameTmuxWindow` | `boolean` | `true` | `false` désactive le renommage de la fenêtre tmux dans laquelle ce processus s'exécute。 |
| `surfaces.renameZellijPane` | `boolean` | `true` | `false` désactive le renommage du panneau zellij dans lequel ce processus s'exécute。 |
| `surfaces.renameZellijTab` | `boolean` | `true` | `false` désactive le renommage de l'onglet zellij dans lequel ce processus s'exécute。 |
| `windowNameMaxLength` | `integer` | `30` | Max caractères pour chaque nom de fenêtre terminal/panel（panel/onglet herdr，fenêtre tmux，panel/onglet zellij）。L'un des deux contrôleurs de longueur。 |
## Débogage
Définit `PI_AUTO_NAME_DEBUG=1` et l'extension ajoutera des entrées structurées `pi-auto-name:debug` à la transcription de la session et les affichera dans l'interface TUI。（Les entrées de débogage ne sont pas envoyées au LLM。）
## Inspiration
Cette extension est inspirée par plusieurs autres extensions similaires：
-
-
-
-