Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Il-Fajl config.toml

Lezzjoni 6 / 16 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Fejn jinsab config.toml?
  2. Struttura tal-fajl
  3. Għażla tal-mudell
  4. Personalizzazzjoni tal-prompt tas-sistema
  5. Konfigurazzjoni tal-aġenti
  6. Kontroll tal-għodod
  7. Tema u post tal-konfigurazzjoni
  8. Konfigurazzjoni speċifika għall-proġett
  9. Punti Ewlenin

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ċ-ċavetta enable_auto_update m’għadhiex effettiva), għodda edit (qabel search_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:

  1. Konfigurazzjoni tal-proġett: ./.vibe/config.toml (fid-direttorju kurrenti)
  2. 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_HOME tippermettilek tbiddel id-direttorju tal-konfigurazzjoni