Mistrzostwo w aplikacji Codex

Masz monorepo z frontendem, backendowym API i współdzieloną biblioteką. Musisz zrefaktorować interfejs we współdzielonej bibliotece, zaktualizować konsumentów API i naprawić wynikające z tego błędy typów na frontendzie — wszystko tak, żeby trzy zadania nie wchodziły sobie nawzajem w pliki. Robienie tego sekwencyjnie oznacza czekanie; robienie tego w jednym wątku oznacza chaos. Aplikacja Codex została stworzona dokładnie do tego typu równoległej orkiestracji.

Czego się nauczysz

• Workflow do zarządzania wieloma projektami i równoległymi wątkami w jednym oknie aplikacji Codex
• Techniki wykorzystania synchronizacji IDE, dyktowania głosowego i inline’owego przeglądu diff, żeby skrócić czas review o połowę
• Strategia łączenia trybów Local, Worktree i Cloud w tej samej sesji
• Gotowe wzorce produkcyjne dla integracji skills i konfiguracji serwerów MCP w aplikacji

Orkiestracja wielu projektów

Sidebar aplikacji Codex to twoje centrum dowodzenia. Każdy projekt mapuje się na katalog na dysku i możesz przełączać się między nimi natychmiast. Kluczowa obserwacja jest taka, że każdy projekt utrzymuje własny sandbox, stan worktree i historię wątków.

1. Dodaj swoje projekty. Kliknij ”+” w sidebarze i wskaż katalog każdego codebase’u. W przypadku monorepo podziel odrębne pakiety na osobne projekty, żeby sandbox zawierał tylko istotne pliki.

2. Uruchom równoległe wątki. W ramach jednego projektu otwórz wiele wątków — jeden w trybie Local do szybkich edycji, jeden w trybie Worktree dla eksperymentalnego feature’a, jeden w trybie Cloud dla ciężkiego refaktoringu, który nie powinien blokować twojej maszyny.

3. Monitoruj skrzynkę. Wyniki automatyzacji i ukończone zadania chmurowe pojawiają się w sekcji Triage. Filtruj po “unread”, żeby skupić się na tym, co wymaga twojej uwagi.

Prompt: Konfiguracja równoległej pracy nad feature'ami

Otwórz trzy wątki Worktree w tym samym projekcie z tymi promptami:

Wątek 1: “Refactor the UserService interface to accept a generic ID type. Update all direct consumers in this package. Run the type checker after each change.”

Wątek 2: “Add integration tests for the payment webhook handler. Follow the patterns in tests/integration/. Run the test suite to verify.”

Wątek 3: “Update the API documentation in docs/api/ to reflect the new UserService interface. Cross-reference the existing OpenAPI spec.”

Synchronizacja IDE: pomost między aplikacją a edytorem

Gdy rozszerzenie Codex IDE Extension jest zainstalowane w VS Code lub Cursor i zarówno aplikacja, jak i IDE wskazują na ten sam projekt, synchronizują się automatycznie. Daje ci to dwie supermoce:

Automatyczny kontekst — Aplikacja śledzi, które pliki masz otwarte w edytorze. Gdy pytasz “What’s this file about?” w aplikacji, wie, że chodzi o plik, na który patrzysz w VS Code.

Dwukierunkowa widoczność wątków — Wątki uruchomione w aplikacji pojawiają się w sidebarze rozszerzenia IDE i odwrotnie. Możesz uruchomić ciężkie zadanie w aplikacji, przełączyć się na IDE, żeby kontynuować kodowanie, i obserwować postęp wątku bez przełączania kontekstu.

Gdy synchronizacja wprowadza zamieszanie

Jeśli aplikacja dołącza kontekst, którego się nie spodziewałeś, wyłącz “Auto context” w kompozytorze i zadaj pytanie ponownie. Automatyczny kontekst jest pomocny przy reaktywnej pracy, ale może dodawać szum, gdy skupiasz się na konkretnym pliku, który nie jest aktualnie otwarty w edytorze.

Wybór właściwego trybu

Każdy nowy wątek w aplikacji Codex prosi cię o wybór trybu. Oto jak podjąć decyzję:

