Devin-Cli Chat for VS Code

Painel de chat nativo para o Devin CLI dentro do VS Code, com interface no idioma do VS Code quando disponível.
Suporte a modelos, agentes, skills, anexos, histórico e contexto automático do editor.

Pré-requisito: Devin CLI

Esta extensão é uma interface gráfica para o Devin CLI — o CLI precisa estar instalado e acessível no PATH da sua máquina antes de usar a extensão.

Verifique a instalação abrindo o terminal e executando:

devin --version

Para instalar o Devin CLI, consulte a documentação oficial do Devin.
Se o executável não estiver no PATH, configure o caminho completo em devinCliChat.caminhoDevin (ex.: /usr/local/bin/devin).

Instalação da extensão

Via Marketplace (recomendado):
Pesquise Devin-Cli Chat for VS Code no VS Code Marketplace e clique em Install.

Contorno para erro de instalação pelo Marketplace

Em alguns ambientes corporativos, o VS Code pode falhar ao instalar pelo Marketplace com erro semelhante a:

End of central directory record signature not found. Either not a zip file, or file is truncated.

Quando isso acontecer, instale pela linha de comando usando o VSIX do Marketplace ou do GitHub:

code --install-extension lferrarezi.devin-cli-chat-vscode --force

Se o erro persistir, baixe o arquivo .vsix da página de releases e instale localmente:

code --install-extension devin-cli-chat-1.11.0.vsix --force

Via VSIX (manual):

1. Baixe o VSIX da página de releases.
2. No VS Code: Ctrl+Shift+P → Extensions: Install from VSIX… → selecione o arquivo.
3. Recarregue a janela (Ctrl+Shift+P → Developer: Reload Window).

Uso rápido

1. Abra uma pasta no VS Code.
2. Clique no ícone Devin Cli Chat na Activity Bar.
3. Escolha modelo, agente, modo e skills quando necessário.
4. Digite uma mensagem e pressione Enter ou o botão Enviar.

Funcionalidades

• Chat integrado: executa devin -p e exibe a resposta no painel, sem sair do VS Code.
• Integração com o seletor de agentes: o Devin CLI aparece como opção no seletor "Abrir em Agentes" do VSCodium / VS Code ao lado do GitHub Copilot CLI e do Claude, via vscode.lm.registerLanguageModelChatProvider.
• Contexto automático do editor: inclui automaticamente a seleção ativa ou o arquivo aberto no prompt enviado ao CLI.
• Modelos: auto, sonnet, opus, swe, gpt, codex, adaptive.
• Agentes e skills: scan automático de .devin/agents e .devin/skills (workspace e global).
• Anexos: arquivos, seleção do editor, pastas do workspace.
• Histórico de sessões: salvar, carregar, excluir e limpar.
• Cancelamento: botão × no compositor durante execuções longas.
• Diagnóstico: botão i no cabeçalho verifica o Devin CLI sem sair do painel.

Seletor de agentes (VSCodium / VS Code)

A partir da v1.13.1, a extensão registra o Devin CLI como Language Model Provider do VS Code.
Isso faz o Devin CLI aparecer no seletor "Abrir em Agentes" ao lado do GitHub Copilot CLI e do Claude.

O modelo exibido no seletor (ex.: Devin CLI (sonnet)) reflete o modelo atualmente configurado em devinCliChat.modeloAtual. Alterar o modelo no painel do Devin atualiza o seletor automaticamente.

Requer VS Code / VSCodium ≥ 1.113. Em versões anteriores, o seletor não aparece, mas o painel de chat da extensão continua funcionando normalmente.

Configurações principais

{
  "devinCliChat.caminhoDevin": "devin",
  "devinCliChat.modeloAtual": "auto",
  "devinCliChat.modoExecucaoChat": "resposta-integrada",
  "devinCliChat.agenteAtual": "auto",
  "devinCliChat.prefixoPromptPadrao": "",
  "devinCliChat.usarBypass": false
}

