Pular para o conteúdo principal

Instalar a extensão do VS Code

A extensão Imaginne traz o agente para dentro do editor: chat, edições propostas com diff, revisão de código e mais. Ela não executa o agente sozinha — usa o CLI imaginne local por baixo dos panos.

Pré-requisito: o CLI imaginne

A extensão sobe o processo imaginne serve por baixo, então o binário imaginne precisa estar instalado na sua máquina. Instale o CLI primeiro (veja Instalar a TUI):

curl -fsSL https://ai.nnumbers.com.br/downloads/install.sh | bash
Inspecionar antes de executar

Executar um script direto da rede significa confiar nele sem ver o que faz. Em máquina corporativa, ou sob política de segurança, prefira as duas etapas:

# 1. Baixe o instalador
curl -fsSL https://ai.nnumbers.com.br/downloads/install.sh -o install-imaginne.sh

# 2. Leia o que ele vai fazer
less install-imaginne.sh

# 3. Execute
bash install-imaginne.sh

O instalador não usa sudo: ele escreve apenas em ~/.imaginne/. Se algum passo pedir elevação de privilégio, interrompa e procure a equipe que administra o Imaginne na sua organização.

:::

Você também precisa do VS Code ^1.85 (ou mais recente) e de uma conta na sua organização. Veja Identidade & login.

1. Instalar a extensão​

  1. No VS Code, abra a aba Extensões (Ctrl/Cmd+Shift+X).
  2. Procure por Imaginne (ID nnumbers.imaginne).
  3. Clique em Install.

A extensão ativa-se ao terminar a inicialização do editor (onStartupFinished).

Canal DEV

Para o ambiente de validação, instale a extensão nnumbers.imaginne-dev e aponte o CLI DEV correspondente. Veja os canais.

2. Abrir uma pasta de projeto​

A extensão precisa de um workspace aberto — uma pasta de projeto. Use Arquivo → Abrir Pasta… antes de continuar. Sem uma pasta aberta, o chat e as ações de contexto ficam indisponíveis.

3. Fazer login​

Autentique-se de uma das formas:

  • Pelo comando: abra a paleta (Ctrl/Cmd+Shift+P) e rode Imaginne: Login.
  • Pelo chat: rode /login no campo de mensagem.

O navegador abre na página de login da organização; ao concluir, o editor recebe o token de sessão e o repassa ao Engine local. Para sair, use Imaginne: Logout; para conferir a identidade, Imaginne: Whoami.

"cloud API key is required for model nnumbers"

Se você vir esse erro, o token de login ainda não chegou ao Engine. Rode Imaginne: Login (ou /login) novamente. Mais casos em Solução de problemas.

4. Configurações úteis​

Abra Configurações (Ctrl/Cmd+,) e procure por imaginne. As mais importantes na instalação:

ConfiguraçãoPara quê
imaginne.binaryPathCaminho do CLI imaginne, caso ele não esteja no PATH do VS Code.
imaginne.platformUrlURL da Platform, para ambientes específicos.
O CLI não foi encontrado?

Se a extensão não localizar o imaginne, defina imaginne.binaryPath com o caminho completo do binário (por padrão, algo como ~/.imaginne/bin/imaginne). A extensão também oferece o comando Imaginne: Configure Binary Path para isso. Em caso de "Engine disconnected", rode Imaginne: Run Health Check.

A extensão tem dezenas de outras configurações (contexto inteligente, autonomia, allowlist de comandos). A referência completa está em Comandos do VS Code.

5. Abrir o chat​

Abra o painel de chat com Ctrl/Cmd+Shift+I. Para colocar o foco direto no campo de mensagem, use Ctrl/Cmd+Shift+L.

Digite um pedido — por exemplo, "explique este arquivo" ou selecione um trecho e use Imaginne: Fix Selection. As edições propostas pelo agente entram no painel de Proposed Changes, onde você revisa com diff antes de aplicar. Veja tudo em Usar no VS Code.

Veja também​

Usar no VS Code

Chat, contexto, Proposed Changes, revisão e modos de autonomia.

Abrir →Comandos do VS Code

Comandos, atalhos e configurações.

Abrir →Revisão de código

Revisar mudanças, corrigir e gerar a mensagem de commit.

Abrir →