Référence des paramètres

Coppice garde ses paramètres dans un seul fichier, config.toml :

SystèmeChemin
Linux~/.config/Coppice/config.toml
macOS~/Library/Application Support/Coppice/config.toml

Sous Linux, si XDG_CONFIG_HOME est défini, le fichier se trouve dans $XDG_CONFIG_HOME/Coppice/config.toml.

Le modifier dans l’application

Ouvrez Settings dans la barre latérale. La page affiche le fichier en texte. Vos commentaires sont conservés.

  • Save vérifie le fichier avant de l’écrire. Une valeur incorrecte n’est pas enregistrée.
  • Restore last good version annule une mauvaise modification.

Certains changements s’appliquent tout de suite. D’autres affichent « Saved. Restart Coppice to apply. » (enregistré ; redémarrez Coppice pour appliquer).

Vous pouvez aussi modifier le fichier dans n’importe quel éditeur de texte. Vos modifications survivent aux mises à jour.

Mises à jour

Ouvrez System → Updates pour voir votre version et choisir Check for updates. Automatic updates est activé par défaut. Désactivez-le pour que Coppice arrête de chercher les nouvelles versions en arrière-plan.

Cet interrupteur n’est pas dans config.toml. Coppice l’enregistre sous automaticUpdates dans update-settings.json, dans le même dossier.

Remplacer les clés

Si vous avez partagé une sauvegarde, créez de nouvelles clés et un nouveau mot de passe administrateur. Les jetons enregistrés continuent de fonctionner. Tout le monde est déconnecté.

Ouvrez System → Backup → Replace keys, saisissez le nouveau mot de passe administrateur, et confirmez.

Journaux

Les administrateurs peuvent ouvrir System → Logs pour filtrer et suivre en direct les journaux du serveur, des requêtes, des lancements d’agents et de la base de données. Chaque lancement a un lien View logs.

Export logs enregistre les lignes qui correspondent à vos filtres actuels dans coppice-logs.zip. Coppice retire les jetons et les clés qu’il connaît, mais vérifiez le fichier avant de le partager.

Report a problem ouvre un nouveau ticket GitHub avec votre version de Coppice déjà remplie. Dites ce qui s’est passé et ce que vous attendiez, puis joignez le zip d’Export logs.

[logs]

ChampTypeDéfautRôle
retention_daysinteger14Combien de jours de journaux garder, aujourd’hui compris : 3, 7, 14 ou 30. La valeur par défaut est 14. Coppice supprime les journaux plus anciens toutes les heures. Les changements s’appliquent sans redémarrage. Si les journaux dépassent 256 Mio, Coppice supprime d’abord les plus anciens, même avant la fin de retention_days.

Le journal de chaque jour est découpé en fichiers de 32 Mio au plus. Chaque fichier compte dans la limite de 256 Mio, ceux du jour compris. Coppice ne supprime jamais le fichier de journal ni le journal de base de données en cours d’écriture. Les journaux de base de données comptent dans la limite. Coppice les supprime une fois retention_days dépassé.

ChampTypeDéfautRôle
dirstring./data/logsDossier des journaux. L’application de bureau utilise son propre dossier et ignore cette valeur. La changer demande un redémarrage.

Connecteurs

Les CLI que Coppice trouve sont activées par défaut, sauf si leur vérification de connexion indique que vous êtes déconnecté. Vous n’avez besoin d’une ligne que pour en désactiver une :

[agent.connectors.claude-code]
enabled = false

L’interrupteur dans System → Connectors écrit la même ligne.

Kilo Code, GitHub Copilot, Qwen Code et Kimi Code sont activés dès que Coppice les trouve. Coppice ne peut pas vérifier leur connexion gratuitement, donc un lancement affiche une erreur si vous êtes déconnecté.

[agent]

ChampTypeDéfautRôle
worktrees_pathstring<data-dir>/worktreesDossier où chaque ticket a son propre worktree git.
worker_countinteger8Plafond total de tâches d’agents, tous connecteurs confondus. En dessous de 1, vaut 1. Un ancien worker_count = 2 garde l’ancien plafond et peut bloquer les autres connecteurs tant que vous ne l’augmentez pas ou ne le retirez pas.
health_check_interval_secsinteger60Secondes entre deux vérifications de santé des agents. En dessous de 10, vaut 10.

<data-dir> est le dossier qui contient config.toml : ~/.config/Coppice sous Linux et WSL, et ~/Library/Application Support/Coppice sous macOS.

[agent.connectors.<id>]

Ids : claude-code, codex, cursor, opencode, kilo-code, copilot, qwen-code, kimi, grok. Chaque table est facultative.

ChampTypeDéfautRôle
enabledboolnon défini : activé si la CLI est connectéeActive ou désactive le connecteur.
model_providerslist of strings[]Fournisseurs de modèles pour ce connecteur. Remplis quand vous l’activez.
run_timeout_secsinteger1800 pour tous les connecteursSecondes avant qu’un lancement sur ce connecteur échoue.
max_concurrent_runsinteger2Nombre de tâches que ce connecteur peut exécuter en même temps. Les autres restent en file et partent de la plus ancienne. En dessous de 1, vaut 1.
commandstringcursor-agent (Cursor), codex, opencode, kilo, copilot, qwen, kimi, grokLe binaire de CLI à lancer. Claude Code lance toujours claude et n’a pas de command.

OpenCode uniquement :

ChampTypeDéfautRôle
serve_hostnamestring127.0.0.1Nom d’hôte de l’assistant OpenCode pendant un lancement. Demande un redémarrage.

Changer la command d’OpenCode demande aussi un redémarrage.

[workflow]