Modelos válidos

Use auto para deixar o Devin CLI escolher o modelo padrão — a extensão não envia --model.
Aliases aceitos: sonnet, opus, swe, gpt, codex, adaptive.
Valores inválidos são convertidos para auto automaticamente.

Diretórios de agentes e skills

Modo Bypass

O checkbox Bypass no composer habilita --permission-mode dangerous no Devin CLI. Use apenas em workspaces confiáveis.

Contexto automático do editor

Quando habilitado, o chat inclui automaticamente a seleção ativa ou, se não houver seleção, o arquivo aberto como contexto da pergunta. Se houver anexos manuais, o contexto automático é omitido para evitar duplicidade.

Uma referência compacta aparece na bolha do usuário: 📄 Contexto automático: arquivo.ts:10-25.

Log de diagnóstico

View → Output → selecione Devin Cli Chat para ver logs em tempo real.
Ou execute Devin Cli Chat: Verificar Devin CLI na Command Palette — o Output abre automaticamente.

Solução de problemas

Devin CLI não encontrado

1. Verifique: abra o terminal integrado e execute devin --version.
2. Se não estiver no PATH, configure devinCliChat.caminhoDevin com o caminho completo (ex.: /usr/local/bin/devin).
3. No Windows com Git Bash, configure devinCliChat.gitBashPath ou habilite devinCliChat.usarGitBashNoWindows.
4. Execute Devin Cli Chat: Verificar Devin CLI na Command Palette para diagnóstico automático.

Painel abre, mas botões não respondem

1. Abra Developer: Toggle Developer Tools (Ctrl+Shift+I) e verifique a aba Console.
2. Verifique View → Output → Devin Cli Chat por erros do host.
3. Reinstale com --force: code --install-extension devin-cli-chat-X.Y.Z.vsix --force.
4. Execute Developer: Reload Window.
5. Se persistir, abra uma issue com o log.

Modelo não reconhecido

1. Use auto — a extensão não envia --model e o Devin CLI usa o padrão local.
2. Execute Devin Cli Chat: Atualizar modelos para redescobrir modelos disponíveis.
3. Use Devin Cli Chat: Definir modelo manual para inserir um alias fora da lista padrão.
4. Verifique se o alias é aceito com devin model set <alias> no terminal.

Resposta não aparece no chat

1. Aguarde o timeout (padrão 5 min) ou aumente devinCliChat.timeoutChatMs.
2. Verifique View → Output → Devin Cli Chat por erros de execução.

Anexos não funcionam

1. Arquivos > 1 MB são ignorados — use pastas com arquivos menores.
2. Diretórios como node_modules, .git, dist, build são excluídos automaticamente.
3. É necessário ter uma pasta aberta no VS Code para o browser de workspace funcionar.

Segurança

Esta extensão executa o Devin CLI localmente e não coleta dados. Arquivos anexados são incluídos no prompt enviado ao CLI — revise antes de enviar conteúdo sensível.

Consulte SECURITY.md para detalhes sobre CSP, logging, execução do CLI e modelo de ameaças.

Desenvolvimento

Pré-requisitos

• Node.js 18+
• VS Code 1.92+
• Devin CLI instalado e acessível no PATH

Setup

cd Vscode
npm install

Comandos

Testar em desenvolvimento

1. Abra a pasta Vscode/ no VS Code.
2. Pressione F5 — abre uma janela de extensão de desenvolvimento.
3. Ou instale o VSIX gerado: npm run package → instale via UI.

Estrutura relevante

Vscode/
├── src/extension.ts   # código-fonte principal
├── out/extension.js   # saída compilada (versionada no repo)
├── media/             # ícones
├── package.json       # manifest da extensão
└── tsconfig.json      # configuração TypeScript

Versão atual: 1.0.1

Veja o CHANGELOG para histórico completo.