> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin Local

> Use o agente local do Devin no Devin Desktop: a infraestrutura de agente da Devin CLI, com subagentes, sandboxing, modo de planejamento, worktrees e permissões.

Devin Local é a nossa infraestrutura de agente de última geração, compartilhada com o [Devin CLI](https://cli.devin.ai).

Ele é executado na sua máquina, com acesso aos seus arquivos locais, ferramentas e ambiente, e é o principal agente local do Devin Desktop.

> [card] [Modos](https://docs.devinenterprise.com/pt-BR/desktop/devin-local/modes.md)
>
> Code, Inteligente, Ask, Plan e Bypass Permissions, e como planejar antes de implementar.

> [card] [Personalizações](https://docs.devinenterprise.com/pt-BR/desktop/devin-local/customizations.md)
>
> Plugins, habilidades, servidores MCP, hooks e regras, além da interface que mostra o que uma sessão carregou.

> [card] [Permissões](https://docs.devinenterprise.com/pt-BR/desktop/devin-local/permissions.md)
>
> Regras de permitir, ask e negar, requisições de aprovação e permissões de ferramentas MCP.

> [card] [Worktrees](https://docs.devinenterprise.com/pt-BR/desktop/devin-local/worktrees.md)
>
> Execute uma sessão em um worktree do git e faça o merge das alterações de volta no seu workspace.

## Principais recursos

### Eficiência no uso de tokens

O agente local do Devin foi projetado com base em cache de prompts, por isso a maioria das tarefas consome menos tokens para chegar ao mesmo resultado.

### Subagentes

O agente local do Devin pode iniciar [subagentes](https://docs.devinenterprise.com/pt-BR/cli/subagents.md) independentes para cuidar de subtarefas, em primeiro ou em segundo plano. Os subagentes compartilham as ferramentas e o contexto da base de código com o agente principal, mas operam em sua própria cadeia de conversa.

Os subagentes são ativados pelo controle **Subagents (Preview)** em `Devin Settings`.

Além dos perfis integrados, você pode definir seus próprios subagentes como arquivos markdown em `agents/`, usando uma das seguintes estruturas:

* **Arquivo simples** — `agents/<name>.md`, em que o nome do arquivo passa a ser o identificador do perfil.
* **Diretório** — `agents/<name>/AGENT.md`, em que o nome do diretório passa a ser o identificador do perfil.

Consulte a [documentação de subagentes](https://docs.devinenterprise.com/pt-BR/cli/subagents.md) para saber onde esses diretórios são detectados e como configurar um perfil.

### Sandboxing

O agente local do Devin oferece suporte a isolamento em sandbox no nível do SO. Quando ativado, o sandbox impõe:

* **Isolamento do sistema de arquivos** — os caminhos com permissão de escrita são derivados dos seus [escopos de permissão](https://docs.devinenterprise.com/pt-BR/desktop/devin-local/permissions.md), e as regras de negação `Read(...)` ocultam caminhos dos comandos executados no sandbox
* **Filtragem de rede** — listas de permissões e listas de bloqueio de domínios controlam o que o agente pode acessar

Os admins do Enterprise podem impor o comportamento do sandbox em toda a organização nas [configurações da equipe](https://cli.devin.ai/docs/enterprise/team-settings#sandbox-enforcement), inclusive exigindo o modo sandbox para todos os usuários e configurando regras de filtragem de domínios para toda a organização.

### Quick Review

O [Quick Review](https://docs.devinenterprise.com/pt-BR/desktop/quick-review.md) é um subagente dedicado, disponível no agente local do Devin, para obter feedback rápido sobre suas alterações.

## Como trocar de agente

Novas abas começam com o Devin Local quando você ainda não escolheu um agente preferido. Se o Devin Local não estiver disponível para você, a aba usa o primeiro [agente ACP](https://docs.devinenterprise.com/pt-BR/desktop/acp.md) selecionável. Se nenhum agente estiver disponível, ela exibe a UI padrão de nova aba e aguarda até que algum fique disponível. Você pode trocar o agente das *novas* conversas a qualquer momento pelo seletor de agente no canto inferior direito do Devin Desktop. O Devin Local pode ser selecionado mesmo enquanto ainda está se conectando.

![](https://mintcdn.com/cognitionai-enterprise/GYcs1r0Vcxr5GSpj/desktop/assets/windsurf/devin-local-agent-switcher.png?fit=max\&auto=format\&n=GYcs1r0Vcxr5GSpj\&q=85\&s=1cad3484e17401835dd3315895bd5edd)

### Configurações do agente

Se o Devin Local não aparecer no seletor de agente, talvez seja necessário ativá-lo em `Devin Settings`:

1. Abra a paleta de comandos com `Cmd+Shift+P` (macOS) ou `Ctrl+Shift+P` (Windows/Linux)
2. Abra `Devin User Settings`
3. Clique na aba "Agents"
4. Ative o controle do agente "Devin Local"
5. Reinicie o Devin Desktop

![](https://mintcdn.com/cognitionai-enterprise/GYcs1r0Vcxr5GSpj/desktop/assets/windsurf/devin-local-agent-settings.png?fit=max\&auto=format\&n=GYcs1r0Vcxr5GSpj\&q=85\&s=620d7ea9aafb29cb923dc685fd729df5)

### Admins do Enterprise

O Devin Local é um agente integrado que o Devin Desktop obtém do servidor. A exibição dele no seletor de agente é controlada pela configuração de equipe **Devin Local Agent**:

* Nos planos **Team** e em outros planos não Enterprise, ele fica disponível por padrão (a menos que um membro específico tenha esse acesso desativado).
* Nos planos **Enterprise**, ele vem ativado por padrão, e um administrador pode desativá-lo para os membros.

Os admins do Enterprise gerenciam isso no painel de configurações da equipe:

* **Admins do Devin Enterprise** — **Settings → Enterprise → Devin Desktop** (`app.devin.ai/org/{orgName}/settings/desktop`). Em **Features**, use o controle **Devin Local Agent** ("Allow members to use the Devin Local agent in Devin Desktop and delegate tasks to Devin's terminal agent via ACP").
* **Admins do Windsurf Enterprise** — no [painel do Windsurf](https://windsurf.com/team/settings).

Com essa configuração ativada, o Devin Local aparece no seletor de agente para todos os membros depois que eles reiniciarem o Devin Desktop. Não é necessária nenhuma configuração por usuário nem uma [configuração personalizada do registro ACP](https://docs.devinenterprise.com/pt-BR/desktop/acp.md#team-registry-configuration).

## Modo Restrito

Quando um workspace está aberto no **Modo Restrito**, os agentes ficam indisponíveis nele: o Devin Local e todos os [agentes ACP](https://docs.devinenterprise.com/pt-BR/desktop/acp.md) são desativados, e os [hooks](https://docs.devinenterprise.com/pt-BR/desktop/devin-local/customizations.md#hooks) não são carregados nem executados.

Os agentes voltam a ficar disponíveis assim que o workspace sai do Modo Restrito.

## Compartilhamento de conversas

No Devin Desktop, escolha **Share conversation** no menu de ações abaixo de um turno concluído; no Devin CLI ou em outro cliente ACP, execute `/share`. O agente importa um transcript higienizado (com segredos ocultados e prompts de sistema e definições de ferramentas removidos) e retorna um link para compartilhar com sua equipe. O compartilhamento só é oferecido quando sua organização permite o compartilhamento de conversas, você está conectado com uma conta do Devin (não uma conta somente Windsurf) e o cliente oferece suporte ao compartilhamento.

## Análises

A atividade do Devin Local é registrada na fonte de dados [`cascade_runs`](https://docs.devinenterprise.com/pt-BR/desktop/accounts/api-reference/cascade-analytics) (uso do modelo, mensagens enviadas e consumo de créditos), na fonte de dados [`cascade_tool_usage`](https://docs.devinenterprise.com/pt-BR/desktop/accounts/api-reference/cascade-analytics) (número de chamadas por ferramenta, como Code Edit, Run Command, Search Web e MCP Tool), na fonte de dados [`cascade_lines`](https://docs.devinenterprise.com/pt-BR/desktop/accounts/api-reference/cascade-analytics) (linhas diárias de código escritas pelo agente) e na [fonte de dados Cascade](https://docs.devinenterprise.com/pt-BR/desktop/accounts/analytics-api#cascade-data) da API Custom Analytics.

O Devin Local não rastreia linhas sugeridas nem "modos": 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](https://devin.ai/blog/self-hosted-deployment-maintenance-mode).

## Controles do Enterprise

Os admins do Enterprise podem configurar o agente Devin Local por meio das [Configurações da equipe](https://windsurf.com/team/settings), incluindo [novos controles disponíveis apenas com o agente Devin Local](https://cli.devin.ai/docs/enterprise/team-settings):

* **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

O controle de compartilhamento de conversas da organização é respeitado: quando o compartilhamento está desativado para a organização, o agente Devin Local não oferece **Share conversation** nem `/share`.

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

Os seguintes controles do Enterprise legados não estão disponíveis com o agente Devin Local:

* **Restringir chamadas de ferramenta ao workspace** - por padrão, o agente Devin Local só pode ler/editar arquivos dentro do workspace.
  [Permissões](https://cli.devin.ai/docs/reference/permissions) personalizadas oferecem uma alternativa mais flexível para replicar as mesmas regras.
* **Chamadas de ferramenta globais desativadas** - se você desativou anteriormente as chamadas de ferramenta por completo, crie uma [política de permissões](https://cli.devin.ai/docs/reference/permissions) 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](https://cli.devin.ai/docs/reference/permissions) 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](https://cli.devin.ai/docs/reference/permissions) equivalente para o Devin CLI para permitir comandos específicos do terminal.
* **Listas de bloqueio do terminal** - implemente uma [política de permissões](https://cli.devin.ai/docs/reference/permissions) equivalente para o Devin CLI para bloquear comandos específicos do terminal.

## Leitura complementar

* [Início rápido do Devin CLI](https://cli.devin.ai/docs)
* [Comandos essenciais](https://cli.devin.ai/docs/essential-commands)
* [Visão geral da extensibilidade](https://cli.devin.ai/docs/extensibility)
* [Configurações da equipe](https://cli.devin.ai/docs/enterprise/team-settings)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.