Skip to main content
Devin trabalha dentro de um snapshot persistente de ambiente. Cada sessão começa inicializando uma cópia nova desse snapshot, então quanto mais completa for sua configuração, menos tempo Devin perde instalando ferramentas. O novo fluxo de configuração de repositórios foi projetado para ser rápido e com pouco atrito:
  • Configure repositórios sem abrir o VS Code (sem bloquear o snapshot)
  • Adicione vários repositórios de uma só vez
  • Sugestões de IA + verificação executadas de forma assíncrona

​
Antes de começar: conceda acesso aos repositórios

Certifique-se de que o Devin possa ler os repositórios desejados.
Precisa de ajuda com as permissões? Consulte o Guia de Integração com o GitHub.

​
Adicionar repositórios (um ou mais)

Vá para Settings > Devin’s Environment > Repositories.
  1. Clique em Add repository
  2. Selecione um ou mais repositórios que você quer configurar
  3. Clique em Manage setup
Pronto — você será levado para a tela de configuração, com os repositórios selecionados listados à esquerda. Você também pode fazer clone em massa de vários repositórios de uma vez, selecionando-os na lista de repositórios e clicando na ação “Clone repositories”, o que é útil ao integrar muitos repositórios simultaneamente.
Ao adicionar um repositório, as são iniciadas em segundo plano. Você não precisa esperar que elas terminem para continuar configurando.

​
Configurar cada repositório (configuração leve)

Escolha um repositório na barra lateral esquerda. Cada repositório tem três seções:
1

Clonar repositório

Clonar adiciona o repositório ao ambiente, deixando-o disponível em sessões futuras em ~/repos/.
  • Se você quer que o Devin trabalhe ativamente no repositório: clone-o
  • Se você só está configurando comandos para depois: você pode deixá-lo sem clonar por enquanto
2

Manutenção

Esses comandos são executados automaticamente para manter o Devin sincronizado.
  • Git pull: é executado durante a inicialização da sessão (o padrão geralmente está correto)
  • Maintain dependencies: opcional, mas recomendado (por exemplo, npm ci, pip install -r requirements.txt, uv sync, etc.)
Use Verify para fazer uma verificação rápida de um comando individual ou Verify All para executar tudo.
A verificação é executada de forma assíncrona — você pode trocar de repositório ou sair da página enquanto ela é concluída.
3

Knowledge

Aqui é onde você ensina o Devin a verificar a qualidade do trabalho.
  • Configure o lint (rápido, idealmente ≤ 5 minutos)
  • Configure os testes (rápido, idealmente ≤ 5 minutos)
  • Adicione quaisquer observações específicas do repositório que o Devin deve seguir (como executar o app, scripts especiais, etc.)
Se sugestões de IA estiverem disponíveis, você verá um card com Accept / Reject. Ao aceitar, os comandos comuns (lint/testes/etc.) serão preenchidos automaticamente com base no seu repositório.
Dê preferência a um único comando de “ponto de entrada”, como make lint / make test, se você tiver. É a configuração mais robusta.

​
Sugestões de IA

Devin pode propor comandos de configuração específicos do repositório (lint, testes, manutenção de dependências e comandos comuns de execução). Essas sugestões são assíncronas e não bloqueiam o fluxo — elas existem para poupar digitação, não para atrapalhar o seu ritmo. Ciclo de vida
  1. Assim que você começar a configurar um repositório, Devin inicia automaticamente a geração de sugestões de IA em segundo plano.
  2. As sugestões podem demorar, dependendo do tamanho e da complexidade do repositório. Você pode continuar configurando outros campos ou trocar de repositório enquanto elas estão sendo geradas.
  3. Quando as sugestões estiverem prontas, elas aparecerão em linha ao lado de cada campo de comando relevante, com botões Aceitar / Rejeitar. Ao aceitar, o comando é preenchido automaticamente; ao rejeitar, sua configuração permanece inalterada.
  4. Se o seu repositório mudou ou as sugestões deixaram algo passar, abra o menu ⋯ no canto superior direito e clique em “Regenerar sugestões”.

​
Configurar o ambiente (apenas quando necessário)

A configuração do repositório é basicamente campos de texto + verificação. Você só precisa abrir a máquina quando realmente quiser:
  • instalar ferramentas (compiladores, gerenciadores de pacotes, CLIs)
  • fazer login em sites de que o Devin precisa (aba do Browser)
  • criar arquivos locais como .envrc ou .env
Clique em Environment Setup na barra lateral esquerda e, em seguida:
  1. (Opcional) ajuste a Upkeep Frequency (com que frequência o Devin executa tarefas de manutenção para manter o ambiente atualizado)
  2. Clique em Open VSCode + Browser
A partir deste ponto, o Devin bloqueia o ambiente para garantir a consistência das suas alterações. Dentro do VS Code integrado:
  • execute suas etapas de bootstrap/instalação no terminal
  • confirme que ~/repos/<repo> existe e que as builds/testes são executados
  • use o prompt Setup Agent se quiser ajuda de IA para criar os comandos de instalação corretos
Quando terminar, clique em Save para salvar as alterações.
Tudo o que você instalar aqui se torna parte do ambiente compartilhado e pode afetar outros repositórios. Se você precisar de isolamento, prefira ambientes virtuais ou contêineres por repositório.

​
O que o Devin fará em cada sessão

Depois de configurado:
  • Devin inicia uma nova sessão a partir do snapshot mais recente do seu ambiente
  • Ao iniciar, Devin executa:
    • o comando git pull do repositório
    • depois Maintain dependencies (se fornecido)
  • Antes de fazer o commit, Devin executa:
    • seus comandos de lint
    • seus comandos de teste
Se você quer a configuração mais simples que ainda funciona bem:
  1. Mantenha o comando padrão de git pull
  2. Defina Maintain dependencies como um único comando (por exemplo, npm ci / uv sync / pip install -r requirements.txt)
  3. Pegue um café. Está pronto!

​
Resolução de problemas

​
A verificação falhou, mas aqui funciona

A maioria dessas falhas se deve a um destes motivos:
  • Diretório de trabalho errado → use cd ~/repos/<repo> && …
  • Ferramenta não está no PATH → adicione-a ao PATH no arquivo de configuração do seu shell (ou use caminhos absolutos)
  • Dependências ausentes → instale-as durante o Environment Setup e então execute a verificação novamente
  • Versão da linguagem incorreta → certifique-se de que a versão está selecionada em shells não interativos (ao abrir um terminal novo)

​
Estraguei o snapshot do meu ambiente

Você pode restaurar uma imagem anterior em Settings → Devin’s Environment → Version History.

​
Precisa editar isso depois?

Volte para Settings → Devin’s Environment → Repositories.
  • Adicione mais repositórios a qualquer momento
  • Selecione repositórios e clique em Configure para revisar a configuração
  • Use Version History se precisar desfazer alterações

​
Tudo pronto

Quando seus repositórios e ambiente estiverem configurados, você poderá iniciar uma sessão. Se tiver qualquer dificuldade, entre em contato com support@cognition.ai.