IAutocomplete (VS Code Extension)
Extensão customizada para o Visual Studio Code que une dois fluxos de IA:
- Autocomplete em tempo real (Ghost Text): Gemini 2.5 Flash-Lite via Fill-in-the-Middle (FIM), com debounce, cancelamento da requisição quando você volta a digitar, cache e limite de requisições.
- Edição agêntica e refatoração: abre o Claude Code CLI num terminal integrado com o arquivo ativo (e a seleção) já no prompt.
- Mensagem de commit: um botão na view Source Control escreve uma mensagem breve, no idioma do VS Code, a partir dos arquivos da lista de commit.
Arquitetura
[VS Code Extension (TypeScript)]
│
├──► Evento de digitação (debounce 300ms) ──► [API Gemini 2.5 Flash-Lite] (Ghost Text / FIM)
│
└──► Atalho (Ctrl+Shift+Alt+K / Cmd+Shift+Alt+K) ───► [Claude Code CLI] (Refatoração / Agente)
Estrutura
src/
├── extension.ts # Ponto de entrada: registra o autocomplete e os comandos
├── providers/
│ ├── geminiFim.ts # Ghost text: debounce, abort, cache, limite e limpeza da sugestão
│ ├── claudeAgent.ts # Abre o Claude Code CLI no terminal integrado (sem shell)
│ └── commitMessage.ts # Mensagem de commit a partir da lista de commit
├── ui/
│ ├── statusBar.ts # Indicador "Gemini" na barra de status
│ ├── menu.ts # Menu do indicador e alternância do autocomplete
│ └── ghostColor.ts # Cor violeta opcional das sugestões
├── utils/
│ ├── apiKey.ts # Chave do Gemini no cofre seguro (SecretStorage)
│ ├── context.ts # Extrai prefixo, sufixo e metadados ao redor do cursor
│ ├── exclusions.ts # Arquivos e linguagens que nunca vão ao Gemini
│ ├── executable.ts # Localiza o executável do Claude Code (PATH/PATHEXT)
│ ├── git.ts # Acesso à API da extensão Git do VS Code
│ ├── logger.ts # Canal de logs "IAutocomplete" (painel Output)
│ ├── lruCache.ts # Cache LRU das sugestões
│ ├── rateLimiter.ts # Limite de requisições por minuto
│ └── text.ts # Limpeza das sugestões (cercas, eco do prefixo, sufixo)
└── test/ # Testes (rodam num VS Code real via @vscode/test-electron)
Pré-requisitos
Node.js 18+
Chave de API do Gemini (Google AI Studio)
Claude Code CLI instalado e autenticado:
npm install -g @anthropic-ai/claude-code
claude
Chave do Gemini
Rode o comando IAutocomplete: Configurar chave do Gemini (Ctrl+Shift+P) e cole a chave. Ela fica no cofre seguro do sistema, não no settings.json.
Se você usava uma versão antiga com a chave em aiRouter.geminiApiKey, ela é movida para o cofre automaticamente e apagada do settings.json.
Configurações
| Setting |
Padrão |
Descrição |
aiRouter.enabled |
true |
Liga/desliga o autocomplete (também pelo menu da barra de status). |
aiRouter.debounceMs |
300 |
Espera (ms) após parar de digitar antes de chamar o Gemini. |
aiRouter.geminiModel |
gemini-2.5-flash-lite |
Modelo usado no autocomplete. |
aiRouter.claudePath |
claude |
Executável do Claude Code (nome no PATH ou caminho absoluto). Só vale nas configurações de usuário. |
aiRouter.excludeFiles |
.env, chaves, credenciais... |
Arquivos (glob) que nunca são enviados ao Gemini. Somados aos padrão. |
aiRouter.disabledLanguages |
plaintext, markdown, dotenv, properties, ini |
Linguagens sem autocomplete. Somadas às padrão. |
aiRouter.cacheSize |
50 |
Sugestões recentes guardadas em memória (0 desliga o cache). |
aiRouter.maxRequestsPerMinute |
15 |
Máximo de requisições ao Gemini por minuto (0 = sem limite). Ajuste ao seu plano. |
Uso
Autocomplete: digite e pare por ~300ms; a sugestão aparece como ghost text. Tab aceita.
Barra de status: o indicador Gemini (canto inferior direito) mostra o estado em tempo real:
| Indicador |
Significado |
✨ Gemini |
Pronto |
⟳ Gemini |
Consultando a API |
✨ Gemini 380ms |
Última sugestão e sua latência |
⚡ Gemini cache |
Última sugestão veio do cache, sem chamar a API |
✓ Gemini: aceita |
Você aceitou a sugestão com Tab |
🕐 Gemini |
Limite de requisições por minuto atingido — o tooltip diz quando libera |
⚠ Gemini (fundo amarelo) |
Erro — passe o mouse para ver (chave inválida, limite 429, sem conexão...) |
🔑 Gemini: sem chave |
Falta configurar a chave (IAutocomplete: Configurar chave do Gemini) |
⊘ Gemini |
Autocomplete desativado |
O tooltip mostra o modelo e quantas sugestões foram aceitas na sessão. Clicar abre um menu para ativar/desativar, configurar a chave, trocar a cor, ver os logs ou chamar o Claude Code.
Cor da sugestão (opcional): rode IAutocomplete: Alternar cor violeta das sugestões para deixar o texto sugerido em violeta. Rode de novo para voltar à cor padrão do tema.
Claude Code: Ctrl+Shift+Alt+K (Cmd+Shift+Alt+K no Mac) com o editor focado, ou o comando IAutocomplete: Editar/Refatorar com Claude Code. Se houver seleção, as linhas são incluídas no prompt. O arquivo é salvo antes, e cada tarefa abre uma sessão nova no terminal Claude Code Agent.
Mensagem de commit: na view Source Control (Ctrl+Shift+G), clique no ✨ do cabeçalho, ou rode IAutocomplete: Gerar mensagem de commit. A extensão lê os arquivos da lista de commit (os que estão em staged; se não houver nenhum, todas as alterações) e escreve na caixa de mensagem algo como:
fix: corrige o cálculo da soma
Mudanças de naturezas diferentes ganham até 3 tópicos curtos abaixo do título. Revise e ajuste antes de commitar; a mensagem não é commitada sozinha.
O idioma da mensagem é o idioma de exibição do VS Code: em português, sai fix: corrige o cálculo da soma; em inglês, fix: correct the sum calculation; e assim por diante. Para trocar, rode Configure Display Language (Configurar Idioma de Exibição) e reinicie o VS Code. O tipo (feat, fix...) fica sempre em inglês, como manda o Conventional Commits.
Logs: painel Output → IAutocomplete (ou menu → Ver logs). Para ver cada sugestão, mude o nível para Debug na engrenagem do painel.
Privacidade
- O que é enviado ao Google (Gemini API): até 60 linhas antes e 25 depois do cursor, o nome do arquivo e a linguagem, a cada pausa na digitação.
- O que nunca é enviado: arquivos em
aiRouter.excludeFiles (.env, chaves, credenciais...) e linguagens em aiRouter.disabledLanguages (texto puro, markdown...).
- Plano gratuito: segundo os termos da Gemini API, o Google pode usar o conteúdo enviado no plano gratuito para melhorar os produtos dele, inclusive com revisão humana. Para código confidencial, use um plano pago ou desligue o autocomplete no projeto com
"aiRouter.enabled": false no settings do workspace.
- Mensagem de commit: ao clicar no ✨, vai ao Google a lista de arquivos e o diff de cada um (até ~4 mil caracteres por arquivo e ~24 mil no total). Arquivos de
aiRouter.excludeFiles vão só com o nome, nunca com o conteúdo.
- Claude Code: a extensão envia ao Claude Code só o caminho do arquivo e a sua instrução. O que o Claude lê depois segue as permissões do próprio Claude Code.
Desenvolvimento
npm install
npm run watch # ou: npm run compile
npm test # testes num VS Code real (baixado na 1ª vez para .vscode-test/)
Pressione F5 para abrir o Extension Development Host, rode IAutocomplete: Configurar chave do Gemini e abra qualquer arquivo de código.
Instalação definitiva (.vsix)
npm run package:vsix
code --install-extension iautocomplete-0.1.0.vsix
Para publicar no Marketplace, siga o guia 11 da pasta implementacoes/ do repositório.
Roadmap (v2)
- [x] Cache LRU em memória: últimas 50 sugestões (prefixo + sufixo) para resposta instantânea ao apagar e reescrever linhas.
- [x] Indicador na Status Bar: carregando, latência, cache, limite e erros de API.
- [x] Chave no SecretStorage em vez do
settings.json.
- [ ] Contexto cross-file: ler os imports do arquivo atual e enviar assinaturas de tipos/interfaces de arquivos locais abertos no workspace.
Licença
MIT
| |