Le fichier config.toml

Où se trouve config.toml ?

Vibe cherche son fichier de configuration à deux endroits, dans cet ordre :

1. Configuration projet : ./.vibe/config.toml (dans le répertoire courant)
2. Configuration globale : ~/.vibe/config.toml (dans votre home)

La configuration projet a priorité sur la configuration globale. Cela vous permet d’avoir des paramètres différents selon le projet sur lequel vous travaillez.

Structure du fichier

Le fichier config.toml utilise le format TOML, un format de configuration lisible et sans ambiguïté. Voici un exemple complet commenté :

# ~/.vibe/config.toml

# Modèle par défaut
active_model = "devstral-2"

# Prompt système personnalisé
system_prompt_id = "my_custom_prompt"

# Thème de l'interface
theme = "dark"

# Mises à jour automatiques
enable_auto_update = true

# Sécurité : approbation des outils
[safety]
auto_approve = false

Choisir le modèle

Le paramètre active_model détermine quel modèle Vibe utilise pour la génération. Par défaut, c’est Devstral 2 :

active_model = "devstral-2"

Vous pouvez changer de modèle à tout moment, y compris en pleine session avec la commande /model. Pour voir les modèles disponibles, utilisez /model dans l’interface interactive.

Personnaliser le prompt système

Le prompt système définit le comportement de Vibe. Par défaut, il est configuré pour être un assistant de codage efficace, mais vous pouvez le personnaliser.

Créer un prompt personnalisé

Les prompts sont des fichiers Markdown dans ~/.vibe/prompts/. Créez votre fichier :

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

Puis référencez-le dans config.toml :

system_prompt_id = "mon_prompt"

Configurer les agents

Les agents sont des profils de configuration complets. Chaque agent a son propre modèle, son prompt système et ses permissions d’outils. Créez-les dans ~/.vibe/agents/ :

# ~/.vibe/agents/code_review.toml

active_model = "devstral-2"
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "bash"]

[tools.bash]
permission = "never"

Lancez un agent spécifique :

vibe --agent code_review

Cet agent de code review ne peut que lire — il ne peut ni écrire de fichiers ni exécuter de commandes. C’est le mode idéal pour une revue de code en toute sécurité.

Contrôle des outils

Vous pouvez activer ou désactiver des outils spécifiques dans la configuration :

# Activer uniquement certains outils
enabled_tools = ["read_file", "grep", "search_replace"]

# Désactiver des outils spécifiques
disabled_tools = ["bash", "write_file"]

Les filtres supportent les wildcards et les expressions régulières :

# Activer tous les outils d'un serveur MCP spécifique
enabled_tools = ["serena_*"]

# Désactiver tous les outils MCP
disabled_tools = ["mcp_*"]

# Utiliser une regex
enabled_tools = ["re:^serena_.*$"]

Configurer le thème

Vibe propose plusieurs thèmes visuels. Changez-le dans config.toml ou via la commande /theme :

theme = "dark"

Les thèmes disponibles varient selon la version. Utilisez /theme dans le mode interactif pour voir la liste complète et prévisualiser chaque option.

Dossier personnalisé

Par défaut, Vibe stocke sa configuration dans ~/.vibe/. Si vous souhaitez un emplacement différent :

export VIBE_HOME="/chemin/vers/mon/dossier/vibe"

C’est utile si votre home est sur un disque réseau lent ou si vous partagez une configuration entre plusieurs machines via un service de synchronisation.

Configuration par projet

Pour avoir des paramètres spécifiques à un projet, créez .vibe/config.toml à la racine du projet :

mkdir -p .vibe
cat > .vibe/config.toml << 'EOF'
active_model = "devstral-2"
system_prompt_id = "python_expert"

[tools.bash]
permission = "always"
EOF

N’oubliez pas d’ajouter .vibe/ à votre .gitignore si le fichier contient des informations sensibles.

Points clés à retenir

• config.toml existe en version globale (~/.vibe/) et par projet (./.vibe/)
• La configuration projet a priorité sur la globale
• Les agents sont des profils complets avec modèle, prompt et permissions
• Les outils peuvent être filtrés avec des wildcards ou des regex
• La variable VIBE_HOME permet de changer le répertoire de configuration