Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Työhakemiston hallinta

Oppitunti 15 / 16 Päivitetty 2. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Käynnistyshakemisto määrittää projektin
  2. Työskentely muualla siirtymättä
  3. Usean projektin työn järjestäminen
  4. Luotetut kansiot
  5. Tiedostoihin viittaaminen ja hakemiston vaihtaminen istunnon aikana
  6. Keskeiset asiat

Oppitunti päivitetty 2. marraskuuta 2026: Esimerkit eivät enää aseta arvoa active_model = "devstral-2" (Devstral on poistettu rajapinnasta). Ilman tätä avainta projekti käyttää käyttäjäasetuksissasi määriteltyä mallia. Muista: projektin .vibe/config.toml latautuu vain luotetussa kansiossa. Lähde: Configuration.

2. marraskuuta 2026 päivitys — Devstral. Devstral 2 (devstral-2512) saavutti elinkaarensa pään 31. heinäkuuta 2026 ja Devstral Small 2 31. maaliskuuta 2026: näihin malleihin tehtyjä kutsuja ei enää taata. Virallinen mallitaulukko ohjaa ne Mistral Medium 3.5:een, joka on itsekin vanhentunut Mistral Large 4:n hyväksi. Codestral (codestral-2508) on edelleen yleisesti saatavilla koodin täydennykseen. Tarkista mallitaulukosta, mihin -latest-aliakset osoittavat, ennen kuin käytät näitä esimerkkejä uudelleen.

Käynnistyshakemisto määrittää projektin

Kun suoritat komennon vibe, agentti ottaa nykyisen hakemiston työhakemistokseen. Tämä valinta on merkittävä: se määrittää koko projektikontekstin, sillä Vibe skannaa hakemistopuun, lukee asetustiedostot ja päättelee projektityypin tämän sijainnin perusteella.

cd /home/user/projects/my-api
vibe
# → Vibe analysoi my-api-projektia

Jos käynnistät Viben kotihakemistostasi repositorion sijaan, saat agentin, joka ei ymmärrä koodiasi – ei siksi, etteikö se pystyisi, vaan siksi, että se etsii väärästä paikasta. Käytännössä cd on osa komentoa.

Työskentely muualla siirtymättä

Joskus cd ei ole mahdollinen tai kätevä. Valitsin --workdir määrittää kohdehakemiston eksplisiittisesti:

vibe --workdir /home/user/projects/my-api

Toiminta on täysin identtinen kuin kyseisestä kansiosta käynnistettäessä: projektin skannaus, tiedostopolkujen ratkaisu ja shell-komennot käyttävät tätä hakemistoa pohjana. Tämä valitsin on hyödyllinen automaatiokomentosarjoissa, joissa et hallitse nykyistä hakemistoa, kun pyörität useita projekteja vaihtamatta päätettä, sekä CI/CD-putkissa osoittamaan vastikään kloonattu repositorio. Komentosarjakäyttö on havainnollisin esimerkki, sillä se mahdollistaa useiden projektien käsittelyn silmukassa:

# Komentosarjassa
for project in api frontend worker; do
  vibe --workdir "/projects/$project" \
       --prompt "Check for npm vulnerabilities" \
       --output json > "audit-$project.json"
done

Usean projektin työn järjestäminen

Vuorovaikutteisessa tilassa siistein lähestymistapa on yksi pääte – tai tmux-ruutu tai screen-istunto – projektia kohden:

# Pääte 1: Backend-API
cd /projects/api-backend
vibe

# Pääte 2: Frontend
cd /projects/frontend-react
vibe

# Pääte 3: Infrastruktuuri
cd /projects/infra-terraform
vibe

Jokaisella instanssilla on tällöin oma kontekstinsa, istuntonsa ja historiansa, mikä estää Terraform-päättelyn sekoittumisen React-logiikkaan.

Tämä erottelu ulottuu myös asetuksiin. Sijoittamalla .vibe/config.toml-tiedoston jokaiseen projektiin mukautat agentin toiminnan kyseiseen koodikantaan. Python-API:lle:

# Python-API-projekti
# /projects/api-backend/.vibe/config.toml
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "python_expert"

[tools.bash]
permission = "ask"
EOF

Ja React-frontendille, lisäten MCP-palvelimen:

# React-Frontend-projekti
# /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

Ensisijaisuussääntö on helppo muistaa: projektikohtaiset asetukset (./.vibe/config.toml) ohittavat globaalit asetukset (~/.vibe/config.toml). Näin jokainen repositorio voi pakottaa oman mallinsa, järjestelmäkehotteensa ja MCP-palvelimensa ilman, että sinun tarvitsee muuttaa mitään niiden välillä liikkuessasi.

Luotetut kansiot

Työhakemisto määrittää myös sen, mitä Vibe saa tehdä kysymättä sinulta. Luotettujen kansioiden järjestelmä perustuu tiedostoon ~/.vibe/trusted_folders.toml, joka luettelee sijainnit, joissa tietyt automaattiset toiminnot – erityisesti automaattinen hyväksyntä – ovat sallittuja.

# ~/.vibe/trusted_folders.toml
trusted = [
  "/home/user/projects/my-api",
  "/home/user/projects/frontend",
]

Jos otat automaattisen hyväksynnän käyttöön hakemistossa, jota ei ole tässä listassa, Vibe varoittaa, ettei sitä pidetä luotettuna. Tämä on juuri se suojamekanismi, jonka haluat olevan käytössä, kun kloonaat tuntemattoman repositorion auttaaksesi kollegaa.

Tiedostoihin viittaaminen ja hakemiston vaihtaminen istunnon aikana

Keskusteluissasi @ hyväksyy sekä työhakemistoon suhteutettuja polkuja että absoluuttisia polkuja, ja automaattinen täydennys toimii molemmissa tapauksissa.

# Suhteellinen polku (suositeltu)
Explain the code in @src/api/routes.ts

# Absoluuttinen polku
Explain the code in @/home/user/projects/my-api/src/api/routes.ts

Suosi suhteellisia polkuja: ne ovat luettavampia ja pysyvät voimassa käyttäjästä tai koneesta riippumatta, mikä on tärkeää jaettaessa kehote kollegan kanssa.

Lopuksi, mikään ei estä sinua siirtymästä muualle istunnon aikana shell-komennolla:

!cd /other/project && ls

Tiedä kuitenkin, mitä saat: alkuperäisestä skannauksesta peräisin oleva projektikonteksti pysyy sidottuna käynnistyshakemistoon, eikä Vibe skannaa uutta kansiota automaattisesti uudelleen. Agentti näkee luetellut tiedostot, mutta päättely perustuu edelleen alkuperäiseen projektirakenteeseen. Todellista kontekstin vaihtoa varten avaa uusi istunto.

Keskeiset asiat

  • Vibe käyttää nykyistä hakemistoa projektikontekstina käynnistyshetkellä
  • --workdir mahdollistaa hakemiston määrittämisen sinne siirtymättä
  • Yksi pääte projektia kohden on siistein lähestymistapa usean projektin työhön
  • Projektikohtainen .vibe/config.toml mukauttaa toiminnan kullekin koodikannalle
  • Luotettujen kansioiden järjestelmä turvaa automaattisen hyväksynnän hakemistokohtaisesti
  • @:lla käytettävät suhteelliset polut ovat suositeltavia luettavuuden vuoksi