# 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-completamento con testo fantasma (« ghost text ») per l'[agente di codifica Pi](https://pi.dev/) (`@earendil-works/pi-coding-agent`).

Mentre digiti al prompt di Pi, un LLM predice la continuazione più probabile
della riga corrente e la mostra in grigio a destra del cursore. Premi
**Freccia destra** per accettare.

**Multilingue** (session 52): la segmentazione delle parole Unicode gestisce
accenti italiani, umlaut tedeschi, script CJK e segni combinanti.

## Avvio rapido

### 1. Ottenere una chiave API Mercury Edit 2

```bash
export INCEPTION_API_KEY="la-tua-chiave"
```

### 2. Installare l'estensione

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

### 3. Avviare Pi

```bash
pi
```

## Configurazione

| Variabile | Predefinito | Effetto |
| --- | --- | --- |
| `PI_GHOST_DISABLED` | non impostato | `1` per disattivare |
| `PI_GHOST_PROVIDER` | Mercury Edit 2 | `cloud`, `local`, o `router` |
| `INCEPTION_API_KEY` | — | Chiave API |
| `PI_GHOST_CHAT_MAX_TOKENS` | `256` | Limite di token (chat) |
| `PI_GHOST_CHAT_TEMPERATURE` | `0.75` | Temperatura (chat) |

> Consulta il [README in inglese](README.md#configuration) per la reference completa.

## Routing per registro

| Registro | Ramo | Prompt di sistema |
| --- | --- | --- |
| `code` | **FIM** | Completare codice/comando/percorso |
| `agent-message` | **Chat** | «Continua il messaggio all'assistente» |
| `general-prose` | **Chat** | «Continua il testo naturalmente, stessa lingua» |

```bash
PI_GHOST_PROVIDER=router INCEPTION_API_KEY=la-tua-chiave pi ...
```

## Comandi

| Comando | Effetto |
| --- | --- |
| `/ghost` | Mostra configurazione |
| `/ghost on` | Attiva per questa sessione |
| `/ghost off` | Disattiva per questa sessione |

> Documentazione completa: [README in inglese](README.md) e [`docs/`](docs/).