Controlul directorului de lucru
Pe această pagină
Lecție actualizată la 2 noiembrie 2026: Exemplele nu mai setează
active_model = "devstral-2"(Devstral a fost eliminat din API). Fără această cheie, proiectul utilizează modelul definit în configurația dumneavoastră de utilizator. Reamintire: un fișier.vibe/config.tomlde proiect se încarcă doar într-un dosar de încredere. Sursă: Configuration.
Actualizare din 2 noiembrie 2026 — Devstral. Devstral 2 (
devstral-2512) și-a atins sfârșitul ciclului de viață la 31 iulie 2026, iar Devstral Small 2 la 31 martie 2026: apelurile către aceste modele nu mai sunt garantate. Tabelul oficial de modele le redirecționează către Mistral Medium 3.5, care este la rândul său depreciat în favoarea Mistral Large 4. Codestral (codestral-2508) rămâne disponibil în general pentru completarea codului. Verificați tabelul de modele pentru a vedea unde indică aliasurile-latestînainte de a reutiliza aceste exemple.
Directorul de lansare definește proiectul
Când executați vibe, agentul adoptă directorul curent ca director de lucru. Această alegere contează: determină întregul context al proiectului, deoarece Vibe scanează arborele de directoare, citește fișierele de configurare și deduce tipul de proiect din această locație.
cd /home/user/projects/my-api
vibe
# → Vibe analizează proiectul my-api
Lansarea Vibe din directorul dumneavoastră home în loc de repository vă oferă un agent care nu înțelege codul dumneavoastră—not pentru că nu ar putea, ci pentru că privește în locul greșit. În practică, comanda cd face parte din instrucțiune.
Lucrul în altă parte fără deplasare
Uneori, comanda cd nu este posibilă sau convenabilă. Opțiunea --workdir desemnează explicit directorul țintă:
vibe --workdir /home/user/projects/my-api
Comportamentul este strict identic cu lansarea din acel dosar: scanarea proiectului, rezolvarea căilor fișierelor și comenzile shell utilizează toate acest director ca bază. Această opțiune este utilă pentru scripturile de automatizare în care nu controlați directorul curent, atunci când gestionați multiple proiecte fără a comuta terminalele și în pipeline-urile CI/CD pentru a indica un repository clonat recent. Cazul de utilizare prin script este cel mai ilustrativ, permițându-vă să procesați o serie de proiecte într-o buclă:
# Într-un script
for project in api frontend worker; do
vibe --workdir "/projects/$project" \
--prompt "Check for npm vulnerabilities" \
--output json > "audit-$project.json"
done
Organizarea lucrului cu multiple proiecte
În modul interactiv, cea mai curată abordare este un terminal—sau un panou tmux, sau o sesiune screen—per proiect:
# Terminal 1: Backend API
cd /projects/api-backend
vibe
# Terminal 2: Frontend
cd /projects/frontend-react
vibe
# Terminal 3: Infrastructură
cd /projects/infra-terraform
vibe
Fiecare instanță are astfel propriul context, sesiune și istoric, prevenind amestecarea raționamentelor Terraform cu logica React.
Această separare se extinde până la configurare. Plasarea unui fișier .vibe/config.toml în fiecare proiect adaptează comportamentul agentului la baza de cod specifică. Pentru un API Python:
# Proiect API Python
# /projects/api-backend/.vibe/config.toml
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "python_expert"
[tools.bash]
permission = "ask"
EOF
Și pentru un frontend React, adăugând un server MCP:
# Proiect 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
Regula de precedență este simplă: configurația de proiect (./.vibe/config.toml) suprascrie configurația globală (~/.vibe/config.toml). Fiecare repository își poate astfel impune propriul model, prompt de sistem și servere MCP fără a vă cere să schimbați nimic atunci când comutați între ele.
Dosare de încredere
Directorul de lucru determină, de asemenea, ce are voie Vibe să facă fără a vă întreba. Sistemul de dosare de încredere se bazează pe ~/.vibe/trusted_folders.toml, care listează locațiile unde anumite acțiuni automate—în special aprobarea automată—sunt permise.
# ~/.vibe/trusted_folders.toml
trusted = [
"/home/user/projects/my-api",
"/home/user/projects/frontend",
]
Dacă activați aprobarea automată într-un director care lipsește din această listă, Vibe vă avertizează că nu este considerat de încredere. Aceasta este exact măsura de siguranță dorită atunci când clonați un repository necunoscut pentru a ajuta un coleg.
Referențierea fișierelor și schimbarea directoarelor în timpul sesiunii
În conversațiile dumneavoastră, @ acceptă atât căi relative la directorul de lucru, cât și căi absolute, cu autocompletare funcțională în ambele cazuri.
# Cale relativă (recomandat)
Explain the code in @src/api/routes.ts
# Cale absolută
Explain the code in @/home/user/projects/my-api/src/api/routes.ts
Preferați căile relative: acestea se citesc mai bine și rămân valabile indiferent de utilizator sau mașină, lucru important atunci când partajați un prompt cu un coleg.
În final, nimic nu vă împiedică să navigați în altă parte în timpul unei sesiuni folosind o comandă shell:
!cd /other/project && ls
Totuși, trebuie să știți ce obțineți: contextul proiectului din scanarea inițială rămâne legat de directorul de lansare, iar Vibe nu rescanează automat noul dosar. Agentul va vedea fișierele listate, dar va raționa tot pe baza arhitecturii proiectului original. Pentru o comutare reală a contextului, deschideți o nouă sesiune.
Puncte cheie
- Vibe utilizează directorul curent ca context de proiect la lansare
--workdirvă permite să specificați un director fără a naviga către el- Un terminal per proiect este cea mai curată abordare pentru lucrul cu multiple proiecte
- Fișierul
.vibe/config.tomlper proiect personalizează comportamentul pentru fiecare bază de cod - Sistemul de dosare de încredere securizează aprobarea automată pe bază de director
- Căile relative cu @ sunt recomandate pentru lizibilitate