Harta unui codebase

Un repo pe care nu l-ai văzut niciodată, citit de trei agenți deodată.

Într-un codebase pe care nu-l cunoști, prima zi se duce pe căutat unde stau lucrurile. Îndreaptă o sesiune principală spre repo și ea împarte cititul: un ajutor ia stratul de date, altul API-ul, al treilea frontendul și buildul. Fiecare trimite înapoi un rezumat scurt cu căile fișierelor, iar sesiunea principală scrie din toate o singură privire de ansamblu.

Gratuit și open sourceRulează pe Mac și LinuxCu propriile tale loginuri Claude și Codex
Terminalul Claude Code al sesiunii principale după ce ajutoarele au raportat, cu rezumatul ei combinat
Înregistrat pe un calculator demo: sesiunea principală rezumă ce i-au trimis ajutoarele.

Cere-i unui agent să explice un repo mare și primești un tur al primului folder

O singură sesiune citește totul ea însăși, iar un repo mare nu încape. Părțile citite primele ies detaliate, iar restul primește câte o propoziție.

Un agent de unul singur
  • Un singur cititor care trece prin tot repo-ul
  • Detalii unde a început, presupuneri în rest
  • Fiecare întrebare ulterioară reia cititul de la capăt
Agenți unul lângă altul în Overvibe
  • Câte un ajutor pe zonă, toți citesc deodată
  • O privire de ansamblu scrisă din fiecare raport
  • Întrebările ulterioare merg la ajutorul care a citit partea aia

Trei cititoriși o privire de ansamblu

Tu scrii

Sunt nou în repo-ul ăsta. Pune niște ajutoare să mapeze părțile principale în paralel și scrie-mi o privire de ansamblu în ARCHITECTURE.md.

  1. 1Sesiunea principală împarte repo-ul

    Se uită la folderele de pe primul nivel și îi dă fiecărui ajutor o zonă și aceleași trei întrebări: ce e aici, ce apelează codul ăsta, ce e riscant de schimbat.

  2. 2Ajutoarele citesc, nimeni nu editează

    Fiecare în propriul terminal sub sesiunea principală, raportând ce a găsit, cu căile fișierelor.

  3. 3Privirea de ansamblu se întoarce

    Sesiunea principală scrie ARCHITECTURE.md din rapoarte și îl încheie cu ce încă nu știe.

În culise, câte un ajutor pe zonă. A doua linie e pentru mai târziu: ajutorul care a citit API-ul revine cu conversația lui și răspunde din ce a citit deja. Citește referința CLI

$ overvibe new --attach --tool codex --cwd . --name "repo: map api" \
    --prompt "Read src/api. What is here, what calls it, what is risky to change? Give paths. Do not edit. When done, run: overvibe send \"$OVERVIBE_SESSION\" \"<map>\""
$ overvibe resume "repo: map api" --prompt "Where does the API check auth?"

Un agent e suficient când

repo-ul e destul de mic ca să fie citit dintr-o dată sau te interesează doar un colț din el. Întreabă-l direct pe Claude. Ajutoarele își merită locul când repo-ul are mai multe părți și fiecare durează ceva de citit.

Întrebări

O să schimbe ajutoarele ceva?

Promptul le spune să nu schimbe nimic. Pentru un repo în care încă nu ai încredere, pornește-le cu --mode ask, ca fiecare tool să întrebe înainte să ruleze ceva, iar tu răspunzi în Overvibe.

Prin ce diferă de un brief de cercetare?

E același tipar, îndreptat spre cod. Brief-ul de cercetare se ocupă de surse din afara repo-ului, cum ar fi documentația, webul și exporturile.

Pot pune întrebări a doua zi?

Da. Oprește ajutoarele după ce ai privirea de ansamblu, iar overvibe resume aduce unul înapoi cu conversația lui când ai o întrebare despre partea lui.

Alte feluri de a pune agenții în perechi

Ia privirea de ansamblu înainte să citești codul

Instalează Overvibe, deschide o sesiune principală în repo și cere câte un ajutor pe zonă.

Aplicația Overvibe: un coordonator cu ajutoarele lui Codex și Gemini (agy) în bara laterală, fiecare cu starea lui, și o sesiune care te așteaptă