Cómo sabe un hijo a quién informar. Cada sesión que inicia Overvibe recibe $OVERVIBE_SESSION en su entorno, con su id de tmux. La sesión madre lo pone en el encargo del hijo como dirección de respuesta, y overvibe stop lo usa para decidir qué puedes cerrar.
01Comandos
| Comando | Qué hace |
|---|---|
overvibe new | Inicia una sesión. --cwd es obligatorio. |
overvibe send | Escribe un mensaje en el prompt de una sesión: Claude, Codex o agy. |
overvibe ls | Lista las sesiones en marcha con estado, herramienta y carpeta. --json para los registros completos. |
overvibe resume | Retoma una sesión detenida o pasada en la misma conversación. overvibe ls --past las lista. |
overvibe attach | Abre una sesión en marcha en la terminal en la que estás (tmux attach). Ctrl-b d la deja corriendo. |
overvibe open | Muestra una sesión en tu pantalla en Overvibe. |
overvibe stop | Detiene una sesión. La conversación se conserva. |
overvibe move | Mueve una sesión de Claude a otra carpeta cuando termina su turno. |
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>"
--tooles claude por defecto.--namees lo que muestra la barra lateral y lo que buscaovervibe send. Que sea corto, proyecto y rol: "shop: codex review".--promptes el primer mensaje. En agy se escribe cuando aparece su cuadro de entrada.--mkdircrea antes una carpeta que falta (solo dentro de tu carpeta personal). Sin esta opción, una carpeta inexistente se rechaza.--attachla convierte en hija de la sesión que ejecuta el comando, anidada bajo ella en la barra lateral. Solo funciona desde dentro de una sesión de Overvibe.
Las opciones desconocidas se rechazan, así que una errata nunca inicia una sesión.
03overvibe send
El destino puede ser un id de tmux, un id de sesión, un nombre exacto o parte de uno (gana la coincidencia con actividad más reciente). El mensaje llega con una cabecera que nombra al remitente y el comando exacto para responder, con los saltos de línea convertidos en espacios:
$ 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.
Solo las sesiones de Overvibe pueden recibirlo. Una sesión en una pestaña normal de Terminal no tiene panel donde escribir, así que muévela a Overvibe antes.
04overvibe ls
$ overvibe ls
busy codex overvibe ↳ shop: codex review ~/code/shop
waiting claude overvibe shop: lead ~/code/shop
idle claude outside notes ~/notesColumnas: estado (busy, idle, waiting, blocked, ended), herramienta, si corre dentro o fuera de Overvibe, nombre (↳ marca un hijo adjunto) y carpeta.
05overvibe resume
$ overvibe ls --past $ overvibe resume "api: codex tests" --prompt "One more: also run the lint. Report back the same way."
Recupera una sesión detenida en su carpeta, con su nombre y su fila en la barra lateral; un ayudante detenido vuelve bajo su sesión padre. --prompt se escribe en cuanto arranca, --attach la convierte en hija de la sesión que llama y --fork inicia una copia en su lugar (solo Claude).
06overvibe attach
Abre una sesión en marcha en tu terminal actual a través de tmux. --print muestra el comando de tmux en lugar de ejecutarlo.
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
Abre esa sesión en tu pantalla; sin nombre, la sesión que llama. Un agente lo usa cuando tienes que responder algo allí.
overvibe stop
Detiene la sesión y guarda su conversación para después. Un hijo adjunto además se oculta de la lista, y --children cierra todos los hijos de la sesión que llama. Desde dentro de una sesión solo alcanza a esa sesión y a las que inició. Desde un shell normal puedes detener cualquiera.
overvibe move
Solo sesiones de Claude. El cambio espera a que termine el turno actual y luego reanuda la sesión en la nueva carpeta con una nota que dice dónde está ahora.
08El patrón attach de un solo uso
Para una ejecución de tests, una consulta en otro repo o una segunda opinión: adjunta el ayudante, dile cómo informar, termina el turno y ciérralo cuando llegue la respuesta.
$ 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"
Termina el turno después de delegar
Una respuesta se escribe en el prompt de la sesión que espera y se lee cuando termina el turno de esa sesión. Un agente que duerme o sondea esperando la respuesta bloquea justo el mensaje que espera.
Cuéntales a tus agentes que existe
overvibe --help imprime el uso completo con ejemplos, así que basta una línea en tu CLAUDE.md o AGENTS.md que apunte a él. Las sesiones de Claude también pueden escribirse entre sí con el SendMessage propio de Claude Code; overvibe send es como llegas a Codex y agy.
Un ejemplo completo, paso a paso
Claude le pide a Codex que revise una migración, recibe los hallazgos y cierra el ayudante. Lee el ejemplo completo