Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Súbor config.toml

Lekcia 6 z 16 Aktualizované 2. novembra 2026 Vývojár
Na tejto strane
  1. Kde sa nachádza config.toml?
  2. Štruktúra súboru
  3. Výber modelu
  4. Prispôsobenie systémového promptu
  5. Konfigurácia agentov
  6. Kontrola nástrojov
  7. Téma a umiestnenie konfigurácie
  8. Konfigurácia špecifická pre projekt
  9. Kľúčové poznatky

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_update už nemá žiadny účinok), nástroj edit (predtým search_replace) a odstránená sekcia [safety] nahradená kľúčom default_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í:

  1. Konfigurácia projektu: ./.vibe/config.toml (v aktuálnom adresári)
  2. 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_HOME vám umožňuje zmeniť adresár konfigurácie