Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Controllare la directory di lavoro

Lezione 15 di 16 Aggiornata il 2 novembre 2026 Sviluppatore
In questa pagina
  1. La directory di avvio definisce il progetto
  2. Lavorare altrove senza spostarsi
  3. Organizzare il lavoro su più progetti
  4. Cartelle attendibili
  5. Riferire file e cambiare directory durante una sessione
  6. Punti chiave

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.toml di 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 -latest prima 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
  • --workdir ti 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.toml per 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à