Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Controlo do Diretório de Trabalho

Aula 15 de 16 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. O Diretório de Lançamento Define o Projeto
  2. Trabalhar Noutro Local Sem Se Deslocar
  3. Organização de Trabalho com Múltiplos Projetos
  4. Pastas Confiáveis
  5. Referenciar Ficheiros e Alterar Diretórios Durante a Sessão
  6. Pontos-chave

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.toml do 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 -latest antes 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
  • --workdir permite-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.toml por 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