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

Autocompletar com texto fantasma (« ghost text ») para o [agente de codificação Pi](https://pi.dev/) (`@earendil-works/pi-coding-agent`).

Enquanto você digita no prompt do Pi, um LLM prevê a continuação mais provável
da linha atual e a exibe em cinza à direita do cursor. Pressione **Seta para
a direita** para aceitar.

**Multilíngue** (session 52): a segmentação de palavras Unicode lida com
acentos portugueses, trema alemão, scripts CJK e marcas combinatórias.

## Início rápido

### 1. Obter uma chave de API do Mercury Edit 2

```bash
export INCEPTION_API_KEY="sua-chave"
```

### 2. Instalar a extensão

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

### 3. Iniciar o Pi

```bash
pi
```

## Configuração

| Variável | Padrão | Efeito |
| --- | --- | --- |
| `PI_GHOST_DISABLED` | não definido | `1` para desativar |
| `PI_GHOST_PROVIDER` | Mercury Edit 2 | `cloud`, `local`, ou `router` |
| `INCEPTION_API_KEY` | — | Chave de API |
| `PI_GHOST_CHAT_MAX_TOKENS` | `256` | Limite de tokens (chat) |
| `PI_GHOST_CHAT_TEMPERATURE` | `0.75` | Temperatura (chat) |

> Consulte o [README em inglês](README.md#configuration) para a referência completa.

## Roteamento por registro

| Registro | Ramo | Prompt do sistema |
| --- | --- | --- |
| `code` | **FIM** | Completar código/comando/caminho |
| `agent-message` | **Chat** | «Continuar a mensagem ao assistente» |
| `general-prose` | **Chat** | «Continuar o texto naturalmente, mesmo idioma» |

```bash
PI_GHOST_PROVIDER=router INCEPTION_API_KEY=sua-chave pi ...
```

## Comandos

| Comando | Efeito |
| --- | --- |
| `/ghost` | Mostrar configuração |
| `/ghost on` | Ativar para esta sessão |
| `/ghost off` | Desativar para esta sessão |

> Documentação completa: [README em inglês](README.md) e [`docs/`](docs/).