Integracja z GitHub

Twoj zespol otwiera pull request, recenzent jest zajety przez dwa dni, a PR lezy bezczynnie. Tymczasem inny czlonek zespolu wspomina o bugu w issue i nikt nie ma przepustowosci aby to zbadac. A co jesli agent mogl przegladac kazdy PR w ciagu minut od otwarcia i zaczac pracowac nad komentarzami do issues w momencie ich opublikowania? Dokladnie to robi Codex po polaczeniu z GitHub.

Co wyniesiesz z tego przewodnika

• Codex Cloud polaczony z repozytorium GitHub
• @codex review dzialajacy na pull requestach do przegladow kodu na zadanie
• Automatyczne przeglady kodu wlaczone dla kazdego nowego PR
• Wzmianki @codex w issues i komentarzach PR wyzwalajace zadania w chmurze
• Wytyczne przegladu w AGENTS.md dostosowujace co Codex oznacza
• Dzialajacy workflow od issue przez PR do merge

Wymagania wstepne

Integracja z GitHub wymaga:

• Subskrypcji ChatGPT (Plus, Pro, Business lub Enterprise) — uwierzytelnianie kluczem API nie obsluguje funkcji chmurowych
• Srodowiska Codex Cloud skonfigurowanego z twoim repozytorium
• Dostepu administratora repozytorium (lub kogos z dostepem administratora do zatwierdzenia aplikacji Codex GitHub)

Polaczenie repozytorium z Codex Cloud

1. Otworz chatgpt.com/codex w przegladarce.

2. Przejdz do Settings > Environments i kliknij New Environment.

3. Polacz swoje konto GitHub jesli jeszcze tego nie zrobiles. Instaluje to aplikacje Codex GitHub na twoim koncie lub organizacji.

4. Wybierz repozytorium z ktorym chcesz aby Codex pracowal.

5. Skonfiguruj srodowisko: wybierz branch, ustaw wymagane zmienne srodowiskowe i zdefiniuj polecenia konfiguracji (jak npm install lub pip install -r requirements.txt).

6. Zapisz srodowisko. Codex moze teraz uruchamiac zadania w chmurze dla tego repozytorium.

Notatka

Mozesz polaczyc wiele repozytoriow, kazde z wlasna konfiguracja srodowiska. Codex Cloud uruchamia oddzielne srodowisko dla kazdego zadania.

Przeglady kodu na zadanie

Gdy twoje repozytorium jest polaczone, kazdy wspolpracownik moze poprosic o przeglad Codex komentujac pull request.

Popros o przeglad

Dodaj komentarz na dowolnym PR:

@codex review

Codex reaguje emoji oczek aby potwierdzic zadanie, czyta diff PR-a i publikuje standardowy przeglad kodu GitHub z komentarzami inline — tak jak ludzki recenzent.

Skoncentruj przeglad

Mozesz zawezic przeglad do konkretnych zagadnien:

@codex review for security regressions

@codex review focusing on error handling and edge cases

@codex review the database migration for data loss risks

Wskazówka

Prompt do przetestowania pierwszego przegladu kodu:

Otworz dowolny istniejacy PR w polaczonym repozytorium i skomentuj:

@codex review

W ciagu kilku minut Codex powinien opublikowac przeglad. Jesli nic sie nie dzieje, zweryfikuj ze repozytorium ma wlaczony Codex Cloud i ze przeglad kodu jest wlaczony w ustawieniach.

Wlaczenie automatycznych przegladow

Jesli chcesz aby Codex przegladal kazdy PR bez pytania:

1. Przejdz do chatgpt.com/codex/settings/code-review.

2. Wlacz Automatic reviews dla swojego repozytorium.

3. Zapisz. Od teraz Codex publikuje przeglad za kazdym razem gdy nowy PR jest otwarty do przegladu.

Automatyczne przeglady uzywaja tych samych wytycznych z twoich plikow AGENTS.md. Codex domyslnie oznacza tylko problemy P0 i P1 — nie czepia sie formatowania ani stylu chyba ze twoj AGENTS.md mu to kaze.

Dostosowanie wytycznych przegladu

Codex stosuje wytyczne z najblizszego AGENTS.md do kazdego zmienionego pliku. Dodaj sekcje “Review guidelines” do AGENTS.md twojego projektu:

## Review guidelines

- Flag any API endpoint missing authentication middleware.
- Flag any database query using string interpolation instead of parameterized inputs.
- Verify that new dependencies have an active maintainer and more than 1000 weekly npm downloads.
- Treat typos in user-facing strings as P1 issues.
- Do not flag formatting issues -- ESLint handles those.

Dla kontroli specyficznej dla pakietu, umieszczaj bardziej ukierunkowany AGENTS.md glebiej w drzewie:

packages/payments/AGENTS.md

## Review guidelines

- Every change to payment logic must include a test case.
- Flag any modification to the refund flow that does not update the audit log.
- Verify PCI compliance: no card numbers logged, no plaintext storage.

Wyzwalanie zadan Cloud z GitHub

