Configuration

La CLI Vibe Code se configure via un fichier config.toml. Cette page explique où se trouve ce fichier, comment l’ouvrir et les paramètres les plus courants à personnaliser.

La CLI recherche config.toml dans cet ordre :

1. ./.vibe/config.toml dans le répertoire de travail courant (au niveau du projet).
2. ~/.vibe/config.toml dans votre dossier personnel (au niveau utilisateur).

La configuration projet a priorité sur la configuration utilisateur. La configuration du projet n’est chargée que si le dossier de travail est approuvé.

Ouvrez ~/.vibe/config.toml avec votre éditeur par défaut :

# macOS
open ~/.vibe/config.toml

# Linux
xdg-open ~/.vibe/config.toml

# Windows (PowerShell)
Invoke-Item ~\.vibe\config.toml

# macOS
open ~/.vibe/config.toml

# Linux
xdg-open ~/.vibe/config.toml

# Windows (PowerShell)
Invoke-Item ~\.vibe\config.toml

Vous pouvez également ouvrir le menu de configuration depuis une session avec la commande slash /config.

Par défaut, la CLI stocke sa configuration et son état dans ~/.vibe/. Modifiez l’emplacement avec la variable d’environnement VIBE_HOME :

export VIBE_HOME="/path/to/custom/vibe/home"

export VIBE_HOME="/path/to/custom/vibe/home"

VIBE_HOME détermine l’emplacement des éléments suivants :

• config.toml : configuration principale.
• .env : clés API et identifiants de fournisseurs.
• agents/ : profils d’agents personnalisés.
• prompts/ : prompts système personnalisés.
• skills/ : Skills personnalisées.
• tools/ : outils personnalisés.
• logs/ : journaux des sessions et de l’application.

Utilisez --workdir pour pointer la CLI vers un projet qui n’est pas le dossier courant :

vibe --workdir /path/to/project

vibe --workdir /path/to/project

Utilisez --add-dir pour donner à la CLI un accès en lecture à un autre dossier, le temps d’une session.

config.toml accepte de nombreuses clés et sections principales. Les plus courantes sont listées ici, chacune renvoyant vers une page dédiée.

Définissez l’agent interactif par défaut :

default_agent = "plan"

default_agent = "plan"

Ce réglage ne concerne que les sessions interactives. En mode programmatique, le mode auto-approve est utilisé si --agent n’est pas précisé. Voir Agents.

Définissez les préréglages de fournisseurs, les préréglages de modèles et le modèle actif.

Les modèles conversationnels suivants sont disponibles via l'API de Mistral (la Plateforme). Utilisez l'ID du modèle comme valeur name dans un bloc [[models]], ou transmettez-le directement avec --model :

Vous pouvez aussi fixer une version précise en remplaçant -latest par un suffixe de date (par exemple, mistral-medium-3-5 ou codestral-2508). Consultez la présentation des modèles pour voir toutes les versions disponibles.

Pour utiliser un modèle via un fournisseur tiers comme OpenRouter, définissez un fournisseur personnalisé et un préréglage de modèle :

active_model = "codestral-openrouter"

[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"

[[models]]
name = "mistralai/codestral"
provider = "openrouter"
alias = "codestral-openrouter"

active_model = "codestral-openrouter"

[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"

[[models]]
name = "mistralai/codestral"
provider = "openrouter"
alias = "codestral-openrouter"

Voir Clés API et profils.

Ajoutez des serveurs Model Context Protocol sous mcp_servers. Voir Serveurs MCP.

Activez, désactivez ou ajoutez des chemins de Skills :

skill_paths = ["/path/to/custom/skills"]
enabled_skills = ["code-review", "test-*"]
disabled_skills = ["experimental-*"]

skill_paths = ["/path/to/custom/skills"]
enabled_skills = ["code-review", "test-*"]
disabled_skills = ["experimental-*"]

enabled_skills et disabled_skills interagissent comme suit :

• Si enabled_skills est défini et non vide, seules les Skills dont le nom correspond à un motif de cette liste sont disponibles.
• Sinon, toutes les Skills détectées sont disponibles, sauf celles dont le nom correspond à un motif de disabled_skills.

Voir Skills.

Restreignez les outils accessibles à l’agent :

enabled_tools = ["serena_*"]
disabled_tools = ["mcp_*", "grep"]

enabled_tools = ["serena_*"]
disabled_tools = ["mcp_*", "grep"]

Les filtres d’outils acceptent les noms exacts, les glob patterns et les regex avec le préfixe re:. Des autorisations spécifiques peuvent aussi être définies dans des blocs [tools.<tool_name>]. Voir Sécurité, validations et permissions.

Exécutez des commandes shell arbitraires avant ou après les appels d'outils, ou à la fin de chaque tour de l'assistant, afin de filtrer, auditer ou réécrire le comportement de l'agent. Déclarez les hooks dans un fichier hooks.toml séparé. Voir Hooks.

Gérez la mise à jour automatique, les notifications et la télémétrie :

enable_auto_update = true
enable_notifications = true
enable_telemetry = true

enable_auto_update = true
enable_notifications = true
enable_telemetry = true

Lorsque le même paramètre est défini à plusieurs endroits, la CLI les applique dans cet ordre (priorité décroissante) :

1. Configuration Admin, si votre organisation en impose une. Consultez Configuration Admin.
2. Options en ligne de commande (par exemple, --agent, --workdir).
3. Variables d’environnement (par exemple, MISTRAL_API_KEY, VIBE_HOME).
4. Projet ./.vibe/config.toml.
5. Utilisateur ~/.vibe/config.toml.