Controlo do Diretório de Trabalho
Nesta página
Lição atualizada em 2 de novembro de 2026: Os exemplos já não definem
active_model = "devstral-2"(o Devstral foi removido da API). Sem esta chave, o projeto utiliza o modelo definido na sua configuração de utilizador. Lembrete: um ficheiro.vibe/config.tomldo projeto só é carregado dentro de uma pasta confiável. Fonte: Configuração.
Atualização de 2 de novembro de 2026 — Devstral. O Devstral 2 (
devstral-2512) chegou ao fim da vida útil a 31 de julho de 2026, e o Devstral Small 2 a 31 de março de 2026: as chamadas a estes modelos já não estão garantidas. A tabela oficial de modelos redireciona-os para o Mistral Medium 3.5, que está, por sua vez, obsoleto em favor do Mistral Large 4. O Codestral (codestral-2508) mantém-se geralmente disponível para conclusão de código. Consulte a tabela de modelos para verificar para onde apontam os aliases-latestantes de reutilizar estes exemplos.
O Diretório de Lançamento Define o Projeto
Quando executa vibe, o agente adota o diretório atual como seu diretório de trabalho. Esta escolha é importante: determina todo o contexto do projeto, uma vez que o Vibe analisa a árvore de diretórios, lê ficheiros de configuração e infere o tipo de projeto a partir desta localização.
cd /home/user/projects/my-api
vibe
# → O Vibe analisa o projeto my-api
Lançar o Vibe a partir do seu diretório pessoal em vez do repositório resulta num agente que não compreende o seu código — não porque não consiga, mas porque está a procurar no local errado. Na prática, o cd faz parte do comando.
Trabalhar Noutro Local Sem Se Deslocar
Por vezes, o cd não é possível ou conveniente. A opção --workdir designa explicitamente o diretório de destino:
vibe --workdir /home/user/projects/my-api
O comportamento é estritamente idêntico ao lançamento a partir dessa pasta: a análise do projeto, a resolução de caminhos de ficheiros e os comandos de shell utilizam todos este diretório como base. Esta opção é útil para scripts de automação onde não controla o diretório atual, ao gerir múltiplos projetos sem mudar de terminal e em pipelines de CI/CD para apontar para um repositório recém-clonado. O caso de uso de script é o mais ilustrativo, permitindo-lhe processar uma série de projetos num ciclo:
# Num script
for project in api frontend worker; do
vibe --workdir "/projects/$project" \
--prompt "Check for npm vulnerabilities" \
--output json > "audit-$project.json"
done
Organização de Trabalho com Múltiplos Projetos
No modo interativo, a abordagem mais limpa é um terminal — ou painel tmux, ou sessão screen — por projeto:
# Terminal 1: Backend API
cd /projects/api-backend
vibe
# Terminal 2: Frontend
cd /projects/frontend-react
vibe
# Terminal 3: Infraestrutura
cd /projects/infra-terraform
vibe
Cada instância tem então o seu próprio contexto, sessão e histórico, impedindo que misture o raciocínio do Terraform com a lógica do React.
Esta separação estende-se até à configuração. Colocar um ficheiro .vibe/config.toml em cada projeto adapta o comportamento do agente à base de código específica. Para uma API Python:
# Projeto de API Python
# /projects/api-backend/.vibe/config.toml
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "python_expert"
[tools.bash]
permission = "ask"
EOF
E para um frontend React, adicionando um servidor MCP:
# Projeto de Frontend React
# /projects/frontend-react/.vibe/config.toml
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "react_expert"
[[mcp_servers]]
name = "fetch"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]
EOF
A regra de precedência é simples de recordar: a configuração do projeto (./.vibe/config.toml) substitui a configuração global (~/.vibe/config.toml). Cada repositório pode, assim, impor o seu próprio modelo, prompt de sistema e servidores MCP sem que tenha de alterar nada ao alternar entre eles.
Pastas Confiáveis
O diretório de trabalho também determina o que o Vibe tem permissão para fazer sem lhe perguntar. O sistema de pastas confiáveis baseia-se em ~/.vibe/trusted_folders.toml, que lista locais onde certas ações automáticas — em particular a aprovação automática — são permitidas.
# ~/.vibe/trusted_folders.toml
trusted = [
"/home/user/projects/my-api",
"/home/user/projects/frontend",
]
Se ativar a aprovação automática num diretório que não consta desta lista, o Vibe avisa-o de que não é considerado confiável. Esta é exatamente a salvaguarda que deseja ao clonar um repositório desconhecido para ajudar um colega.
Referenciar Ficheiros e Alterar Diretórios Durante a Sessão
Nas suas conversas, o @ aceita tanto caminhos relativos ao diretório de trabalho como caminhos absolutos, funcionando o preenchimento automático em ambos os casos.
# Caminho relativo (recomendado)
Explain the code in @src/api/routes.ts
# Caminho absoluto
Explain the code in @/home/user/projects/my-api/src/api/routes.ts
Prefira caminhos relativos: são mais legíveis e permanecem válidos independentemente do utilizador ou da máquina, o que é importante ao partilhar um prompt com um colega.
Finalmente, nada o impede de navegar para outro local durante uma sessão utilizando um comando de shell:
!cd /other/project && ls
No entanto, saiba o que obtém: o contexto do projeto da análise inicial permanece ligado ao diretório de lançamento, e o Vibe não volta a analisar automaticamente a nova pasta. O agente verá os ficheiros listados, mas continuará a raciocinar com base na arquitetura original do projeto. Para uma verdadeira mudança de contexto, abra uma nova sessão.
Pontos-chave
- O Vibe utiliza o diretório atual como contexto do projeto no lançamento
--workdirpermite-lhe especificar um diretório sem navegar até ele- Um terminal por projeto é a abordagem mais limpa para trabalho com múltiplos projetos
- O ficheiro
.vibe/config.tomlpor projeto personaliza o comportamento para cada base de código - O sistema de Pastas Confiáveis garante a aprovação automática por diretório
- Caminhos relativos com @ são recomendados para legibilidade