Baza wiedzy

Agent AI w terminalu — praca na repozytorium

Agent w terminalu ma dostęp do plików, historii Gita i uruchamiania testów — dlatego jest szybszy od agenta w przeglądarce, ale wymaga twardych zabezpieczeń przy edycji i aktualizacji.

Opublikowano 2026-08-08 · Jakub Butryn, Founder · Lead engineer

Edycje z odciskiem treści

Bezpieczna edycja pliku nie polega na „znajdź i zamień”, a na zaadresowaniu konkretnych linii razem z odciskiem aktualnej treści. Jeśli plik zmienił się od odczytu, edycja jest odrzucana, a nie nadpisywana w ciemno.

To eliminuje najgroźniejszą klasę pomyłek: zamianę wykonaną na nieaktualnym stanie pliku, która cicho gubi cudze zmiany albo trafia w złe miejsce.

Git jako granica odpowiedzialności

Przed zmianą agent powinien wiedzieć, co jest zacommitowane, a co nie. Niezacommitowane zmiany to praca człowieka — agent ma się do nich dostosować, nie nadpisać ich. Historia Gita jest jedynym wiarygodnym źródłem tej granicy.

Dobra praktyka: przed serią zmian commit lub stash, po serii — przegląd `git diff`. Agent, który commituje własną tożsamością, dodatkowo zaśmieca listę autorów; warto ustawić dane commitera na właściciela repozytorium.

Aktualizacja nie może niszczyć pracy

Instalatory agentów często synchronizują katalog do najnowszej wersji poleceniem, które kasuje lokalne zmiany. Jeśli katalog instalacji jest jednocześnie katalogiem roboczym — a często jest — to jedna komenda potrafi usunąć tygodnie pracy.

Właściwe zachowanie: aktualizacja przerywa się przy niezapisanych zmianach, podpowiada trzy wyjścia, a wymuszenie robi kopię (gałąź zapasowa i stash) przed nadpisaniem.

Czego wymagać od agenta terminalowego

Dziennik działań, czytelne komunikaty błędów zamiast tracebacków, kod wyjścia zgodny z konwencją (przerwanie Ctrl+C = 130), autouzupełnianie komend, sprawdzanie aktualizacji bez blokowania startu i pełna pomoc dla każdej komendy.

To brzmi jak drobiazgi, ale decyduje o tym, czy narzędzie da się używać codziennie. Agent, który przy każdym wyjściu wypisuje traceback, uczy użytkownika ignorowania błędów — i to jest realny koszt.

Najczęstsze pytania

Czy agent AI w terminalu jest bezpieczny dla mojego repozytorium?

Jest, jeśli edytuje pliki z odciskiem aktualnej treści (edycja na nieaktualnym stanie zostaje odrzucona) i respektuje granicę niezacommitowanych zmian. Przed serią zmian zrób commit albo stash.

Czy aktualizacja agenta może usunąć moje zmiany?

Może, jeśli instalator synchronizuje katalog poleceniem kasującym lokalne zmiany. Poprawne zachowanie: przerwanie aktualizacji przy niezapisanych zmianach i kopia zapasowa przed nadpisaniem.

Omów swój przypadek — konsultacja bezpłatna Telegram @sotius