Référence de configuration
Index exhaustif de toutes les clés acceptées par config.toml et les fichiers de définition d’agents. Les clés sont regroupées par section, chacune renvoyant à la page qui explique le concept en détail. Utilisez cette page comme aide-mémoire, et Configuration pour comprendre le fonctionnement du fichier.
Clés de premier niveau
Clés de premier niveau
Toutes les clés se trouvent à la racine de config.toml sauf indication contraire.
| Clé | Type | Valeur par défaut | Description |
|---|---|---|---|
default_agent | string | Agent interactif par défaut, par exemple "plan". Ignoré en mode programmatique, qui revient à auto-approve. Voir Agents | |
active_model | string | Alias de modèle actuellement utilisé. Défini sur un alias de [[models]] ou un ID de modèle intégré | |
allowed_models | array<string> | Liste d'autorisation de motifs de noms de modèles (correspondance exacte, glob ou regex re:), comparés aux noms des modèles envoyés à l'API d'inférence, et non à leurs alias. Si la liste n'est pas vide, seuls les modèles correspondants sont sélectionnables | |
compaction_model | table | Modèle qui résume la conversation pendant /compact. Valeur par défaut : le modèle actif | |
vision_model | table | Modèle compatible vision qui décrit les images jointes lorsque le modèle actif ne prend pas en charge les images. Utilise par défaut n'importe quel modèle compatible vision du fournisseur du modèle actif. Définissez-le pour utiliser un modèle d'un autre fournisseur | |
log_interactions | boolean | true | Active la journalisation des sessions. Requis pour --continue / --resume. Voir Travailler avec la CLI |
skill_paths | array<string> | Répertoires supplémentaires où découvrir des skills. Voir Skills | |
enabled_skills | array<string> | Liste d’autorisation de motifs de noms de skills (exact, glob ou re: regex). Si non vide, seuls les skills correspondants se chargent | |
disabled_skills | array<string> | Liste d’exclusion de motifs de noms de skills, appliquée quand enabled_skills est vide | |
enabled_tools | array<string> | Liste d’autorisation de motifs de noms d’outils. Voir Sécurité, approbations et permissions | |
disabled_tools | array<string> | Liste d’exclusion de motifs de noms d’outils | |
enable_auto_update | boolean | true | Vérifie et installe les nouvelles versions en arrière-plan |
enable_notifications | boolean | true | Notifications système quand une tâche longue se termine ou qu’une saisie est requise |
enable_telemetry | boolean | true | Envoie de la télémétrie anonyme d’usage et d’erreurs à Mistral. Désactivez pour un usage hors ligne uniquement |
[[providers]] | table array | Préréglages de fournisseurs. Champs listés ci-dessous. Voir Clés API et profils | |
[[models]] | table array | Préréglages de modèles. Champs listés ci-dessous. Voir Clés API et profils | |
[[mcp_servers]] | table array | Définitions de serveurs MCP. Champs listés ci-dessous. Voir Serveurs MCP |
Fournisseurs (
[[providers]])Fournisseurs ([[providers]])
Une table [[providers]] par préréglage de fournisseur.
| Clé | Type | Valeur par défaut | Description |
|---|---|---|---|
name | string | Requis | Identifiant du préréglage de fournisseur, référencé par un provider de [[models]] |
api_base | string | URL de base de l’API du fournisseur | |
api_key_env_var | string | Nom de la variable d’environnement contenant la clé d’API. Les secrets doivent utiliser cette forme dans la config admin | |
api_style | string | Style d’API, par exemple "openai" | |
backend | string | Type de backend, par exemple "generic" ou "mistral" | |
region | string | Région, par exemple "eu-west-1". Configurations d’entreprise uniquement | |
[providers.extra_headers] | table | Sous-table d’en-têtes HTTP supplémentaires, par exemple "x-acme-tenant" = "engineering" |
Modèles (
[[models]])Modèles ([[models]])
Une table [[models]] par préréglage de modèle.
| Clé | Type | Valeur par défaut | Description |
|---|---|---|---|
name | string | Requis | ID du modèle, par exemple mistral-medium-latest |
provider | string | Requis | Référence un name de [[providers]] |
alias | string | name | Alias local utilisé par active_model. En cas d'omission, la valeur par défaut est name |
display_name | string | alias | Libellé affiché dans le sélecteur de modèle. Prend la valeur alias si non renseigné |
temperature | number | 0.2 | Température d'échantillonnage |
input_price | number | Coût par million de tokens d'entrée, utilisé pour plafonner les coûts en mode programmatique | |
output_price | number | Coût par million de tokens de sortie, utilisé pour plafonner les coûts en mode programmatique | |
cached_input_price | number | Coût par million de tokens d'entrée mis en cache. Omettez-le pour facturer l'entrée mise en cache au tarif input_price | |
thinking | string | off | Niveau de réflexion par défaut pour le modèle. L'un des thinking_levels du modèle |
thinking_levels | array<string> | Niveaux de Réflexion disponibles pour ce modèle. Utilise par défaut les cinq niveaux intégrés à la CLI en cas d'omission | |
supports_images | booléen | false | Indique si le modèle est compatible vision. Si true, vous pouvez mentionner des images avec @ |
max_context_length | number | Fenêtre de contexte en tokens. Détermine la compaction automatique | |
auto_compact_threshold | number | Nombre de tokens qui déclenche la compaction automatique. Remplace le seuil de déclenchement par défaut, soit 80 % de max_context_length |
Serveurs MCP (
[[mcp_servers]])Serveurs MCP ([[mcp_servers]])
Une table [[mcp_servers]] par serveur. Les champs requis dépendent du transport (http, streamable-http ou stdio).
| Clé | Type | Valeur par défaut | Description |
|---|---|---|---|
name | string | Requis | Alias court ; préfixe les noms d’outils de ce serveur |
transport | string | Requis | Un parmi http, streamable-http ou stdio |
url | string | URL de base pour les transports HTTP | |
command | string | Commande pour le transport stdio | |
args | array<string> | Arguments pour le transport stdio | |
headers | table | En-têtes HTTP supplémentaires pour les transports HTTP | |
env | table | Variables d’environnement passées au processus stdio | |
api_key_env | string | Variable d’environnement contenant la clé d’API. Distinct du champ api_key_env_var des fournisseurs | |
api_key_header | string | Nom de l’en-tête à définir avec la clé d’API | |
api_key_format | string | Chaîne de format, par exemple "Bearer {token}" | |
startup_timeout_sec | number | Secondes d’attente pour le démarrage du serveur | |
tool_timeout_sec | number | Secondes d’attente pour l’exécution d’un appel d’outil |
Permissions par outil (
[tools.<tool_name>])Permissions par outil ([tools.<tool_name>])
<tool_name> est un outil intégré (read_file, bash, etc.) ou un outil MCP nommé {server_name}_{tool_name}. Un bloc par outil.
| Clé | Type | Valeur par défaut | Description |
|---|---|---|---|
permission | string | "always" pour autoriser automatiquement l’outil, "ask" pour demander avant usage | |
allow | array<string> | bash uniquement. Liste d’autorisation de commandes, par exemple ["git status", "pnpm test"] | |
deny | array<string> | bash uniquement. Liste d’exclusion de commandes, par exemple ["rm -rf *"] |
Fichiers de définition d’agents
Fichiers de définition d’agents
Ces clés se trouvent dans ~/.vibe/agents/<name>.toml ou ./.vibe/agents/<name>.toml, pas dans config.toml. Elles définissent des agents et sous-agents personnalisés. La plupart des clés de premier niveau ci-dessus (active_model, enabled_tools, disabled_tools, blocs [tools.*]) peuvent aussi être définies dans un fichier d’agent pour surcharger la configuration globale de cet agent.
| Clé | Type | Valeur par défaut | Description |
|---|---|---|---|
agent_type | string | Requis | "agent" (utilisateur, sélectionnable via --agent) ou "subagent" (délégation uniquement) |
display_name | string | Libellé lisible par l’utilisateur | |
description | string | Description en texte libre | |
safety | string | Indicateur visuel : safe, neutral, destructive ou yolo. Change uniquement la couleur de bordure de l’entrée ; n’applique aucune permission | |
system_prompt_id | string | Pointe vers un fichier de prompt dans ~/.vibe/prompts/ | |
active_model | string | Alias de modèle pour cet agent (même clé que la config globale) | |
enabled_tools | array<string> | Liste d’autorisation d’outils pour cet agent | |
disabled_tools | array<string> | Liste d’exclusion d’outils pour cet agent |
Voir Agents pour les agents intégrés et des exemples complets.
Variables d’environnement
Variables d’environnement
Ce ne sont pas des clés de config.toml, mais elles font partie du modèle de configuration. Elles se situent au niveau de précédence 3 (variables d’environnement).
| Variable | Rôle |
|---|---|
VIBE_HOME | Surcharge le répertoire racine ~/.vibe/ pour tout l’état (config, prompts, agents, skills, journaux) |
MISTRAL_API_KEY | Clé d’API Mistral principale |
<PROVIDER>_API_KEY | Clé d’API référencée par un api_key_env_var de [[providers]] (par exemple OPENROUTER_API_KEY) |
Voir Précédence de configuration et Config admin pour comprendre comment ces couches se combinent.