ChampTypeDéfautRôle
auto_start_runsbooltrueSi true, assigner un agent à un ticket qui a un dépôt lance un lancement. Si false, vous cliquez sur Run agent.
auto_assign.defaultbooltrueActive l’assignation automatique pour chaque statut sans réglage propre.
auto_assign.<status>boolbacklog : false. Autres : suit defaultActive ou désactive l’assignation automatique pour un statut.
auto_split.defaultboolfalseActive le découpage automatique pour chaque statut sans réglage propre.
auto_split.<status>boolsuit defaultActive ou désactive le découpage automatique pour un statut.

Clés de statut : backlog, ready, in_progress, in_review, in_qa, wait_for_final_review (Wait for Human Review), blocked, done.

Quand l’assignation automatique est activée pour ce statut, Coppice assigne l’agent désigné par le lancement. Sinon, le ticket affiche Recommends: à la place.

Quand le découpage automatique est activé pour ce statut, Coppice crée les tickets enfants que le lancement propose. Sinon, il enregistre une Pending split recommendation jusqu’à ce que vous cliquiez sur Approve splits.

[knowledge]

ChampTypeDéfautRôle
enabledbooltrueActive ou désactive le compactage de Knowledge.
poll_interval_msinteger500Fréquence de réveil du planificateur de compactage. En dessous de 100, vaut 100.
compaction.interval_secsinteger1800Secondes entre deux cycles de compactage.
compaction.batch_max_ticketsinteger10Nombre maximal de tickets dans un lot.
compaction.batch_max_source_bytesinteger200000Nombre maximal d’octets de source dans un lot.
compaction.max_candidates_per_batchinteger20Nombre maximal de candidats qu’un lot peut proposer.
compaction.max_attemptsinteger3Nombre maximal d’essais pour un lot.
auto_save.enabledboolfalseEnregistre les candidats peu risqués sans vous demander.
auto_save.allowed_typeslist of strings[]Types que l’enregistrement automatique peut garder : bug_pattern, coding_convention, dependency_note, performance_note, review_feedback, test_command.
auto_save.minimum_confidencestringhighDoit rester high.
retrieval.top_kinteger8Nombre d’entrées renvoyées par une recherche. De 1 à 20.
retrieval.allowed_typeslist of strings[] (tous les types)Ne renvoie que ces types : coding_convention, architecture_rule, bug_pattern, test_command, review_feedback, dependency_note, api_contract, workflow_rule, human_preference, operational_runbook, security_rule, performance_note.
retrieval.minimum_confidencestringmediumlow, medium ou high.
retrieval.default_page_sizeinteger25Taille de page par défaut.
retrieval.max_page_sizeinteger100Taille de page maximale. 100 au plus.
retrieval.max_active_per_boardinteger1000Nombre maximal d’éléments Knowledge, en attente ou approuvés, qu’un tableau peut contenir. Les éléments des agents de ce tableau comptent aussi.
retrieval.max_active_workspaceinteger10000Nombre maximal d’éléments Knowledge, en attente ou approuvés, qui s’appliquent à tout l’espace de travail.

Chaque nombre et intervalle ci-dessus doit être supérieur à 0.

[git]

ChampTypeDéfautRôle
author_namestringCoppiceNom d’auteur des commits créés par Coppice.
author_emailstringcoppice@localhostE-mail d’auteur de ces commits.
push_enabledboolfalse (true dans l’application de bureau)Autorise Coppice à pousser des branches et à ouvrir des pull requests.

[plugins]

ChampTypeDéfautRôle
dirstring<data-dir>/pluginsVotre dossier de plugins par défaut. Ajoutez d’autres dossiers sur la page Plugins.
allow_file_git_urlsboolfalseAutorise les URL git file: pour installer des plugins.
git_timeout_secsinteger300Secondes avant qu’un clonage ou une mise à jour de plugin échoue.
mcp_start_timeout_secsinteger20Secondes d’attente du démarrage du serveur MCP d’un plugin.
mcp_list_timeout_secsinteger10Secondes d’attente pour qu’un plugin liste ses outils.
mcp_idle_shutdown_secsinteger600Secondes pendant lesquelles un serveur MCP de plugin inactif reste lancé.

[mcp]

ChampTypeDéfautRôle
builtin_plugins_dirstring<data-dir>/builtin-pluginsOù Coppice écrit ses skills intégrées à chaque démarrage. Les modifications faites là sont perdues.
call_timeout_secsinteger60Secondes avant qu’un appel d’outil échoue.
max_output_bytesinteger32768Taille maximale d’un résultat d’outil, en octets.
comment_post_limitinteger5Nombre maximal de commentaires qu’un lancement peut publier.
token_ttl_secsinteger14400Durée de vie du jeton d’outils d’un lancement, en secondes.

[keybindings]

Chaque clé est un id de commande de Raccourcis clavier. Vos touches remplacent celles par défaut de la commande. Une valeur vide désactive le raccourci.

ChampTypeDéfautRôle
"<command id>"string or list of stringsle raccourci intégréRemplace les touches de cette commande. "" les retire.
[keybindings]
"palette.open" = "P"
"ticket.create" = ""
"board.nextCard" = ["J", "Down"]

Mod correspond à Cmd sur macOS et à Ctrl sur Linux et WSL. Une séquence s’écrit G then B. Plusieurs touches pour une même commande se séparent par or, ou s’écrivent en liste. Save applique le changement sans redémarrage. Coppice ignore un raccourci qu’il ne sait pas lire, un id de commande inconnu, une touche déjà prise par une autre commande, ou une touche qui appartient au navigateur ou au système. La commande garde sa valeur par défaut. Settings explique pourquoi.