Súbor config.toml
Na tejto strane
Lekcia aktualizovaná 2. novembra 2026 na základe dokumentácie Vibe Code: integrovaný model Mistral Medium 3.5 (plus Devstral 2),
enable_update_checks(kľúčenable_auto_updateuž nemá žiadny účinok), nástrojedit(predtýmsearch_replace) a odstránená sekcia[safety]nahradená kľúčomdefault_agent. Zdroje: Configuration · Configuration reference.
Kde sa nachádza config.toml?
Vibe hľadá svoj konfiguračný súbor na dvoch miestach, v tomto poradí:
- Konfigurácia projektu:
./.vibe/config.toml(v aktuálnom adresári) - Globálna konfigurácia:
~/.vibe/config.toml(vo vašom domovskom adresári)
Konfigurácia projektu má prednosť pred globálnou konfiguráciou. Tento mechanizmus robí nástroj praktickým pre každodenný workflow vývojára: vaša globálna konfigurácia odráža vaše návyky, zatiaľ čo repozitár klienta presadzuje vlastné pravidlá vo svojom adresári bez toho, aby ste museli manuálne prepínať nastavenia.
Štruktúra súboru
Súbor config.toml používa formát TOML, čo je čitateľný a jednoznačný konfiguračný formát. Tu je úplný komentovaný príklad obsahujúci všetko, čo budete potrebovať:
# ~/.vibe/config.toml
# Aktívny model: vstavaný model alebo alias pre predvoľbu [[models]]
active_model = "mistral-medium-3.5"
# Predvolený agent (ak kľúč chýba, predvolená hodnota je accept-edits)
default_agent = "ask"
# Vlastný systémový prompt (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"
# Téma: auto sa prispôsobí terminálu; na výber použite /theme
theme = "auto"
# Denná kontrola nových verzií
enable_update_checks = true
Výber modelu
Parameter active_model určuje, ktorý model Vibe používa na generovanie. Očakáva alias: buď vstavaný model Mistral Medium 3.5, alebo alias pre predvoľbu [[models]], ktorú ste deklarovali (o tom bude reč v nasledujúcej lekcii).
active_model = "mistral-medium-3.5"
Nemusíte upravovať súbor, aby ste zmenili model: príkaz /model prepína modely uprostred relácie a zobrazuje zoznam dostupných možností. Súbor použite na nastavenie vašej predvolenej voľby a príkaz na jednorazové testy.
Prispôsobenie systémového promptu
Systémový prompt definuje správanie Vibe. Predvolene je nastavený tak, aby bol efektívnym asistentom pre kódovanie, ale môžete ho špecializovať. Toto je často nastavenie, ktoré prináša najviditeľnejší zisk: agent, ktorý vopred pozná vaše konvencie, prestane navrhovať kód, ktorý treba preformátovať.
Prompty sú súbory Markdown uložené v ~/.vibe/prompts/. Vytvorte si vlastný; tu je príklad pre tím pracujúci s Pythonom a FastAPI:
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
Potom naň odkážte v súbore config.toml pomocou názvu súboru bez prípony:
system_prompt_id = "mon_prompt"
Konfigurácia agentov
Agenty idú ďalej než samotné prompty: sú to kompletné konfiguračné profily, kde každý agent má svoj vlastný model, systémový prompt a povolenia nástrojov. Vytvárate ich v ~/.vibe/agents/. Najjasnejším príkladom je agent na kontrolu kódu:
# ~/.vibe/agents/code_review.toml
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]
[tools.bash]
permission = "never"
Spustite ho na požiadanie:
vibe --agent code_review
Tento agent môže iba čítať: nemôže zapisovať súbory ani vykonávať príkazy. Môžete mu teda umožniť skenovať vetvu kolegu bez obáv z náhodných úprav, čo z neho robí ideálny režim pre bezpečné kontroly kódu.
Kontrola nástrojov
Toto filtrovanie nástrojov platí aj pre hlavnú konfiguráciu. K dispozícii sú dva zoznamy: jeden na povolenie iba konkrétnych nástrojov a druhý na ich zakázanie:
# Povoliť iba konkrétne nástroje
enabled_tools = ["read_file", "grep", "edit"] # edit: predtým search_replace
# Zakázať konkrétne nástroje
disabled_tools = ["bash", "write_file"]
Ručné vypisovanie každého mena sa stáva zdĺhavým, keď server MCP vystavuje dvadsať nástrojov. Nástroje MCP sa nazývajú {server}_{tool} a filtre akceptujú wildcardy a regulárne výrazy (prefix re:). To vám umožňuje uvažovať podľa rodiny nástrojov, nie podľa jednotlivých kusov:
# Povoliť všetky nástroje zo servera MCP s názvom serena (vzor glob)
enabled_tools = ["serena_*"]
# ... alebo to isté pomocou regulárneho výrazu:
# enabled_tools = ["re:^serena_.*$"]
# Zakázať všetky nástroje zo servera MCP fetch_server
disabled_tools = ["fetch_server_*"]
Téma a umiestnenie konfigurácie
Tému nastavíte v tom istom súbore, alebo za behu pomocou príkazu /theme:
theme = "auto"
Dostupné témy sa líšia podľa verzie; použite /theme v interaktívnom režime, aby ste videli úplný zoznam a vyskúšali si každú možnosť predtým, než sa rozhodnete.
Nakoniec, Vibe ukladá svoju konfiguráciu predvolene do ~/.vibe/, ale toto umiestnenie môžete zmeniť pomocou premennej prostredia:
export VIBE_HOME="/chemin/vers/mon/dossier/vibe"
To je užitočné, ak sa váš domovský adresár nachádza na pomalom sieťovom disku, kde by každé čítanie konfigurácie spôsobovalo oneskorenie, alebo ak zdieľate konfiguráciu medzi viacerými strojmi prostredníctvom synchronizačnej služby.
Konfigurácia špecifická pre projekt
Vráťme sa k úvodnému scenáru: pre nastavenia špecifické pre projekt vytvorte .vibe/config.toml v koreňovom adresári projektu:
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 načíta tento súbor iba vtedy, ak ste priečinok pri prvom spustení deklarovali ako dôveryhodný. Ako preventívne opatrenie pred commitom: pridajte .vibe/ do vášho .gitignore, ak súbor obsahuje citlivé informácie, ako sú názvy premenných alebo interné URL adresy, ktoré nechcete tlačiť do repozitára.
Kľúčové poznatky
- config.toml existuje v globálnej (
~/.vibe/) aj projektovej (./.vibe/) verzii - Konfigurácia projektu má prednosť pred globálnou konfiguráciou
- Agenty sú kompletné profily s modelom, promptom a povoleniami; predvoleného agenta nastavíte pomocou
default_agent - Nástroje možno filtrovať pomocou wildcardov alebo regexov
- Premenná
VIBE_HOMEvám umožňuje zmeniť adresár konfigurácie