Työhakemiston hallinta
Tällä sivulla
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.tomllatautuu 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ä
--workdirmahdollistaa hakemiston määrittämisen sinne siirtymättä- Yksi pääte projektia kohden on siistein lähestymistapa usean projektin työhön
- Projektikohtainen
.vibe/config.tomlmukauttaa toiminnan kullekin koodikannalle - Luotettujen kansioiden järjestelmä turvaa automaattisen hyväksynnän hakemistokohtaisesti
@:lla käytettävät suhteelliset polut ovat suositeltavia luettavuuden vuoksi