@codex review to jedno konkretne polecenie. Kazda inna wzmianka @codex w komentarzu PR lub issue wyzwala ogolne zadanie w chmurze uzywajac PR lub issue jako kontekstu.

Napraw bledy CI

Gdy CI jest na czerwono na PR, skomentuj:

@codex fix the CI failures

Codex uruchamia zadanie w chmurze, czyta logi CI, identyfikuje nieudane testy i pushuje commit z poprawka na branch PR-a.

Zaimplementuj z issue

Na issue opisujacym buga lub prosbe o funkcje, skomentuj:

@codex implement this

Codex tworzy nowy branch, implementuje zmiany na podstawie opisu issue i otwiera PR.

Zaadresuj komentarze z przegladu

Po przegladzie PR ludzki recenzent moze dodac feedback. Codex moze go zaadresowac:

@codex address the review feedback

Wskazówka

Prompt do delegowania prawdziwego zadania z GitHub:

Otworz issue w polaczonym repozytorium i skomentuj:

@codex investigate this issue, identify the root cause, and suggest a fix in a new PR

Obserwuj dashboard Codex Cloud pod chatgpt.com/codex aby monitorowac postep w czasie rzeczywistym.

Pelny workflow PR

Oto jak wyglada pelny workflow z Codex i GitHub:

1. Deweloper otwiera issue opisujace buga.

2. Deweloper (lub bot) komentuje @codex implement a fix for this issue.

3. Codex Cloud uruchamia zadanie, czyta issue, klonuje repozytorium, identyfikuje przyczyne, implementuje poprawke i otwiera PR.

4. Codex automatycznie przegladada PR (jesli automatyczne przeglady sa wlaczone) lub czlonek zespolu komentuje @codex review.

5. Ludzki recenzent czyta przeglad Codex, dodaje wlasny feedback.

6. Jesli potrzebne sa zmiany, skomentuj @codex address the review feedback na PR.

7. Codex pushuje kolejne commity.

8. Recenzent zatwierdza i merguje.

Lokalne powierzchnie i Git

Aplikacja, CLI i rozszerzenie IDE rowniez integruja sie z Git, ale pracuja z twoim lokalnym repozytorium a nie przez API GitHub.

Aplikacja

Aplikacja Codex ma wbudowane narzedzia Git: przegladanie diff-ow, stagowanie/unstage-owanie plikow i hunkow, commitowanie, pushowanie i tworzenie PR-ow bezposrednio z panelu przegladu. Watki Worktree automatycznie tworza izolowane branche.

CLI

CLI uruchamia polecenia git w katalogu twojego projektu. Popros Codex o commitowanie, pushowanie lub tworzenie branchy. Uzyj /review w TUI do lokalnego przegladu kodu przed pushowaniem.

Rozszerzenie IDE

Rozszerzenie IDE moze delegowac do Cloud dla workflow-ow opartych o PR lub pracowac lokalnie z twoim stanem Git. Wspoldzieli kontekst worktree z Aplikacja gdy oba sa otwarte.

Gdy cos nie dziala

@codex nie odpowiada na komentarze: Zweryfikuj ze aplikacja Codex GitHub jest zainstalowana na organizacji/koncie repozytorium. Sprawdz czy repozytorium ma skonfigurowane srodowisko Codex Cloud. Aplikacja Codex potrzebuje dostepu do odczytu i zapisu komentarzy.

Przeglad nie oznacza oczekiwanych problemow: Codex domyslnie oznacza tylko problemy P0 i P1. Dodaj jawne wytyczne przegladu do AGENTS.md. Na przyklad dodaj “Treat typos in docs as P1” jesli chcesz aby Codex wylapywal literowki.

Zadanie Cloud nie tworzy PR: Sprawdz konfiguracje srodowiska pod chatgpt.com/codex. Upewnij sie ze polecenia konfiguracji uruchamiaja sie pomyslnie (Codex musi zbudowac projekt). Sprawdz czy uprawnienia brancha na GitHub pozwalaja aplikacji Codex na pushowanie.

Blad “MFA required”: Codex Cloud wymaga uwierzytelniania wieloskladnikowego. Wlacz MFA na swoim koncie ChatGPT (lub u dostawcy logowania spolecznosciowego).

Codex tworzy PR, ale CI nie przechodzi: Codex nie zawsze uruchamia pelny pipeline CI przed otwarciem PR. Dodaj "Always run the test suite before opening a PR" do wytycznych przegladu w AGENTS.md, aby Codex uwzglednil ten krok.

Wskazówka

Prompt do weryfikacji integracji z GitHub od poczatku do konca:

Utworz testowe issue w polaczonym repozytorium:

Title: Test: Codex GitHub integration
Body: @codex tell me about this repository's structure

Jesli Codex odpowie komentarzem o strukturze twojego repozytorium, integracja dziala w pelni.

Co dalej

Uruchom swoje pierwsze zadanie Wykonaj prawdziwe zadanie Codex na wszystkich czterech powierzchniach i zobacz wyniki