Verboo Code: como dar acesso a outra pasta com /add-dir
Voltar para o Blog
Artigoverboo codetutorialdev toolshow toagente de programação

Verboo Code: como dar acesso a outra pasta com /add-dir

Mafra22 de outubro de 20264 min de leitura

Você abriu a sessão no frontend e pediu para o agente ajustar a chamada de API. O problema é que o endpoint mora em outro repositório, uma pasta acima, e o agente não alcança. O /add-dir da Verboo Code resolve isso: ele libera uma pasta extra para a sessão, sem precisar fechar tudo e abrir de novo num diretório pai.

O que o /add-dir faz na Verboo Code?

Adiciona uma pasta à lista de diretórios de trabalho da sessão. A partir daí, as ferramentas de leitura e edição de arquivo passam a valer também para ela, e a configuração do sandbox é atualizada na hora para que comandos de terminal enxerguem a pasta nova.

Por padrão, a Verboo Code só mexe no diretório onde você iniciou a sessão. Isso é proposital: limita o raio de ação do agente. O /add-dir é a forma explícita de ampliar esse limite, uma pasta por vez.

Como liberar outra pasta, passo a passo?

Dentro da sessão, passe o caminho da pasta. Vale caminho relativo, absoluto ou com ~:

/add-dir ../api

A CLI confere se o caminho existe e se é um diretório. Se estiver tudo certo, abre o diálogo Add directory to workspace com três opções:

OpçãoO que aconteceQuando usar
Yes, for this sessionLibera a pasta até você sair da sessãoAjuste pontual em outro repositório
Yes, and remember this directoryLibera agora e grava em .verboo/settings.local.json do projeto atualPasta que você sempre usa junto, como um pacote compartilhado
NoNão libera nadaDigitou o caminho errado

Confirmado, a resposta é Added /home/voce/projetos/api as a working directory for this session · /permissions to manage. Sem argumento, /add-dir abre um campo para digitar o caminho, com Tab para completar.

Fluxograma do /add-dir na Verboo Code: /add-dir ../api valida se a pasta existe e é diretório, Yes, for this session libera só até sair, /permissions na aba Workspace lista e remove; para manter sempre, Yes, and remember grava additionalDirectories em .verboo/settings.local.json, fora do git
O /add-dir valida o caminho e pergunta se a liberação vale só para a sessão ou fica salva no projeto.

Como abrir a sessão já com as pastas liberadas?

Use a flag --add-dir ao iniciar. Ela aceita mais de uma pasta:

verboo --add-dir ../api ../shared

Para não digitar isso toda vez, a opção Yes, and remember this directory grava a pasta no arquivo de configuração local do projeto. Você também pode escrever direto:

// .verboo/settings.local.json
{
  "permissions": {
    "additionalDirectories": ["/home/voce/projetos/api"]
  }
}

Quando a própria CLI grava esse arquivo, ela adiciona .verboo/settings.local.json ao .gitignore, então o caminho da sua máquina não vai parar no repositório. Se o time inteiro precisa da mesma pasta vizinha, a mesma chave funciona em .verboo/settings.json, que é o arquivo compartilhado.

Por que o /add-dir recusa a pasta?

Quase sempre é uma destas quatro mensagens. Elas vêm literais do código da CLI:

MensagemCausaO que fazer
Path ... was not found.Caminho não existe, ou o seu usuário não tem permissão de leitura neleConfira com ls -ld ../api
... is not a directory. Did you mean to add the parent directory ...?Você passou um arquivoPasse a pasta que contém o arquivo
... is already accessible within the existing working directory ...A pasta já está dentro de um diretório liberadoNada: o agente já alcança essa pasta
Please provide a directory path.Campo vazioDigite o caminho

A terceira confunde bastante: subpasta do projeto atual nunca precisa de /add-dir. O comando serve para o que está fora da árvore onde a sessão começou.

Armadilha: liberar a pasta não faz o agente ler as regras dela. O AGENTS.md do repositório vizinho fica de fora por padrão. O agente pode editar os arquivos de lá sem conhecer as convenções que você escreveu para aquele projeto. Para carregar as instruções das pastas extras, ligue a variável de ambiente ao iniciar:

CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 verboo --add-dir ../api

Com ela, a CLI lê da pasta extra o AGENTS.md (ou CLAUDE.md, se não houver AGENTS.md), o .claude/CLAUDE.md e os arquivos de .claude/rules/. Aceita 1, true, yes ou on. Mais sobre esses arquivos no tutorial de /memory e AGENTS.md.

Como ver e remover as pastas liberadas?

Abra o /permissions e vá até a aba Workspace. Ela lista o diretório original, marcado como (Original working directory), e cada pasta extra. Dali você remove uma pasta ou adiciona outra pela opção Add directory….

/permissions

A mesma tela controla quais comandos o agente roda sem pedir confirmação. Se ainda não configurou isso, o tutorial de /permissions mostra as regras de liberar e bloquear.

Com duas ou três pastas liberadas, o agente lê mais arquivo por pedido, porque precisa entender os dois lados antes de mudar a interface entre eles. Na Verboo Code os planos rodam com token ilimitado, então abrir o backend junto com o frontend não pesa na conta.

Gostou deste artigo?
Compartilhe conhecimento com sua rede.
// Leia também

Artigos relacionados