CLI-Referenz

Ein Befehl, mit dem Agents
Agents starten und anschreiben

overvibe spricht mit deinem Token mit der laufenden App auf 127.0.0.1, also kann jede Shell auf deinem Mac es nutzen, ebenso jeder Agent in einer Overvibe-Session. ov ist die Kurzform, und der alte Name deck funktioniert weiterhin.

Woher ein Kind weiß, wem es berichtet. Jede Session, die Overvibe startet, bekommt $OVERVIBE_SESSION in ihre Umgebung, ihre tmux-ID. Die Eltern-Session schreibt sie als Antwortadresse in den Auftrag des Kindes, und overvibe stop entscheidet damit, was du schließen darfst.

01Befehle

BefehlWas er tut
overvibe newStartet eine Session. --cwd ist Pflicht.
overvibe sendTippt eine Nachricht in den Prompt einer Session: Claude, Codex oder agy.
overvibe lsListet laufende Sessions mit Status, Tool und Ordner. --json für die vollständigen Datensätze.
overvibe resumeSetzt eine gestoppte oder frühere Session mit derselben Unterhaltung fort. overvibe ls --past listet sie auf.
overvibe attachÖffnet eine laufende Session in deinem aktuellen Terminal (tmux attach). Mit Ctrl-b d verlässt du sie, und sie läuft weiter.
overvibe openHolt eine Session in Overvibe auf deinen Bildschirm.
overvibe stopStoppt eine Session. Die Unterhaltung bleibt erhalten.
overvibe moveVerschiebt eine Claude-Session nach Ende ihres Turns in einen anderen Ordner.

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 ist standardmäßig claude.
  • --name zeigt die Seitenleiste an, und darauf matcht overvibe send. Halte ihn kurz, Projekt und Rolle: "shop: codex review".
  • --prompt ist die erste Nachricht. Bei agy wird sie eingetippt, sobald das Eingabefeld von agy da ist.
  • --mkdir legt einen fehlenden Ordner vorher an (nur unterhalb deines Home-Ordners). Ohne die Option wird ein fehlender Ordner abgelehnt.
  • --attach macht sie zum Kind der Session, die den Befehl ausführt, und hängt sie in der Seitenleiste darunter. Funktioniert nur innerhalb einer Overvibe-Session.

Unbekannte Flags werden abgelehnt, ein Tippfehler startet also nie eine Session.

03overvibe send

Das Ziel kann eine tmux-ID, eine Session-ID, ein exakter Name oder ein Teil davon sein (der zuletzt aktive Treffer gewinnt). Die Nachricht kommt mit einem Header an, der den Absender und den genauen Antwortbefehl nennt, Zeilenumbrüche werden zu Leerzeichen:

$ 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.

Nur Overvibe-Sessions können sie empfangen. Eine Session in einem normalen Terminal-Tab hat kein Pane zum Hineintippen, also hol sie vorher herein.

04overvibe ls

$ overvibe ls
busy     codex  overvibe ↳ shop: codex review          ~/code/shop
waiting  claude overvibe shop: lead                    ~/code/shop
idle     claude outside  notes                         ~/notes

Spalten: Status (busy, idle, waiting, blocked, ended), Tool, ob sie in Overvibe oder außerhalb läuft, Name (↳ kennzeichnet ein angehängtes Kind) und Ordner.

05overvibe resume

$ overvibe ls --past
$ overvibe resume "api: codex tests" --prompt "One more: also run the lint. Report back the same way."

Holt eine gestoppte Session in ihrem Ordner zurück, mit ihrem Namen und ihrer Zeile in der Seitenleiste; ein gestoppter Helfer kommt unter seiner Eltern-Session zurück. --prompt wird getippt, sobald sie läuft, --attach macht sie zum Kind der aufrufenden Session, und --fork startet stattdessen eine Kopie (nur Claude).

06overvibe attach

Öffnet eine laufende Session über tmux in deinem aktuellen Terminal. --print zeigt den tmux-Befehl, statt ihn auszuführen.

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

Öffnet diese Session auf deinem Bildschirm; ohne Namen die aufrufende Session. Ein Agent nutzt das, wenn du dort etwas beantworten musst.

overvibe stop

Stoppt die Session und behält ihre Unterhaltung für später. Ein angehängtes Kind wird außerdem aus der Liste ausgeblendet, und --children schließt alle Kinder der aufrufenden Session. Innerhalb einer Session erreicht der Befehl nur diese Session und die, die sie gestartet hat. Aus einer normalen Shell kannst du jede stoppen.

overvibe move

Nur Claude-Sessions. Der Umzug wartet, bis der aktuelle Turn endet, und setzt die Session dann im neuen Ordner fort, mit einem Hinweis, wo sie jetzt ist.

08Das One-Shot-Attach-Muster

Für einen Testlauf, eine Recherche in einem anderen Repo oder eine zweite Meinung: Hänge den Helfer an, sag ihm, wie er berichten soll, beende den Turn und schließ ihn, wenn die Antwort da ist.

$ 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"

Beende den Turn nach der Übergabe

Eine Antwort wird in den Prompt der wartenden Session getippt und gelesen, sobald deren Turn vorbei ist. Ein Agent, der auf die Antwort wartet, indem er schläft oder pollt, blockiert genau die Nachricht, auf die er wartet.

Sag deinen Agents, dass es das gibt

overvibe --help gibt die vollständige Nutzung mit Beispielen aus, also reicht eine Zeile in deiner CLAUDE.md oder AGENTS.md, die darauf verweist. Claude-Sessions können sich auch über das eigene SendMessage von Claude Code schreiben; mit overvibe send erreichst du Codex und agy.

Ein vollständiges Beispiel, Schritt für Schritt

Claude bittet Codex, eine Migration zu prüfen, bekommt die Befunde und schließt den Helfer. Zur Schritt-für-Schritt-Anleitung

Gib deine nächste Aufgabe ab

Kostenlos und Open Source. Claude Code, Codex und Gemini arbeiten auf deinem Mac am selben Job.