Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Datoteka config.toml

Lekcija 6 od 16 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Gdje se nalazi config.toml?
  2. Struktura datoteke
  3. Odabir modela
  4. Prilagodba sistemskog prompta
  5. Konfiguriranje agenata
  6. Kontrola alata
  7. Tema i lokacija konfiguracije
  8. Konfiguracija specifična za projekt
  9. Ključne točke

Lekcija ažurirana 2. studenog 2026. na temelju dokumentacije za Vibe Code: integriran model Mistral Medium 3.5 (uz Devstral 2), enable_update_checks (ključ enable_auto_update više nema učinka), alat edit (ranije search_replace) te uklonjeni odjeljak [safety] zamijenjen s default_agent. Izvori: Konfiguracija · Referenca za konfiguraciju.

Gdje se nalazi config.toml?

Vibe traži svoju konfiguracijsku datoteku na dva mjesta, sljedećim redoslijedom:

  1. Konfiguracija projekta: ./.vibe/config.toml (u trenutnom direktoriju)
  2. Globalna konfiguracija: ~/.vibe/config.toml (u tvom kućnom direktoriju)

Konfiguracija projekta ima prednost nad globalnom konfiguracijom. Taj mehanizam čini alat praktičnim za svakodnevni rad programera: tvoja globalna konfiguracija odražava tvoje navike, dok repozitorij klijenta nameće vlastita pravila unutar svog direktorija bez potrebe da ručno mijenjaš postavke.

Struktura datoteke

Datoteka config.toml koristi TOML format, čitljiv i nedvosmislen format za konfiguraciju. Evo potpunog primjera s komentarima koji sadrži sve što ćeš trebati:

# ~/.vibe/config.toml

# Aktivni model: ugrađeni model ili alias za unaprijed postavljenu vrijednost [[models]]
active_model = "mistral-medium-3.5"

# Zadani agent (ako ključ nedostaje, prihvaća se "ask")
default_agent = "ask"

# Prilagođeni sistemski prompt (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"

# Tema: automatski prati terminal; upotrijebi /theme za odabir
theme = "auto"

# Dnevna provjera novih verzija
enable_update_checks = true

Odabir modela

Parametar active_model određuje koji model Vibe koristi za generiranje. Očekuje alias: ili ugrađeni model, Mistral Medium 3.5, ili alias za unaprijed postavljenu vrijednost [[models]] koju si deklarirao (obradit ćemo u sljedećoj lekciji).

active_model = "mistral-medium-3.5"

Ne moraš uređivati datoteku da bi promijenio modele: naredba /model mijenja modele usred sesije i prikazuje popis dostupnih opcija. Upotrijebi datoteku za postavljanje zadanog izbora, a naredbu za jednokratna testiranja.

Prilagodba sistemskog prompta

Sistemski prompt definira ponašanje Vibea. Zadano je konfiguriran kao učinkovit asistent za kodiranje, ali ga možeš specijalizirati. To je često postavka koja donosi najvidljiviji napredak: agent koji unaprijed poznaje tvoje konvencije prestaje predlagati kod koji treba preoblikovati.

Promptovi su Markdown datoteke pohranjene u ~/.vibe/prompts/. Stvori vlastiti; evo primjera za tim koji radi s Pythonom i FastAPIjem:

mkdir -p ~/.vibe/prompts
cat > ~/.vibe/prompts/mon_prompt.md << 'EOF'
Tu es un assistant de développement spécialisé en Python et FastAPI.
Tu écris du code propre, typé, avec des docstrings.
Tu privilégies les approches fonctionnelles quand c'est possible.
Tu réponds toujours en français.
EOF

Zatim ga referenciraj u config.toml koristeći ime datoteke bez ekstenzije:

system_prompt_id = "mon_prompt"

Konfiguriranje agenata

Agenti idu dalje od samih promptova: oni su potpuni konfiguracijski profili gdje svaki agent ima svoj model, sistemski prompt i dopuštenja za alate. Stvaraš ih u ~/.vibe/agents/. Najjasniji primjer je agent za pregled koda:

# ~/.vibe/agents/code_review.toml

system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]

[tools.bash]
permission = "never"

Pokreni ga po potrebi:

vibe --agent code_review

Ovaj agent može samo čitati: ne može pisati datoteke niti izvršavati naredbe. Stoga mu možeš dopustiti skeniranje grane kolege bez straha od slučajnih izmjena, što ga čini idealnim načinom rada za sigurne preglede koda.

Kontrola alata

Ovo filtriranje alata vrijedi i za glavnu konfiguraciju. Dostupna su dva popisa: jedan za dopuštanje samo određenih alata, a drugi za njihovo zabranjivanje:

# Omogući samo određene alate
enabled_tools = ["read_file", "grep", "edit"]   # edit: ranije search_replace

# Onemogući određene alate
disabled_tools = ["bash", "write_file"]

Ručno tipkanje svakog imena postaje zamorno kada MCP poslužitelj izlaže dvadeset alata. MCP alati imaju imena {server}_{tool}, a filtri prihvaćaju zamjenske znakove i regularne izraze (prefiks re:). To ti omogućuje razmišljanje po obiteljima, a ne po pojedinačnim alatima:

# Omogući sve alate s MCP poslužitelja pod nazivom serena (glob uzorak)
enabled_tools = ["serena_*"]
# ... ili isto s regularnim izrazom:
# enabled_tools = ["re:^serena_.*$"]

# Onemogući sve alate s MCP poslužitelja fetch_server
disabled_tools = ["fetch_server_*"]

Tema i lokacija konfiguracije

Postavi temu u istoj datoteci ili dinamički putem naredbe /theme:

theme = "auto"

Dostupne teme ovise o verziji; upotrijebi /theme u interaktivnom načinu rada da vidiš cijeli popis i pregledaš svaku opciju prije nego što se odlučiš za izbor.

Konačno, Vibe zadano pohranjuje svoju konfiguraciju u ~/.vibe/, ali tu lokaciju možeš promijeniti putem varijable okruženja:

export VIBE_HOME="/chemin/vers/mon/dossier/vibe"

To je korisno ako se tvoj kućni direktorij nalazi na sporom mrežnom disku gdje bi svako čitanje konfiguracije uzrokovalo kašnjenje, ili ako dijeliš konfiguraciju između više strojeva putem usluge sinkronizacije.

Konfiguracija specifična za projekt

Vraćajući se na uvodni scenarij: za postavke specifične za projekt, stvori .vibe/config.toml u korijenu projekta:

mkdir -p .vibe
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "python_expert"

[tools.bash]
permission = "ask"
allowlist = ["git status", "git diff", "pytest"]
EOF

Vibe učitava ovu datoteku samo ako si mapu proglasio pouzdanom (trusted) pri prvom pokretanju. Kao mjera opreza prije commita: dodaj .vibe/ u svoj .gitignore ako datoteka sadrži osjetljive informacije, poput imena varijabli ili internih URL-ova koje ne želiš gurati u repozitorij.

Ključne točke

  • config.toml postoji u globalnoj (~/.vibe/) i projektnoj (./.vibe/) verziji
  • Konfiguracija projekta ima prednost nad globalnom konfiguracijom
  • Agenti su potpuni profili s modelom, promptom i dopuštenjima; zadani agent postavi s default_agent
  • Alati se mogu filtrirati korištenjem zamjenskih znakova ili regexa
  • Varijabla VIBE_HOME omogućuje promjenu direktorija konfiguracije