Configuration FR

Configuration

🌍 English · Polski · Français · Deutsch · 中文

ECLI se configure via un seul fichier TOML. Les valeurs par défaut sont raisonnables — la plupart des utilisateurs ne modifient que la section du fournisseur IA et le thème.

Emplacement du fichier de configuration

Plateforme	Chemin
Linux / FreeBSD	~/.config/ecli/config.toml
macOS	~/Library/Application Support/ecli/config.toml
Windows	%APPDATA%\ecli\config.toml

Vous pouvez surcharger avec --config /chemin/vers/config.toml en ligne de commande, ou via la variable d'environnement ECLI_CONFIG :

ECLI_CONFIG=/tmp/test-config.toml ecli

Priorité

Lorsqu'un même paramètre est défini à plusieurs endroits, ECLI applique (priorité décroissante) :

1. Flags de ligne de commande (--theme dark)
2. Variables d'environnement (ECLI_THEME=dark)
3. Configuration utilisateur (~/.config/ecli/config.toml)
4. Valeurs par défaut intégrées

Génération au premier lancement

Au premier lancement, ECLI crée une configuration par défaut avec des commentaires inline expliquant chaque clé. Vous pouvez la régénérer à tout moment :

ecli --print-default-config > ~/.config/ecli/config.toml

Vue d'ensemble du schéma

La configuration est divisée en sections nommées :

[editor]      # taille tab, fins de ligne, auto-save
[ui]          # thème, largeurs panneaux, barre statut
[keybindings] # mappings de touches personnalisés
[ai]          # sélection du fournisseur IA
[ai.openai]   # paramètres par fournisseur
[ai.anthropic]
[ai.ollama]
[ai.huggingface]
[git]         # comportement intégration git
[lsp]         # préférences language server
[linters]     # sélection linter par langue
[panels]      # quels panneaux sont activés

Référence complète : docs/config/config-schema.md.

Modifications les plus courantes

Changer le thème

[ui]
theme = "dark"   # ou "light", "solarized-dark", "monokai", "nord"

Redémarrez ECLI pour appliquer.

Configurer le fournisseur IA

[ai]
default_provider = "anthropic"

[ai.anthropic]
api_key = "sk-ant-..."
model = "claude-sonnet-4-5"
max_tokens = 4096

Voir Configuration IA pour la matrice complète.

Largeur de tabulation

[editor]
tab_width = 4
use_spaces = true

Fins de ligne

[editor]
line_ending = "lf"   # ou "crlf", "auto"

Désactiver l'auto-save

[editor]
autosave = false

Activer Ruff pour Python

[linters]
python = "ruff"

Configuration minimale fonctionnelle

[editor]
tab_width = 4
use_spaces = true

[ui]
theme = "dark"

[ai]
default_provider = "none"

[git]
auto_fetch = false

[lsp]
enabled = true

Migration

Lors d'une montée de version du schéma (rare), ECLI migre automatiquement et sauvegarde l'ancien fichier sous config.toml.bak. Voir config-migration-policy.

Configuration par projet

ECLI cherche un .ecli.toml dans le répertoire de travail courant. Les paramètres y sont prioritaires pour ce projet uniquement.

Exemple .ecli.toml :

[editor]
tab_width = 2

[linters]
python = "pylint"

Validation

ecli --check-config

Retourne 0 en cas de succès, affiche les erreurs sinon. Une configuration malformée bascule sur les valeurs par défaut avec un avertissement.

Voir aussi

• Configuration IA
• Thèmes et personnalisation
• Raccourcis clavier
• docs/config/config-schema.md