Que fait Codex CLI ?
Déléguez des tâches de codage à Codex via le terminal Hermes. Codex est l'interface en ligne de commande d'agent de codage autonome d'OpenAI.
Quand l'utiliser
- Développement de fonctionnalités
- Refactoring
- Revues de PR
- Correction groupée de tickets
Nécessite l'interface en ligne de commande Codex et un dépôt git.
Prérequis
- Codex installé :
npm install -g @openai/codex - Authentification OpenAI configurée : soit
OPENAI_API_KEYsoit les identifiants OAuth Codex depuis le flux de connexion de Codex CLI - Doit être exécuté dans un dépôt git — Codex refuse de fonctionner en dehors
- Utilisez
pty=truedans les appels au terminal — Codex est une application interactive de terminal
Pour Hermes lui-même, model.provider: openai-codex utilise l'OAuth Codex géré par Hermes
à partir de ~/.hermes/auth.json après hermes auth add openai-codex. Pour l'interface
en ligne de commande Codex autonome, une session OAuth CLI valide peut se trouver dans
~/.codex/auth.json ; ne considérez pas l'absence de OPENAI_API_KEY seule comme une preuve
que l'authentification Codex est manquante.
Tâches uniques
terminal(command="codex exec 'Ajoute un bouton de basculement du mode sombre dans les paramètres'", workdir="~/project", pty=true)
Pour des travaux ponctuels (Codex a besoin d'un dépôt git) :
terminal(command="cd $(mktemp -d) && git init && codex exec 'Crée un jeu de serpent en Python'", pty=true)
Mode arrière-plan (tâches longues)
# Démarrer en arrière-plan avec PTY
terminal(command="codex exec --full-auto 'Refactorise le module d'authentification'", workdir="~/project", background=true, pty=true)
# Retourne l'ID de session
# Surveiller la progression
process(action="poll", session_id="<id>")
process(action="log", session_id="<id>")
# Envoyer une entrée si Codex pose une question
process(action="submit", session_id="<id>", data="oui")
# Tuer si nécessaire
process(action="kill", session_id="<id>")
Drapeaux clés
| Drapeau | Effet |
|---|---|
exec "prompt" | Exécution unique, se termine une fois terminé |
--full-auto | Sandboxé mais approuve automatiquement les modifications de fichiers dans l'espace de travail |
--yolo | Pas de sandbox, pas d'approbations (le plus rapide, le plus dangereux) |
--sandbox danger-full-access | Pas de sandbox Codex ; utile lorsque le contexte du service hôte brise bubblewrap |
Mise en garde de la passerelle Hermes
Lors de l'invocation de Codex CLI depuis un contexte de passerelle/service Hermes (par exemple,
des sessions d'agent pilotées par Telegram), le sandboxing workspace-write de Codex peut échouer même
lorsque la même commande fonctionne dans le shell interactif de l'utilisateur. Un symptôme typique est
les erreurs bubblewrap/espace de noms utilisateur telles que setting up uid map: Permission denied
ou loopback: Failed RTM_NEWADDR: Operation not permitted.
Dans ce contexte, préférez :
codex exec --sandbox danger-full-access "<tâche>"
Utilisez plutôt les limites du processus comme couche de sécurité : workdir explicite, état git
propre avant le lancement, prompts de tâche précis, revue git diff, tests ciblés, et
confirmation humaine/agent avant de valider des modifications importantes.
Revues de PR
Clonez dans un répertoire temporaire pour une revue sécurisée :
terminal(command="REVIEW=$(mktemp -d) && git clone https://github.com/utilisateur/dépôt.git $REVIEW && cd $REVIEW && gh pr checkout 42 && codex review --base origin/main", pty=true)
Correction parallèle de tickets avec Worktrees
# Créer des worktrees
terminal(command="git worktree add -b fix/issue-78 /tmp/issue-78 main", workdir="~/project")
terminal(command="git worktree add -b fix/issue-99 /tmp/issue-99 main", workdir="~/project")
# Lancer Codex dans chacun
teminal(command="codex --yolo exec 'Corrige le ticket #78 : <description>. Valide quand terminé.'", workdir="/tmp/issue-78", background=true, pty=true)
terminal(command="codex --yolo exec 'Corrige le ticket #99 : <description>. Valide quand terminé.'", workdir="/tmp/issue-99", background=true, pty=true)
# Surveiller
process(action="list")
# Après validation, pousser et créer des PR
terminal(command="cd /tmp/issue-78 && git push -u origin fix/issue-78")
terminal(command="gh pr create --repo utilisateur/dépôt --head fix/issue-78 --title 'correction : ...' --body '...'")
# Nettoyage
terminal(command="git worktree remove /tmp/issue-78", workdir="~/project")
Revues de PR groupées
# Récupérer toutes les références de PR
terminal(command="git fetch origin '+refs/pull/*/head:refs/remotes/origin/pr/*'", workdir="~/project")
# Examiner plusieurs PR en parallèle
terminal(command="codex exec 'Examine la PR #86. git diff origin/main...origin/pr/86'", workdir="~/project", background=true, pty=true)
terminal(command="codex exec 'Examine la PR #87. git diff origin/main...origin/pr/87'", workdir="~/project", background=true, pty=true)
# Publier les résultats
terminal(command="gh pr comment 86 --body '<revue>'", workdir="~/project")
Règles
- Utilisez toujours
pty=true— Codex est une application interactive de terminal et se bloquera sans PTY - Dépôt Git requis — Codex ne fonctionne pas en dehors d'un répertoire git. Utilisez
mktemp -d && git initpour des travaux ponctuels - Utilisez
execpour les tâches uniques —codex exec "prompt"s'exécute et se termine proprement --full-autopour la construction — approuve automatiquement les modifications dans le sandbox- Arrière-plan pour les tâches longues — utilisez
background=trueet surveillez avec l'outilprocess - N'interférez pas — surveillez avec
poll/log, soyez patient avec les tâches de longue durée - Le parallélisme est possible — exécutez plusieurs processus Codex à la fois pour un travail groupé