Antigravity CLI (agy) na serwerze

Od 18 czerwca 2026 Gemini CLI nie obsługuje już prywatnych kont darmowych, Google AI Pro ani Ultra. Ogłoszenie Google kieruje tych użytkowników do Antigravity CLI, czyli agy. Na serwerze uwagi wymagają: logowanie bez przeglądarki, wybór między logowaniem Google a kluczem API oraz to, jak agy obsługuje uprawnienia, gdy nikt nie siedzi przy terminalu. Omawiamy je po kolei.

Instalacja agy

Na Linuksie lub macOS, jako zwykły użytkownik (nie root):

curl -fsSL https://antigravity.google/cli/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"   # if ~/.local/bin isn't on PATH yet
command -v agy

Według oficjalnej strony instalacji plik binarny trafia do ~/.local/bin/agy, a obsługiwane są macOS, Linux i Windows. Instalator pobiera build dla danej platformy, z buildami linuksowymi dla amd64 i arm64, więc VPS na ARM jest w porządku. Dodaj linię z PATH do ~/.bashrc lub ~/.profile, żeby nowe powłoki i okna tmux ją widziały.

Jeden nawyk specyficzny dla serwera: agy aktualizuje się sam w tle. Na laptopie to wygodne. Na maszynie, którą zostawiasz włączoną, oznacza to, że wersja może się zmienić w trakcie długiej sesji. Maude przypina instalowaną wersję i wyłącza to przez AGY_CLI_DISABLE_AUTO_UPDATE=1. Jeśli chcesz tej samej przewidywalności, wyeksportuj tę zmienną w powłoce lub jednostce, która uruchamia agy.

Logowanie przez SSH

Uruchom agy w sesji SSH i wybierz logowanie przez Google. Na laptopie otworzyłoby przeglądarkę. Przez SSH wykrywa zdalną sesję i zamiast tego wypisuje URL autoryzacji. Następnie:

1. Skopiuj URL i otwórz go na telefonie lub laptopie.
2. Zaloguj się kontem Google, którego używasz do Antigravity.
3. Skopiuj kod podany przez stronę i wklej go z powrotem do terminala.

Dane logowania są przechowywane w pęku kluczy systemu, którym na Linuksie jest Secret Service. Goły VPS nie ma sesji graficznej, która odblokowałaby pęk kluczy. Zgłoszenie na GitHubie dotyczące agy 1.0.0 opisuje pętlę logowania na Linuksie bez interfejsu spowodowaną właśnie tym, plus błąd strefy czasowej w zapasowym zapisie do pliku. Obejściem zgłaszającego było GEMINI_FORCE_FILE_STORAGE=true TZ=UTC agy …. Nie potwierdziliśmy, czy obecne wersje nadal tego wymagają. Jeśli agy prosi o ponowne logowanie przy każdym uruchomieniu, zacznij od tego zgłoszenia. W przeciwnym razie użyj trybu klucza API.

Żeby się wylogować i usunąć zapisany profil, uruchom /logout w agy.

Tryb klucza API bez interfejsu

Do CI, współdzielonej maszyny albo dowolnego serwera, na którym wolisz nie trzymać sesji Google, uruchamiaj agy z kluczem API Gemini. Dokumentacja instalacji podaje dwa kroki. Najpierw ustaw dostawcę modeli w ~/.gemini/antigravity-cli/settings.json. Jeśli plik już istnieje, scal to z jego zawartością:

{
  "modelProvider": "gemini"
}

Następnie udostępnij klucz procesowi:

export GEMINI_API_KEY="…"   # e.g. in ~/.profile, or an EnvironmentFile for a systemd unit

To całkowicie pomija logowanie do konta. Użycie jest rozliczane za tokeny według cennika Gemini API, zamiast wliczać się w plan Google AI. Trzymaj klucz z dala od historii powłoki i od repozytorium, w którym pracuje agent.

Uprawnienia, gdy nikt nie patrzy

To zachowanie na serwerze zaskakuje ludzi najbardziej. W naszych testach na agy 1.2.14 uruchomienia bez interfejsu (agy -p … lub tryb stream-json) nie potrafią się zatrzymać i zapytać, zanim uruchomią narzędzie. Polecenie lub zapis pliku wymagający uprawnienia zostaje odrzucony, a wynik tury wymienia go jako odrzucony. Masz trzy sposoby, by przepuścić pracę:

• Reguły zezwalające. agy czyta je z permissions.allow w ~/.gemini/antigravity-cli/settings.json. Wpisy wyglądają jak "command(npm test)", "write_file(src/app.ts)" lub "command(*)". Są wczytywane przy starcie.
• Tryby. --mode accept-edits automatycznie zatwierdza edycje plików, choć polecenia nadal są odrzucane. --mode plan planuje bez działania.
• Bez żadnych kontroli. --dangerously-skip-permissions, na maszynę jednorazową. Zanim po to sięgniesz, przeczytaj bezpieczne uruchamianie agentów z pełnymi uprawnieniami.

Interaktywne agy w terminalu oraz Remote Control (poniżej) potrafią się zatrzymać i zapytać. To ograniczenie dotyczy więc konkretnie użycia skryptowego, bez interfejsu.

Przenoszenie konfiguracji Gemini CLI

Opisuje to przewodnik migracji. W skrócie, dla serwera, na którym było już Gemini CLI:

• Pierwsze uruchomienie proponuje migrację. Jeśli agy znajdzie istniejącą konfigurację Gemini CLI, pokaże listę kontrolną rozszerzeń i ustawień globalnych do konwersji.
• Rozszerzenia stają się pluginami. W dowolnej chwili uruchom agy plugin import gemini, by skonwertować rozszerzenia Gemini na pluginy Antigravity.
• Pliki kontekstu działają bez zmian. GEMINI.md (w workspace i ~/.gemini/GEMINI.md) oraz AGENTS.md są czytane bez modyfikacji.
• Serwery MCP wymagają drobnej edycji. Serwery globalne są w ~/.gemini/config/mcp_config.json, a serwery workspace'u w .agents/mcp_config.json. Zmień nazwy starych kluczy url/httpUrl na serverUrl.
• Skille się przenoszą. Skille workspace'u idą z .gemini/skills/ do .agents/skills/, a globalne do ~/.gemini/antigravity-cli/skills/. Musisz je przenieść sam.

Google przyznaje, że pełnej zgodności funkcji jeszcze nie ma, a przewodnik migracji zaznacza, że niektóre własne motywy i poprawki wizualne się nie przenoszą. Jeśli Twój sposób pracy zależy od konkretnego rozszerzenia, przetestuj je po imporcie, zanim usuniesz starą konfigurację.

Demon Remote Control vs Maude

Google ma oficjalny sposób dostępu do agy z innego urządzenia. Według dokumentacji Remote Control możesz go uruchomić na trzy sposoby:

• /remote-control w trwającej sesji. Tunel kończy się, gdy ta sesja CLI się zakończy.
• agy --remote-control przy uruchamianiu sesji. Ten tunel również kończy się wraz z sesją.
• Demon bez interfejsu: agy remote-control start --name my-vps, z agy remote-control status i agy remote-control stop. Rejestruje usługę systemową, która działa w tle.

Sterujesz nim z panelu webowego w dowolnej przeglądarce, po zalogowaniu się tym samym kontem Google. Według dokumentacji możesz zainstalować panel na ekranie głównym telefonu, żeby dostawać powiadomienia push, a na prośby o uprawnienia odpowiadać z terminala albo ze zdalnego interfejsu. Dokumentacja mówi też, że może go zablokować flaga funkcji na poziomie konta lub organizacji.

Jeśli Antigravity to jedyny agent, którego używasz, a flaga funkcji jest włączona dla Twojego konta, oficjalny demon to oczywisty pierwszy wybór. Jest darmowy i potrafi zapytać przed działaniem.

Sterowanie z telefonu

Jeśli chcesz mieć agy na serwerze obok innych agentów i sterować nim z natywnej aplikacji, jedną z opcji jest Maude. Dodaj serwer, a aplikacja zainstaluje agy w przetestowanej wersji i zaloguje Cię z telefonu. Możesz użyć logowania Google z wklejanym kodem albo klucza API Gemini. Mówiąc wprost o Antigravity w Maude: ponieważ Maude steruje agy w trybie bez interfejsu, nie może się zatrzymać i zapytać przed uruchomieniem narzędzia. Maude pokazuje Ci odrzuconą akcję, a jeśli ją zatwierdzisz, dodaje regułę zezwalającą i ponawia próbę. Szczegóły są na stronie agenta Antigravity. Samą zmianę w Gemini CLI i to, na co przesiedli się ludzie, opisuje nasz wpis o wyłączeniu Gemini CLI.

Najczęściej zadawane pytania

Co się zmieniło

• 1 października 2026 — Pierwsza publikacja. Instalacja, uwierzytelnianie, migracja i Remote Control sprawdzone w dokumentacji antigravity.google; zachowanie uprawnień bez interfejsu na podstawie naszych testów na agy 1.2.14.