Como um filho sabe a quem responder. Toda sessão que o Overvibe inicia recebe $OVERVIBE_SESSION no ambiente, com o id tmux dela. A sessão-mãe coloca esse valor no briefing do filho como endereço de resposta, e overvibe stop usa o mesmo valor para decidir o que você pode fechar.
01Comandos
| Comando | O que faz |
|---|---|
overvibe new | Inicia uma sessão. --cwd é obrigatório. |
overvibe send | Digita uma mensagem no prompt de uma sessão: Claude, Codex ou agy. |
overvibe ls | Lista as sessões em execução com status, ferramenta e pasta. --json para os registros completos. |
overvibe resume | Continua uma sessão parada ou antiga na mesma conversa. overvibe ls --past lista essas sessões. |
overvibe attach | Abre uma sessão em execução no terminal onde você está (tmux attach). Ctrl-b d sai e deixa ela rodando. |
overvibe open | Traz uma sessão para a sua tela no Overvibe. |
overvibe stop | Para uma sessão. A conversa fica guardada. |
overvibe move | Move uma sessão Claude para outra pasta quando o turno dela termina. |
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>"
--toolé claude por padrão.--nameé o que a barra lateral mostra e o queovervibe sendusa para encontrar a sessão. Mantenha curto, projeto e papel: "shop: codex review".--prompté a primeira mensagem. No agy, ela é digitada assim que a caixa de entrada do agy aparece.--mkdircria antes a pasta que não existe (só dentro da sua pasta pessoal). Sem ele, uma pasta inexistente é recusada.--attachtorna a sessão filha da sessão que roda o comando, aninhada sob ela na barra lateral. Só funciona de dentro de uma sessão do Overvibe.
Flags desconhecidas são rejeitadas, então um erro de digitação nunca inicia uma sessão.
03overvibe send
O alvo pode ser um id tmux, um id de sessão, um nome exato ou parte de um nome (vence a correspondência ativa mais recente). A mensagem chega com um cabeçalho que nomeia o remetente e o comando exato de resposta, com as quebras de linha trocadas por espaços:
$ 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.
Só sessões do Overvibe podem receber. Uma sessão em uma aba comum do Terminal não tem painel para digitar, então traga a sessão para dentro antes.
04overvibe ls
$ overvibe ls
busy codex overvibe ↳ shop: codex review ~/code/shop
waiting claude overvibe shop: lead ~/code/shop
idle claude outside notes ~/notesColunas: status (busy, idle, waiting, blocked, ended), ferramenta, se roda no Overvibe ou fora dele, nome (↳ marca um filho anexado) e pasta.
05overvibe resume
$ overvibe ls --past $ overvibe resume "api: codex tests" --prompt "One more: also run the lint. Report back the same way."
Traz de volta uma sessão parada na pasta dela, com o nome e a linha na barra lateral; um auxiliar parado volta sob a sessão-mãe. --prompt é digitado assim que ela sobe, --attach a torna filha da sessão que chamou, e --fork abre uma cópia (só no Claude).
06overvibe attach
Abre uma sessão em execução no seu terminal atual pelo tmux. --print mostra o comando do tmux em vez de rodá-lo.
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 essa sessão na sua tela; sem nome, a sessão que chamou. Um agente usa isso quando você precisa responder algo por lá.
overvibe stop
Para a sessão e guarda a conversa para depois. Um filho anexado também some da lista, e --children fecha todos os filhos da sessão que chamou. De dentro de uma sessão, ele alcança só essa sessão e as que ela iniciou. De um shell comum, você pode parar qualquer uma.
overvibe move
Só sessões Claude. A mudança espera o turno atual terminar e depois retoma a sessão na nova pasta, com um aviso dizendo onde ela está agora.
08O padrão attach de uma vez
Para rodar testes, consultar outro repositório ou ter uma segunda opinião: anexe o auxiliar, diga como ele deve responder, encerre o turno e feche o auxiliar quando a resposta chegar.
$ 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"
Encerre o turno depois de delegar
Uma resposta é digitada no prompt da sessão que espera e lida quando o turno dessa sessão acaba. Um agente que dorme ou fica consultando a resposta bloqueia justamente a mensagem que está esperando.
Conte aos seus agentes que ela existe
overvibe --help mostra o uso completo com exemplos, então uma linha no seu CLAUDE.md ou AGENTS.md apontando para ele basta. Sessões Claude também podem trocar mensagens com o SendMessage do próprio Claude Code; overvibe send é como você chega ao Codex e ao agy.
Um exemplo completo, passo a passo
O Claude pede ao Codex que revise uma migration, recebe os achados e fecha o auxiliar. Leia o passo a passo