Devin Local é nossa infraestrutura de agente de próxima geração, compartilhada com o Devin CLI.
Ele é executado na sua máquina, com acesso aos seus arquivos, ferramentas e ambiente locais, e é o principal agente local do Devin Desktop.
Usava o Cascade anteriormente? Execute o comando Devin: Open Cascade Migration Wizard na Paleta de Comandos para migrar seus fluxos de trabalho e memórias em um único fluxo guiado.
Devin Settings.
Além dos perfis nativos, você pode definir seus próprios subagentes como arquivos Markdown em agents/ usando qualquer um dos layouts:
- Arquivo simples —
agents/<name>.md, em que o nome do arquivo se torna o identificador do perfil.
- Diretório —
agents/<name>/AGENT.md, em que o nome do diretório se torna o identificador do perfil.
Consulte a documentação sobre subagentes para saber onde esses diretórios são encontrados e como configurar um perfil.
O agente local do Devin oferece suporte a sandbox em nível de sistema operacional. Quando ativado, o sandbox aplica:
- Isolamento do sistema de arquivos — os caminhos com permissão de escrita são definidos com base nos seus escopos de permissão, e regras de bloqueio
Read(...) ocultam caminhos de comandos em sandbox
- Filtragem de rede — listas de permissões e listas de bloqueio de domínios controlam o que o agente pode acessar
Admins do Enterprise podem impor o comportamento do sandbox em toda a organização por meio das Configurações da equipe, incluindo exigir o modo sandbox para todos os usuários e configurar regras de filtragem de domínios em toda a organização.
Revisão rápida é um subagente dedicado disponível no agente local do Devin para obter feedback rápido sobre alterações.
Novas abas começam com Devin Local quando você não escolheu um agente preferido (usando o Cascade como alternativa caso o Devin Local não esteja disponível para você). Você pode mudar o agente para novas conversas a qualquer momento usando o seletor de agentes no canto inferior direito do Devin Desktop — o Devin Local pode ser selecionado mesmo enquanto ainda está se conectando.
Se o Devin Local não aparecer no seletor de agentes, talvez seja necessário ativá-lo nas Devin Settings:
- Abra a Paleta de Comandos com
Cmd+Shift+P (macOS) ou Ctrl+Shift+P (Windows/Linux)
- Abra
Devin User Settings
- Clique na aba “Agents”
- Ative o agente “Devin Local”
- Reinicie o Devin Desktop
Você também pode optar por desativar totalmente o Cascade com a configuração devin.cascade.enabled.
O Devin Local é um agente incluído que o Devin Desktop baixa do servidor. A exibição dele no seletor de agentes é controlada pela configuração de equipe Agente Local do Devin:
- Nos planos Team e outros planos não Enterprise, ele fica disponível por padrão (a menos que esse acesso esteja desativado para um membro específico).
- Nos planos Enterprise, ele é restrito, então um admin precisa ativá-lo para os membros.
Os admins do Enterprise gerenciam isso no painel de configurações da equipe:
- Admins do Devin Enterprise — Configurações → Enterprise → Windsurf (
app.devin.ai/org/{orgName}/settings/windsurf). Em Recursos, ative Agente Local do Devin (“Permitir que os membros usem o agente local do Devin no Devin Desktop e deleguem tarefas ao agente de terminal do Devin via ACP”).
- Admins do Windsurf Enterprise — o painel do Windsurf.
Depois de ativado, o Devin Local aparece no seletor de agentes para todos os membros após reiniciarem o Devin Desktop — nenhuma configuração por usuário nem configuração personalizada do registro ACP é necessária.
O Devin Local tem seus próprios modos, separados dos modos do Cascade. Como compartilha a infraestrutura de agente com o Devin CLI, usa os mesmos modos de agente (Normal, Plan e Ask) e os mesmos modos de permissão. Consulte os comandos essenciais para conhecer o conjunto completo de modos e os comandos de barra que alternam entre eles.
O modo Plan é voltado à pesquisa somente leitura: o agente investiga seu codebase, define uma abordagem e solicita sua aprovação antes de implementar qualquer alteração.
O plano é gravado em um arquivo Markdown persistente em ~/.devin/plans/plan-<session>.md, para que você possa editá-lo, retomá-lo mais tarde ou passá-lo para uma nova sessão.
Inclua a palavra-chave megaplan (ultraplan e masterplan também funcionam) no seu prompt para colocar a sessão no modo Plan e fazer com que o agente planeje de forma muito mais detalhada — ele faz pelo menos uma pergunta de esclarecimento antes de escrever o plano.
- Nova worktree — o Devin Desktop cria uma nova worktree para a sessão.
- Worktree existente — selecione uma worktree já existente no submenu Local do seletor.
Quando o agente concluir, clique em Merge na sessão para trazer as alterações da worktree de volta ao seu workspace.
As worktrees são compartilhadas com as sessões do Cascade, incluindo a localização em disco e o comportamento de limpeza — consulte worktrees. Plugins, neste contexto, são plugins de agente do Devin: pacotes instaláveis que adicionam skills, rules, hooks, servidores MCP e subagentes ao agente. Consulte plugins.Eles não têm relação com os Plugins do Windsurf, que levam o Devin ao JetBrains, VS Code e outros editores, nem com as extensões do editor instaladas no Devin Desktop — ambos ampliam a IDE, não o agente.
- As regras Deny bloqueiam completamente as ações (maior prioridade)
- As regras Ask sempre solicitam aprovação
- As regras Allow aprovam automaticamente as ações sem solicitar confirmação
As permissões podem ser definidas para leitura de arquivos, gravação de arquivos, execução de comandos, requisições HTTP e ferramentas MCP. Elas podem ser configuradas no nível do projeto, do usuário ou da organização. Consulte permissões para ver a sintaxe das regras.
As regras de permissão escritas com globs (por exemplo, Read(**/*.pem)) correspondem a todos os diretórios do workspace na sessão, incluindo diretórios adicionados após seu início.
Como responder a solicitações de permissão
- Editar o comando — clique no comando no cartão para alterá-lo antes de aprová-lo. A ação da varinha permite descrever a alteração desejada em linguagem simples e usa um modelo rápido para reescrever o comando para sua revisão.
- Atalhos de teclado — aprove, permita sempre ou rejeite uma requisição sem usar o mouse. As dicas de atalho são exibidas nos botões e nas opções do menu suspenso.
- Concessões para toda a sessão — uma aprovação concedida para a sessão se aplica a todas as requisições posteriores nessa sessão, para que o agente principal e seus subagentes não solicitem novamente um escopo que você já concedeu.
Ao contrário do Cascade, a configuração padrão do agente local do Devin solicita aprovação antes de usar qualquer ferramenta MCP. Quando o agente quiser invocar uma ferramenta MCP, você pode permitir a ferramenta específica ou todas as ferramentas desse servidor MCP, apenas para a sessão atual ou de forma permanente.
Admins do Enterprise podem permitir, por padrão, servidores MCP ou ferramentas específicos para que integrações confiáveis não peçam aprovação sempre. Consulte permissões baseadas em ferramentas para saber como configurar essas regras.
Quando as credenciais OAuth armazenadas de um servidor expiram, ele exibe o status Requer autenticação na lista de MCP do Devin Local, no cartão do marketplace e na página de detalhes do servidor.
Clique em Autenticar para limpar as credenciais armazenadas e executar novamente o fluxo de autorização no navegador.
Configuração do servidor MCP
- Memories — O agente Devin Local não mantém memórias entre sessões. Migre suas memórias críticas para skills com o comando Devin: Open Cascade Migration Wizard.
- Workflows — Workflows não estão disponíveis com o agente Devin Local. Migre seus workflows para skills com o comando Devin: Open Cascade Migration Wizard.
- Code Lenses - Atualmente, code lenses ainda não acionam o agente Devin Local.
- implantação de app - O agente Devin Local não oferece suporte à implantação de app.
- Compartilhamento de conversas - O compartilhamento de conversas ainda não está disponível com o agente Devin Local.
O agente Devin Local oferece suporte a regras e arquivos AGENTS.md, além de skills, para fornecer contexto persistente e workflows reutilizáveis.
A atividade do Devin Local é registrada na fonte de dados cascade_runs (uso do modelo, mensagens enviadas e consumo de créditos), na fonte de dados cascade_tool_usage (número de chamadas por ferramenta, como Code Edit, Run Command, Search Web e MCP Tool), na fonte de dados cascade_lines (linhas diárias de código escritas pelo agente) e na fonte de dados Cascade da API Custom Analytics.
Diferentemente do Cascade, o Devin Local não rastreia linhas sugeridas específicas nem “modos” durante a operação: uma edição só é executada após sua aprovação; portanto, as linhas aceitas são iguais às linhas sugeridas, e o campo mode em cascade_runs não é preenchido.
O Devin CLI não registra análises para implantações híbridas.
Os admins do Enterprise podem configurar o agente Devin Local por meio das Configurações da equipe, incluindo novos controles disponíveis apenas com o agente Devin Local:
- Imposição do sandbox - Exija o modo sandbox para todos os usuários e configure regras de filtragem de domínios para toda a organização
- Permissões granulares - Controle quais ações o agente pode executar com permissões mais refinadas
- Imposição de rede - Controle o acesso à rede com domínios permitidos e bloqueados
Além disso, o controle “Enable Cascade” pode ser usado para desativar completamente o agente legado Cascade e garantir que sua equipe siga os novos controles disponíveis no Devin CLI.
Controles do Enterprise sem suporte
- Restringir chamadas de ferramenta ao workspace - por padrão, o agente Devin Local só pode ler/editar arquivos dentro do workspace.
Permissões personalizadas oferecem uma alternativa mais flexível para replicar as mesmas regras.
- Implantações de app - implantações de app ainda não são compatíveis com o agente Devin Local.
- Compartilhamento de conversas - o compartilhamento de conversas ainda não é compatível com o agente Devin Local.
- Chamadas de ferramenta globais desativadas - se você desativou anteriormente as chamadas de ferramenta por completo, crie uma política de permissões equivalente para o Devin CLI.
Os seguintes controles legados ainda serão aplicados como fallback se você ainda não tiver implementado uma configuração de permissões do CLI do Enterprise:
- Executar comandos do terminal automaticamente - o agente Devin Local usa seu próprio modelo de permissões em vez de níveis de execução automática; recomendamos usar esse modelo, mas o controle antigo ainda será aplicado como fallback.
- Listas de permissões do terminal - implemente uma política de permissões equivalente para o Devin CLI para permitir comandos específicos do terminal.
- Listas de bloqueio do terminal - implemente uma política de permissões equivalente para o Devin CLI para bloquear comandos específicos do terminal.
