# 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)

Autocompletado de texto fantasma para el [agente de codificación Pi](https://pi.dev/) (`@earendil-works/pi-coding-agent`).

Mientras escribes en el prompt de Pi, un LLM predice la continuación más
probable de la línea actual y la muestra en gris a la derecha del cursor.
Pulsa **Flecha derecha** para aceptar.

**Multilingüe** (sesión 52): la segmentación de palabras Unicode maneja
acentos españoles, diéresis alemanas, scripts CJK y marcas combinatorias.

## Inicio rápido

### 1. Obtener una clave API de Mercury Edit 2

```bash
export INCEPTION_API_KEY="tu-clave"
```

### 2. Instalar la extensión

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

### 3. Iniciar Pi

```bash
pi
```

## Configuración

| Variable | Predeterminado | Efecto |
| --- | --- | --- |
| `PI_GHOST_DISABLED` | sin definir | `1` para desactivar |
| `PI_GHOST_PROVIDER` | Mercury Edit 2 | `cloud`, `local`, o `router` |
| `INCEPTION_API_KEY` | — | Clave API |
| `PI_GHOST_CHAT_MAX_TOKENS` | `256` | Límite de tokens (chat) |
| `PI_GHOST_CHAT_TEMPERATURE` | `0.75` | Temperatura (chat) |

> Consulta el [README en inglés](README.md#configuration) para la referencia completa.

## Enrutamiento por registro

| Registro | Rama | Prompt del sistema |
| --- | --- | --- |
| `code` | **FIM** | Completar código/comando/ruta |
| `agent-message` | **Chat** | «Continuar el mensaje al asistente» |
| `general-prose` | **Chat** | «Continuar el texto naturalmente, mismo idioma» |

```bash
PI_GHOST_PROVIDER=router INCEPTION_API_KEY=tu-clave pi ...
```

## Comandos

| Comando | Efecto |
| --- | --- |
| `/ghost` | Mostrar configuración |
| `/ghost on` | Activar para esta sesión |
| `/ghost off` | Desactivar para esta sesión |

> Documentación completa: [README en inglés](README.md) y [`docs/`](docs/).