# pi-ghost-autocomplete

[English](README.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Español](README.es.md) | [中文](README.zh-CN.md) | [日本語](README.ja.md) | [Português](README.pt-BR.md) | [Italiano](README.it.md) | [Русский](README.ru.md)

Auto-complétion en texte fantôme (« ghost text ») pour l'[agent de codage Pi](https://pi.dev/) (`@earendil-works/pi-coding-agent`).

Pendant que vous tapez à l'invite Pi, un LLM prédit la suite la plus probable
de la ligne courante et l'affiche en gris à droite du curseur. Appuyez sur
**Flèche droite** pour accepter. Le curseur ne bouge pas tant que vous ne le
faites pas.

**Multilingue** (session 52) : la segmentation des mots Unicode gère les
accents français, les trémas allemands, les scripts CJK et les marques
combinaison. Le routage par registre garantit que la prose est complétée
dans la même langue.

## Démarrage

### 1. Obtenir une clé API Mercury Edit 2

```bash
export INCEPTION_API_KEY="votre-clé"
```

### 2. Installer l'extension

```bash
pi install npm:pi-ghost-autocomplete
```

### 3. Lancer Pi

```bash
pi
```

## Configuration

| Variable | Défaut | Effet |
| --- | --- | --- |
| `PI_GHOST_DISABLED` | non défini | `1` pour désactiver |
| `PI_GHOST_PROVIDER` | Mercury Edit 2 | `cloud`, `local`, ou `router` |
| `INCEPTION_API_KEY` | — | Clé API |
| `PI_GHOST_CHAT_MAX_TOKENS` | `256` | Limite de tokens (chat) |
| `PI_GHOST_CHAT_TEMPERATURE` | `0.75` | Température (chat) |
| `PI_GHOST_METRICS` | non défini | `1` pour les métriques |

> Voir le [README anglais](README.md#configuration) pour la référence complète.

## Routage par registre

| Registre | Branche | Invite système |
| --- | --- | --- |
| `code` | **FIM** | Complétion de code/commande/chemin |
| `agent-message` | **Chat** | « Continuez le message à l'assistant » |
| `general-prose` | **Chat** | « Continuez le texte naturellement, même langue » |

```bash
PI_GHOST_PROVIDER=router INCEPTION_API_KEY=votre-clé pi ...
```

## Commandes

| Commande | Effet |
| --- | --- |
| `/ghost` | Afficher la configuration |
| `/ghost on` | Activer pour cette session |
| `/ghost off` | Désactiver pour cette session |

## Métriques

```bash
PI_GHOST_METRICS=1 pi ...
```

Les métriques incluent : latences, registre de complétion, résultat et cause
des réponses vides (`token-budget-exhausted`, `model-empty`, etc.).

> Documentation complète : [README anglais](README.md) et [`docs/`](docs/).