Tryb	Kiedy używać	Kompromis
Local	Szybkie edycje, debugowanie, eksploracja kodu	Zmiany zachodzą bezpośrednio w katalogu roboczym — ryzyko konfliktów, jeśli wiele wątków dotyka tych samych plików
Worktree	Praca nad feature’ami, eksperymenty, równoległe zadania	Izolacja Git worktree oznacza brak konfliktów, ale musisz zsynchronizować lub zmergować zmiany z powrotem
Cloud	Ciężkie refaktoringi, zadania do delegowania, mobilna segregacja	Działa zdalnie, wymaga skonfigurowanego środowiska, nie ma dostępu do narzędzi tylko lokalnych

Prompt: Delegowanie refaktoringu do chmury

“Migrate all class components in src/components/ to functional components with hooks. Preserve all existing prop interfaces and test coverage. Use the existing ESLint and Prettier configs for formatting. Run the full test suite before finishing.”

Wbudowany workflow Git

Aplikacja zawiera kompletny workflow Git: przegląd diff, komentowanie inline, staging, commitowanie, pushowanie i tworzenie PR-ów. Panel diff pokazuje standardowy zunifikowany diff twoich zmian. Możesz:

• Dodawać komentarze inline, które Codex uwzględni w następnej turze
• Stagować lub wycofywać poszczególne fragmenty lub całe pliki
• Commitować, pushować i otwierać PR bez opuszczania aplikacji

Dla wątków worktree użyj “Create branch here”, żeby zamienić detached HEAD w nazwany branch, a potem wypchnij bezpośrednio do remote’a.

Skills w aplikacji

Aplikacja obsługuje te same agent skills co CLI i rozszerzenie IDE. Kliknij “Skills” w sidebarze, żeby przeglądać dostępne skills we wszystkich projektach. Aby jawnie wywołać skill w wątku, poprzedź go $:

$recent-code-bugfix

Łącz skills z automatyzacjami do cyklicznych zadań. Na przykład skill $dependency-audit w połączeniu z tygodniową automatyzacją utrzymuje twoje zależności przejrzane bez ręcznego wysiłku.

Zaawansowane skróty klawiaturowe

Skrót	Akcja
Cmd + J	Przełącz wbudowany terminal
Cmd + K	Otwórz paletę poleceń
Ctrl + M (przytrzymaj)	Dyktowanie głosowe
Ctrl + L	Wyczyść terminal

Wbudowany terminal jest ograniczony do bieżącego projektu lub worktree. Używaj go do uruchamiania testów, sprawdzania statusu gita lub wykonywania dowolnych poleceń bez opuszczania aplikacji.

Prompt: Głosowa segregacja błędów

Przytrzymaj Ctrl + M i powiedz: “Look at the error in the Sentry screenshot I’m about to paste. Find the root cause in the codebase, propose a fix, and write a regression test.”

Następnie upuść zrzut ekranu do kompozytora, gdy transkrypcja jest widoczna.

Gdy coś nie działa

• Konflikty branchy worktree: Git pozwala na checkout brancha tylko w jednym worktree naraz. Jeśli utworzysz branch na worktree i spróbujesz go checkoutować lokalnie, Git zgłosi błąd. Użyj “Sync with local” zamiast ręcznego checkoutu brancha.
• Miejsce na dysku z powodu worktree: Każdy worktree kopiuje cały twój repo. Archiwizuj wątki, których już nie potrzebujesz, żeby Codex mógł automatycznie wyczyścić worktree (starsze niż 4 dni lub gdy przekroczysz 10 worktree).
• Synchronizacja IDE nie działa: Zarówno aplikacja, jak i rozszerzenie IDE muszą wskazywać na ten sam root projektu. Sprawdź, czy żadne z nich nie wskazuje na katalog nadrzędny lub podrzędny drugiego.
• Powiadomienia nie działają: Zweryfikuj ustawienia powiadomień w preferencjach aplikacji. Na macOS sprawdź też Ustawienia systemowe > Powiadomienia dla aplikacji Codex.

Co dalej

• Worktree — szczegółowy przewodnik — Opanuj workflow synchronizacji, branchowania i mergowania
• Automatyzacje — Skonfiguruj cykliczne zadania w tle raportujące do twojej skrzynki
• Środowiska chmurowe — Skonfiguruj zdalne wykonywanie dla ciężkich obciążeń