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ção | O que acontece | Quando usar |
|---|---|---|
Yes, for this session | Libera a pasta até você sair da sessão | Ajuste pontual em outro repositório |
Yes, and remember this directory | Libera agora e grava em .verboo/settings.local.json do projeto atual | Pasta que você sempre usa junto, como um pacote compartilhado |
No | Não libera nada | Digitou 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.
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:
| Mensagem | Causa | O que fazer |
|---|---|---|
Path ... was not found. | Caminho não existe, ou o seu usuário não tem permissão de leitura nele | Confira com ls -ld ../api |
... is not a directory. Did you mean to add the parent directory ...? | Você passou um arquivo | Passe a pasta que contém o arquivo |
... is already accessible within the existing working directory ... | A pasta já está dentro de um diretório liberado | Nada: o agente já alcança essa pasta |
Please provide a directory path. | Campo vazio | Digite 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.



