Skip to content
| Marketplace
Sign in
Visual Studio Code>Programming Languages>IAutocompleteNew to Visual Studio Code? Get it now.
IAutocomplete

IAutocomplete

Preview

Nthiago_Dev

|
1 install
| (0) | Free
Autocomplete inline (ghost text) e mensagens de commit com Gemini, e refatoração agêntica com o Claude Code CLI.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

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

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft