Controllare la directory di lavoro
In questa pagina
Lezione aggiornata il 2 novembre 2026: gli esempi non impostano più
active_model = "devstral-2"(Devstral è stato rimosso dalle API). Senza questa chiave, il progetto utilizza il modello definito nella tua configurazione utente. Promemoria: un file.vibe/config.tomldi progetto viene caricato solo all’interno di una cartella attendibile. Fonte: Configuration.
Aggiornamento del 2 novembre 2026 — Devstral. Devstral 2 (
devstral-2512) ha raggiunto la fine del supporto il 31 luglio 2026 e Devstral Small 2 il 31 marzo 2026: le chiamate a questi modelli non sono più garantite. La tabella ufficiale dei modelli li reindirizza a Mistral Medium 3.5, che è a sua volta deprecato a favore di Mistral Large 4. Codestral (codestral-2508) rimane generalmente disponibile per il completamento del codice. Controlla la tabella dei modelli per vedere dove puntano gli alias-latestprima di riutilizzare questi esempi.
La directory di avvio definisce il progetto
Quando esegui vibe, l’agente adotta la directory corrente come directory di lavoro. Questa scelta è cruciale: determina l’intero contesto del progetto, poiché Vibe analizza l’albero delle directory, legge i file di configurazione e deduce il tipo di progetto da questa posizione.
cd /home/user/projects/my-api
vibe
# → Vibe analizza il progetto my-api
Avviare Vibe dalla tua home directory invece che dal repository ti fornisce un agente che non comprende il tuo codice, non perché ne sia incapace, ma perché sta cercando nel posto sbagliato. In pratica, il comando cd fa parte dell’operazione.
Lavorare altrove senza spostarsi
A volte usare cd non è possibile o conveniente. L’opzione --workdir designa esplicitamente la directory di destinazione:
vibe --workdir /home/user/projects/my-api
Il comportamento è strettamente identico all’avvio da quella cartella: la scansione del progetto, la risoluzione dei percorsi dei file e i comandi shell utilizzano tutti questa directory come base. Questa opzione è utile per script di automazione in cui non controlli la directory corrente, quando gestisci più progetti senza cambiare terminale e nelle pipeline CI/CD per puntare a un repository appena clonato. Il caso d’uso dello script è il più illustrativo, poiché ti permette di elaborare una serie di progetti in un ciclo:
# In uno script
for project in api frontend worker; do
vibe --workdir "/projects/$project" \
--prompt "Check for npm vulnerabilities" \
--output json > "audit-$project.json"
done
Organizzare il lavoro su più progetti
In modalità interattiva, l’approccio più pulito consiste nell’avere un terminale (o un pannello tmux, o una sessione screen) per progetto:
# Terminale 1: Backend API
cd /projects/api-backend
vibe
# Terminale 2: Frontend
cd /projects/frontend-react
vibe
# Terminale 3: Infrastruttura
cd /projects/infra-terraform
vibe
Ogni istanza ha quindi il proprio contesto, la propria sessione e la propria cronologia, impedendoti di mescolare il ragionamento su Terraform con la logica React.
Questa separazione si estende fino alla configurazione. Posizionare un file .vibe/config.toml in ogni progetto adatta il comportamento dell’agente allo specifico codebase. Per un’API Python:
# Progetto API Python
# /projects/api-backend/.vibe/config.toml
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "python_expert"
[tools.bash]
permission = "ask"
EOF
E per un frontend React, aggiungendo un server MCP:
# Progetto 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
La regola di precedenza è semplice da ricordare: la configurazione di progetto (./.vibe/config.toml) sovrascrive la configurazione globale (~/.vibe/config.toml). Ogni repository può quindi imporre il proprio modello, il proprio prompt di sistema e i propri server MCP senza richiederti di modificare nulla quando passi dall’uno all’altro.
Cartelle attendibili
La directory di lavoro determina anche cosa Vibe è autorizzato a fare senza chiederti conferma. Il sistema delle cartelle attendibili si basa su ~/.vibe/trusted_folders.toml, che elenca le posizioni in cui sono consentite determinate azioni automatiche, in particolare l’approvazione automatica.
# ~/.vibe/trusted_folders.toml
trusted = [
"/home/user/projects/my-api",
"/home/user/projects/frontend",
]
Se abiliti l’approvazione automatica in una directory mancante da questo elenco, Vibe ti avvisa che non è considerata attendibile. Questa è esattamente la salvaguardia che desideri quando cloni un repository sconosciuto per aiutare un collega.
Riferire file e cambiare directory durante una sessione
Nelle tue conversazioni, @ accetta sia percorsi relativi alla directory di lavoro sia percorsi assoluti, con il completamento automatico funzionante in entrambi i casi.
# Percorso relativo (consigliato)
Explain the code in @src/api/routes.ts
# Percorso assoluto
Explain the code in @/home/user/projects/my-api/src/api/routes.ts
Preferisci i percorsi relativi: sono più leggibili e rimangono validi indipendentemente dall’utente o dalla macchina, il che è importante quando condividi un prompt con un collega.
Infine, nulla ti impedisce di navigare altrove durante una sessione utilizzando un comando shell:
!cd /other/project && ls
Tuttavia, sappi cosa ottieni: il contesto del progetto dalla scansione iniziale rimane legato alla directory di avvio e Vibe non esegue nuovamente la scansione automatica della nuova cartella. L’agente vedrà i file elencati, ma continuerà a ragionare basandosi sull’architettura del progetto originale. Per un vero cambio di contesto, apri una nuova sessione.
Punti chiave
- Vibe utilizza la directory corrente come contesto del progetto all’avvio
--workdirti permette di specificare una directory senza doverci navigare- Un terminale per progetto è l’approccio più pulito per lavorare su più progetti
- Il file
.vibe/config.tomlper progetto personalizza il comportamento per ogni codebase - Il sistema delle cartelle attendibili protegge l’approvazione automatica su base directory
- I percorsi relativi con @ sono consigliati per la leggibilità