Comment un enfant sait à qui répondre. Chaque session lancée par Overvibe reçoit $OVERVIBE_SESSION dans son environnement : son id tmux. Le parent le met dans la consigne de l'enfant comme adresse de réponse, et overvibe stop s'en sert pour décider ce que vous pouvez fermer.
01Commandes
| Commande | Ce qu'elle fait |
|---|---|
overvibe new | Lance une session. --cwd est obligatoire. |
overvibe send | Tape un message dans le prompt d'une session : Claude, Codex ou agy. |
overvibe ls | Liste les sessions en cours avec statut, outil et dossier. --json pour les fiches complètes. |
overvibe resume | Reprendre une session arrêtée ou passée sur la même conversation. overvibe ls --past les liste. |
overvibe attach | Ouvrir une session en cours dans votre terminal (tmux attach). Ctrl-b d la laisse tourner. |
overvibe open | Affiche une session à l'écran dans Overvibe. |
overvibe stop | Arrête une session. La conversation est conservée. |
overvibe move | Déplace une session Claude dans un autre dossier à la fin de son tour. |
02overvibe new
overvibe new --cwd <folder> [--mkdir] [--tool claude|codex|agy] [--name "<name>"] [--prompt "<first message>"] [--attach] $ overvibe new --tool codex --cwd ~/code/shop --name "shop: codex copy" \ --prompt "Rewrite the hero copy in landing.md. When done, run: overvibe send \"shop: lead\" \"<summary>\"" started "shop: codex copy" in ~/code/shop (session pending, tmux d3f9a1c2) message it: overvibe send "shop: codex copy" "<message>"
--toolvaut claude par défaut.--nameest ce qu'affiche la barre latérale et ce queovervibe sendcherche. Restez court, projet et rôle : "shop: codex review".--promptest le premier message. Pour agy, il est tapé dès que la zone de saisie d'agy est prête.--mkdircrée d'abord un dossier manquant (uniquement sous votre dossier personnel). Sans cette option, un dossier manquant est refusé.--attachen fait un enfant de la session qui lance la commande, imbriqué sous elle dans la barre latérale. Ne fonctionne que depuis une session Overvibe.
Les options inconnues sont rejetées : une faute de frappe ne lance jamais de session.
03overvibe send
La cible peut être un id tmux, un id de session, un nom exact ou une partie de nom (la correspondance active le plus récemment l'emporte). Le message arrive avec un en-tête qui nomme l'expéditeur et la commande de réponse exacte, les retours à la ligne remplacés par des espaces :
$ overvibe send "shop: codex copy" "Also shorten the CTA." # typed into the prompt of "shop: codex copy" [overvibe message from "shop: lead" (claude); reply with: overvibe send "shop: lead" "<reply>"] Also shorten the CTA.
Seules les sessions Overvibe peuvent le recevoir. Une session dans un simple onglet Terminal n'a pas de volet où taper : faites-la d'abord entrer dans Overvibe.
04overvibe ls
$ overvibe ls
busy codex overvibe ↳ shop: codex review ~/code/shop
waiting claude overvibe shop: lead ~/code/shop
idle claude outside notes ~/notesColonnes : statut (busy, idle, waiting, blocked, ended), outil, dans Overvibe ou en dehors, nom (↳ marque un enfant attaché) et dossier.
05overvibe resume
$ overvibe ls --past $ overvibe resume "api: codex tests" --prompt "One more: also run the lint. Report back the same way."
Ramène une session arrêtée dans son dossier, avec son nom et sa ligne dans la barre latérale ; un assistant arrêté revient sous son parent. --prompt est tapé une fois la session prête, --attach en fait un enfant de la session appelante, et --fork démarre une copie à la place (Claude uniquement).
06overvibe attach
Ouvre une session en cours dans votre terminal actuel via tmux. --print affiche la commande tmux au lieu de la lancer.
07overvibe open, overvibe stop, overvibe move
overvibe open ["<session name>"] overvibe stop "<session name>" overvibe stop --children overvibe move --to <folder> [--session "<name>"]
overvibe open
Ouvre cette session à l'écran ; sans nom, la session appelante. Un agent s'en sert quand vous devez répondre à quelque chose là-bas.
overvibe stop
Arrête la session et garde sa conversation pour plus tard. Un enfant attaché est aussi masqué de la liste, et --children ferme tous les enfants de la session appelante. Depuis une session, la commande n'atteint que cette session et celles qu'elle a lancées. Depuis un simple shell, vous pouvez arrêter n'importe laquelle.
overvibe move
Sessions Claude uniquement. Le déplacement attend la fin du tour en cours, puis reprend la session dans le nouveau dossier avec une note indiquant où elle se trouve désormais.
08Le schéma attach ponctuel
Pour lancer des tests, chercher dans un autre dépôt ou avoir un deuxième avis : attachez l'assistant, dites-lui comment répondre, terminez le tour et fermez-le quand la réponse est arrivée.
$ overvibe new --attach --tool codex --cwd ~/code/api --name "api: check tests" \ --prompt "Run the test suite and summarize failures. When done, run: overvibe send \"$OVERVIBE_SESSION\" \"<result>\"" # end the turn; the result arrives as a new message $ overvibe stop "api: check tests"
Terminez le tour après avoir délégué
Une réponse est tapée dans le prompt de la session qui attend et lue une fois le tour de cette session terminé. Un agent qui dort ou interroge en boucle bloque justement le message qu'il attend.
Dites à vos agents qu'elle existe
overvibe --help affiche l'usage complet avec des exemples, donc une ligne dans votre CLAUDE.md ou AGENTS.md qui y renvoie suffit. Les sessions Claude peuvent aussi s'écrire avec le SendMessage de Claude Code ; overvibe send sert à joindre Codex et agy.
Un exemple complet, étape par étape
Claude demande à Codex de relire une migration, récupère les remarques et ferme l'assistant. Lire l'exemple pas à pas