Il-Fajl config.toml
F'din il-paġna
Lezzjoni aġġornata fit-2 ta’ Novembru 2026 abbażi tad-dokumentazzjoni ta’ Vibe Code: mudell integrat Mistral Medium 3.5 (flimkien ma’ Devstral 2),
enable_update_checks(iċ-ċavettaenable_auto_updatem’għadhiex effettiva), għoddaedit(qabelsearch_replace), u t-taqsima[safety]imneħħija sostitwita b’default_agent. Sorsi: Konfigurazzjoni · Referenza tal-konfigurazzjoni.
Fejn jinsab config.toml?
Vibe ifittex il-fajl tal-konfigurazzjoni tiegħu f’żewġ postijiet, f’dan l-ordni:
- Konfigurazzjoni tal-proġett:
./.vibe/config.toml(fid-direttorju kurrenti) - Konfigurazzjoni globali:
~/.vibe/config.toml(fid-direttorju tad-dar tiegħek)
Il-konfigurazzjoni tal-proġett tieħu preċedenza fuq il-konfigurazzjoni globali. Dan il-mekkaniżmu jagħmel l-għodda prattika għax-xogħol ta’ kuljum ta’ żviluppatur: il-konfigurazzjoni globali tirrifletti l-abitudnijiet tiegħek, filwaqt li r-repożitorju ta’ klijent jinfurza r-regoli tiegħu stess fid-direttorju tiegħu mingħajr ma teħtieġ li tbiddel is-settings manwalment.
Struttura tal-fajl
Il-fajl config.toml juża l-format TOML, format ta’ konfigurazzjoni li jinqara u mhux ambigwu. Hawnhekk hemm eżempju kkummentat sħiħ li fih kollox li se jkollok bżonn:
# ~/.vibe/config.toml
# Mudell attiv: il-mudell inkorporat, jew alias għal preset [[models]]
active_model = "mistral-medium-3.5"
# Aġent default (jekk iċ-ċavetta nieqsa, jaċċetta l-editjar)
default_agent = "ask"
# Prompt tas-sistema personalizzat (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"
# Tema: awtomatikament issegwi t-terminal; uża /theme biex tagħżel
theme = "auto"
# Kontroll ta' kuljum għal verżjonijiet ġodda
enable_update_checks = true
Għażla tal-mudell
Il-parametru active_model jiddetermina liema mudell juża Vibe għall-ġenerazzjoni. Jistenna alias: jew il-mudell inkorporat, Mistral Medium 3.5, jew alias għal preset [[models]] li ddikjarajt (kopert fil-lezzjoni li jmiss).
active_model = "mistral-medium-3.5"
M’għandekx għalfejn teditja l-fajl biex tbiddel il-mudelli: il-kmand /model ibiddel il-mudelli f’nofs is-sessjoni u juri l-lista tal-għażliet disponibbli. Uża l-fajl biex tistabbilixxi l-għażla default tiegħek, u l-kmand għal testijiet ta’ darba.
Personalizzazzjoni tal-prompt tas-sistema
Il-prompt tas-sistema jiddefinixxi l-imġiba ta’ Vibe. B’mod default, huwa kkonfigurat biex ikun assistent tal-ikkodjar effettiv, iżda tista’ tispeċjalizzah. Dan spiss huwa s-setting li jipproduċi l-akbar qligħ viżibbli: aġent li jaf il-konvenzjonijiet tiegħek minn qabel jieqaf jipproponi kodiċi li jeħtieġ riformattjar.
Il-prompts huma fajls Markdown maħżuna f’~/.vibe/prompts/. Oħloq tiegħek stess; hawnhekk hemm eżempju għal tim li jaħdem ma’ Python u 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
Imbagħad irreferenzjah f’config.toml billi tuża l-isem tal-fajl mingħajr l-estensjoni tiegħu:
system_prompt_id = "mon_prompt"
Konfigurazzjoni tal-aġenti
L-aġenti jmorru lil hinn mill-prompts biss: huma profili ta’ konfigurazzjoni sħaħ fejn kull aġent għandu l-mudell tiegħu stess, il-prompt tas-sistema, u l-permessi tal-għodod. Toħloqhom f’~/.vibe/agents/. L-eżempju l-aktar ċar huwa aġent ta’ reviżjoni tal-kodiċi:
# ~/.vibe/agents/code_review.toml
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]
[tools.bash]
permission = "never"
Niedih meta jkollok bżonn:
vibe --agent code_review
Dan l-aġent jista’ biss jaqra: ma jistax jikteb fajls jew jesegwixxi kmandi. Għalhekk tista’ tħallih jiskannja branch ta’ kollega mingħajr ma tibża’ minn modifiki aċċidentali, u jagħmluh il-modalità ideali għal reviżjonijiet tal-kodiċi sikuri.
Kontroll tal-għodod
Dan il-filtrar tal-għodod japplika wkoll għall-konfigurazzjoni prinċipali. Hemm żewġ listi disponibbli: waħda biex tippermetti biss għodod speċifiċi, u oħra biex tipprojbixxihom:
# Ippermetti biss għodod speċifiċi
enabled_tools = ["read_file", "grep", "edit"] # edit: qabel search_replace
# Iddiżattiva għodod speċifiċi
disabled_tools = ["bash", "write_file"]
It-tipjar ta’ kull isem bl-idejn isir tedjanti meta server MCP jesponi għoxrin għodda. L-għodod MCP huma msejħa {server}_{tool}, u l-filtri jaċċettaw wildcards u espressjonijiet regolari (prefiss re:). Dan jippermettilek taħdem skont familji minflok skont għodda individwali:
# Ippermetti l-għodod kollha minn server MCP imsejjaħ serena (mudell glob)
enabled_tools = ["serena_*"]
# ... jew l-istess ħaġa b'espressjoni regolari:
# enabled_tools = ["re:^serena_.*$"]
# Iddiżattiva l-għodod kollha mis-server MCP fetch_server
disabled_tools = ["fetch_server_*"]
Tema u post tal-konfigurazzjoni
Istabbilixxi t-tema fl-istess fajl, jew fuq it-titjira permezz tal-kmand /theme:
theme = "auto"
It-temi disponibbli jvarjaw skont il-verżjoni; uża /theme fil-modalità interattiva biex tara l-lista sħiħa u tipprevedja kull għażla qabel ma tissakkar fl-għażla tiegħek.
Fl-aħħar nett, Vibe jaħżen il-konfigurazzjoni tiegħu f’~/.vibe/ b’mod default, iżda tista’ tbiddel dan il-post permezz ta’ varjabbli tal-ambjent:
export VIBE_HOME="/chemin/vers/mon/dossier/vibe"
Dan huwa utli jekk id-direttorju tad-dar tiegħek ikun fuq drive tan-netwerk bil-mod fejn kull qari tal-konfigurazzjoni jikkawża latenza, jew jekk taqsam konfigurazzjoni bejn diversi magni permezz ta’ servizz ta’ sinkronizzazzjoni.
Konfigurazzjoni speċifika għall-proġett
Nirritornaw għax-xenarju tal-ftuħ: għal settings speċifiċi għall-proġett, oħloq .vibe/config.toml fir-raġuni tal-proġett:
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 jitgħabba dan il-fajl biss jekk iddikjarajt il-folder bħala affidabbli (trusted) fl-ewwel tnedija. Bħala prekawzjoni qabel ma tagħmel commit: żid .vibe/ fil-.gitignore tiegħek jekk il-fajl fih informazzjoni sensittiva, bħal ismijiet ta’ varjabbli jew URLs interni li ma tridx timbotta fir-repożitorju.
Punti Ewlenin
- config.toml jeżisti f’verżjonijiet globali (
~/.vibe/) u tal-proġett (./.vibe/) - Il-konfigurazzjoni tal-proġett tieħu preċedenza fuq il-konfigurazzjoni globali
- L-aġenti huma profili sħaħ b’mudell, prompt u permessi; istabbilixxi l-aġent default b’
default_agent - L-għodod jistgħu jiġu ffiltrati bl-użu ta’ wildcards jew regex
- Il-varjabbli
VIBE_HOMEtippermettilek tbiddel id-direttorju tal-konfigurazzjoni