Mergerie
Sommaire

Configuration (.env)

Cette page est générée depuis docs/guide.fr.md · Modifier cette page sur GitLab

npx mergerie en écrit un au premier lancement, dans ~/.mergerie/.env — à côté des données, pour qu'il soit relu d'où que la commande parte : il cherche claude puis copilot sur la machine (dans le PATH, puis là où les installateurs les posent) et pointe AGENT_BIN sur celui qu'il trouve. Il est court (une dizaine de lignes), écrit une seule fois, en 600, jamais réécrit ensuite, et la commande dit ce qu'elle a créé. npx mergerie demo n'en pose pas : elle promet de ne rien laisser derrière elle.

L'agent se règle aussi à l'écran, sans redémarrage — Réglages → Session IA → Binaires de l'agent : le binaire par défaut, ses arguments de base, le délai d'un appel, et un bouton Tester l'agent (un appel réel, court, en lecture seule, dont la réponse attendue est « OK »). Ce qui est renseigné là passe devant le .env. Aucun agent trouvé ? Une bannière le dit en haut de l'écran, avec le chemin cherché et les commandes d'installation, et « Réessayer » refait la détection sans relancer le serveur — jusque-là les rapports sont simulés et dits tels. Ce que l'agent a le droit de faire ne se règle plus dans le .env : voir Sécurisé ou yolo dans la section Sécurité, et le même sous-onglet.

Quatre backends, et un niveau de garantie dit en clair. Claude Code et Copilot CLI sont éprouvés ; Codex CLI et Gemini CLI sont écrits d'après leur documentation, sans avoir été essayés par le mainteneur (les Réglages les disent « non vérifiés » : le premier run réel dira) ; un CLI inconnu est lancé tel quel. Le backend se détecte à ce que le binaire répond à --version, puis à son nom, et se choisit dans Réglages → Session IA (ou AGENT_BACKEND) quand la détection se trompe. À côté du nom, le niveau de ce que ce backend peut promettre : prouvé (la sandbox du CLI a été vue bloquer une écriture hors dossier et un appel réseau sur ce poste — « Tester le sandbox »), déclaré (le CLI sait se restreindre — --restricted, --sandbox read-only, --deny-tool — mais rien ne l'a prouvé ici : le contrôle d'intégrité après coup fait foi), allégé (rien de tout cela : le contrôle après coup est le seul filet, et le journal de chaque run l'écrit en première ligne). Aucun niveau ne bloque un CLI ; ce qui n'est jamais allégé : le jeton de forge hors du clone, l'API fermée par le jeton local, l'environnement en liste blanche, le mode large retiré des arguments. Dès qu'une lecture (review, exploration, mise à jour de connaissance) tourne sur un backend qui lui refuse l'écriture — Claude, Codex, Gemini, et Copilot quand il connaît --deny-tool —, la consigne demande la réponse finale au lieu d'un fichier que l'agent ne pourrait pas écrire.

Deux fichiers .env sont lus au démarrage, du plus faible au plus fort : ~/.mergerie/.env, puis celui du dossier d'où la commande est lancée (la racine du clone avec npm start, le répertoire courant avec npx mergerie) — c'est la surcharge locale. Ce que le shell exporte passe devant les deux. Les anciens noms COPILOT_BIN, COPILOT_ARGS, COPILOT_TIMEOUT_MS restent lus.

VariableDéfautRôle
PORT4319port du serveur
HOST127.0.0.1interface d'écoute ; 0.0.0.0 pour exposer sur le réseau — voir section Sécurité
AGENT_BINcopilotbinaire de l'agent IA (ex. claude) — remplacé par le réglage à l'écran s'il est renseigné (COPILOT_BIN reste lu)
AGENT_ARGS—args passés AVANT -p (ex. --model …) — idem (COPILOT_ARGS reste lu)
COPILOT_DRY_RUN01 = force le mode mock (sans IA)
AGENT_TIMEOUT_MS900000délai d'un appel IA (15 min) — idem (COPILOT_TIMEOUT_MS reste lu)
GITLAB_CA_CERT—chemin d'un CA à épingler (GitLab self-hosted) — recommandé
GITLAB_INSECURE_TLS01 = ignore la vérif TLS pour GitLab uniquement (dépannage)
GITHUB_CA_CERT—idem pour une instance GitHub Enterprise à CA interne
GITHUB_INSECURE_TLS01 = ignore la vérif TLS pour GitHub uniquement (dépannage)
JENKINS_CA_CERT—idem pour un Jenkins interne derrière un certificat d'entreprise
JENKINS_INSECURE_TLS01 = ignore la vérif TLS pour Jenkins uniquement (dépannage)
GIT_CLONE_SSH01 = clone via SSH (ta clé) au lieu de HTTPS+token
MERGERIE_DATA_DIRdata/dossier de données isolé (utile pour les tests)

Les variables que le CLI lit et que Mergerie ne connaît pas — un Ollama derrière Claude Code (ANTHROPIC_BASE_URL=http://localhost:11434, ANTHROPIC_AUTH_TOKEN=ollama), un proxy, une clé — se posent aussi à l'écran : Réglages → Session IA → « Variables d'environnement de l'agent », NOM=valeur par ligne. Elles sont transmises au seul agent que Mergerie lance, jamais à ton terminal (ton claude de tous les jours garde son abonnement), priment sur le shell, et comptent au prochain lancement d'agent sans redémarrer. De ce poste, jamais partagées ; MERGERIE_* y est refusé.

Plusieurs binaires, un par défaut. Réglages → Session IA → Binaires de l'agent est une liste : le défaut en première ligne, marqué — celui de la review, de la convergence, de la question libre et de toute session qui n'a rien choisi —, puis les autres, autant qu'on veut. Chaque ligne dit son état (trouvé, introuvable) et se teste, se modifie par le même formulaire (nom, binaire, arguments, variables d'environnement ; délai et backend sous « Avancé »). Un profil est complet : il ne complète pas le défaut (ses variables remplacent celles du défaut, ses arguments vides restent vides). Un Claude Code branché sur un Ollama local à côté de ton Claude Max, un Copilot pour comparer. Dans la modale d'une session (codage, exploration, hors dépôt), un sélecteur « Binaire » apparaît dès qu'il y en a un autre que le défaut ; le choix vaut pour toutes les passes de la session — suivi, réponses, plan approuvé, convergence — et sa carte l'affiche. « Utiliser par défaut » échange une ligne avec le défaut : l'ancien défaut prend sa place dans la liste, les sessions qui l'avaient choisi le gardent (un choix explicite reste explicite), et la preuve de sandbox tombe, comme à tout changement de binaire. De ce poste, jamais partagés : ce sont des chemins de cette machine, souvent des secrets — chez un collègue, la carte d'une session partagée dit le nom du binaire choisi, et sa relance part sur son défaut à lui.

Les sessions de codage écrivent dans le clone, en mode sécurisé comme en yolo (voir Sécurisé ou yolo, section Sécurité). Les explorations, elles, sont en lecture seule : les dépôts sont remis à zéro après chaque passe.