Google Antigravity CLI (agy): Polecenia i konfiguracja

Antigravity CLI (agy) to lekki, oparty na języku Go natywny agent programistyczny dla terminala w platformie Google Antigravity 2.0. Zaprojektowany do równoległego wykonywania subagentów, izolacji za pomocą Git worktree, Agent Skills, wtyczek oraz integracji MCP, agy zastępuje konsumenckie narzędzie Gemini CLI.

Ta ściągawka omawia flagi i podkomendy agy CLI, interaktywne komendy slash, skróty klawiszowe, konfigurację .agents/ i mcp_config.json oraz kroki migracji z Gemini CLI.

🔗 Powiązane ściągawki: Porównanie terminalowych agentów AI CLI · Ściągawka Claude Code CLI · Ściągawka OpenAI Codex CLI · Architektura i tworzenie AI Agent Skills

1. Instalacja, podkomendy i flagi startowe

1.1 Instalacja i uruchomienie

# Zainstaluj Antigravity CLI
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Uruchom interaktywny interfejs TUI (przy pierwszym uruchomieniu postępuj zgodnie z instrukcjami logowania na ekranie)
agy

1.2 Główne podkomendy i flagi startowe

Polecenie / Flaga	Opis	Przykład użycia
`agy`	Uruchom interaktywny interfejs TUI w aktywnym obszarze roboczym	`agy`
`agy -p "<prompt>"`	Wykonanie nieinteraktywne (headless), wypisuje wynik na stdout i kończy działanie	`agy -p "Summarize the last 5 commits"`
`agy -i "<prompt>"`	Uruchom interaktywną sesję wstępnie wypełnioną początkowym promptem	`agy -i "Refactor auth middleware under src/auth"`
`agy -c`, `--continue`	Wznów ostatnią sesję konwersacji	`agy -c`
`agy --conversation <id>`	Wczytaj konkretną historyczną konwersację po jej ID	`agy --conversation 42a506e6-...`
`--mode <mode>`	Ustaw tryb uprawnień wykonania: `default` · `accept-edits` · `auto` (autozatwierdzanie w piaskownicy) · `plan`	`agy --mode accept-edits`
`--model <model>`	Nadpisz aktywny model dla tej sesji	`agy --model gemini-3.8-flash`
`--effort <level>`	Ustaw nakład wnioskowania (`low` do `max`, zależnie od modelu)	`agy --effort high`
`--agent <agent>`	Podłącz niestandardowy profil agenta podczas uruchamiania	`agy --agent reviewer`
`--add-dir <path>`	Nadaj kontekstowi obszaru roboczego dostęp do dodatkowego katalogu (powtarzalna)	`agy --add-dir ../shared-types`
`agy models` / `agy agents`	Wyświetl listę dostępnych modeli lub skonfigurowanych agentów niestandardowych	`agy models`
`agy plugin <subcmd>`	Zarządzaj wtyczkami: `install` · `list` · `validate --strict` · `import gemini`	`agy plugin validate --strict ./my-plugin`

2. Interaktywne komendy slash w TUI

Wpisz / wewnątrz agy, aby wywołać i autouzupełniać wbudowane polecenia:

2.1 Sterowanie ogólne, sesją i historią

Polecenie	Funkcja	Uwagi i zastosowanie
`?` / `/help`	Wyświetl wszystkie dostępne komendy slash i skróty klawiszowe	Szybka pomoc kontekstowa w trakcie sesji
`/config` / `/settings`	Otwórz pełnoekranowy interaktywny panel ustawień	Edycja preferencji, motywów i uprawnień (`settings.json`)
`/clear`	Wyczyść bieżący bufor promptu i rozpocznij świeżą sesję	Czyste przejście do niepowiązanego zadania
`/compact`	Skompresuj i podsumuj historię konwersacji	Odzyskaj miejsce w oknie kontekstu podczas długich sesji
`/resume`	Otwórz wybór konwersacji, aby przywrócić wcześniejszą sesję	Kontynuuj przerwane przepływy pracy
`/rewind` / `/undo`	Cofnij się krok po kroku przez tury konwersacji	Wycofaj błędne tury lub kierunek pracy
`/fork`	Rozgałęź konwersację w bieżącym punkcie kontrolnym	Bezpiecznie testuj równoległe gałęzie obszaru roboczego
`/exit` / `/quit`	Zakończ sesję `agy` CLI	Lub naciśnij `Ctrl + D Ctrl + D`

2.2 Modele, przepływy pracy, agenci i rozszerzenia

Polecenie	Funkcja	Uwagi i zastosowanie
`/model`	Przełącz aktywny model AI w trakcie sesji	Równoważ szybkość/koszt względem mocy wnioskowania
`/effort`	Sprawdź lub ustaw nakład wnioskowania (`low` do `max`)	Uwaga: `agy -p "/effort"` zwraca wynik JSON tylko do odczytu
`/plan`	Wygeneruj plan krok po kroku przed modyfikacją plików	Bramka bezpieczeństwa przed dużymi zmianami architektonicznymi
`/goal`	Wykonuj zadanie autonomicznie aż do ukończenia bez przerw pośrednich	Dopasowane do zadań długohoryzontowych
`/grill-me`	Przeprowadź interaktywny wywiad wymagań przed rozpoczęciem kodowania	Wyjaśnij przypadki brzegowe i kryteria akceptacji na starcie
`/agent`	Przełącz lub wywołaj niestandardowe profile subagentów/agentów	Ładuje definicje z `.agents/agents/`
`/worktree`	Utwórz lub zarządzaj izolowanymi katalogami Git worktree	Pracuj na równoległych gałęziach bez zaśmiecania głównego drzewa
`/mcp`	Sprawdzaj stan połączeń MCP na żywo, logi i przeładuj konfigurację	Diagnozuj lokalne lub zdalne serwery MCP
`/plugin`	Przeglądaj, włączaj, wyłączaj lub sprawdzaj wtyczki Marketplace	Zarządzaj spakietowanymi umiejętnościami, regułami, hookami i serwerami MCP
`/voice`	Przełącz tryb dyktowania głosowego	Odpowiednik skrótu: `F5`

3. Skróty klawiszowe terminala i składnia wprowadzania

Skrót / Składnia	Działanie	Efekt i scenariusz
`@<path>`	Autouzupełnianie ścieżek plików	Wstrzykuje konkretne ścieżki plików lub katalogów do kontekstu
`!<command>`	Wykonanie polecenia w terminalu	Poprzedź znakiem `!`, aby bezpośrednio uruchamiać komendy shell (np. `!npm run build`)
`Ctrl + G`	Otwórz zewnętrzny edytor	Pisz długie lub wielowierszowe prompty w domyślnym edytorze (Vim, VS Code)
`Esc Esc`	Wyczyść aktywne pole promptu	Czyści oczekujące dane wejściowe, gdy żaden strumień nie jest aktywny
`F5`	Przełącz dyktowanie głosowe	Odpowiednik komendy `/voice`
`Ctrl + D Ctrl + D`	Zakończ sesję	Podwójne naciśnięcie `Ctrl + D` bezpiecznie zamyka sesję

4. Hierarchia konfiguracji i `mcp_config.json`

4.1 Mapa katalogów globalnych i projektowych

Warstwa	Zakres globalny (wszystkie obszary robocze)	Zakres obszaru roboczego (lokalny projektu)	Przeznaczenie
Ustawienia CLI	`~/.gemini/antigravity-cli/settings.json`	—	Preferencje CLI, motyw, edytor i domyślne uprawnienia
Skróty klawiszowe	`~/.gemini/antigravity-cli/keybindings.json`	—	Niestandardowe mapowania klawiszy w terminalu
Instrukcje projektu	`~/.gemini/AGENTS.md` lub `GEMINI.md`	`./AGENTS.md` lub `./GEMINI.md`	Trwałe konwencje repozytorium, komendy budowania/testów, persona
Reguły zawsze aktywne	`~/.gemini/config/rules/*.md`	`.agents/rules/*.md`	Ograniczenia działające w tle, automatycznie wstrzykiwane do kontekstu
Agent Skills	`~/.gemini/config/skills/<name>/SKILL.md`	`.agents/skills/<name>/SKILL.md`	Modułowe pakiety Agent Skills ze skryptami i zasobami
Konfiguracja MCP	`~/.gemini/config/mcp_config.json`	`.agents/mcp_config.json`	Definicje lokalnych serwerów MCP (stdio) i zdalnych (HTTP)

⚠️ Zmiana niekompatybilna w zdalnym MCP (serverUrl): W pliku mcp_config.json zdalne serwery HTTP MCP muszą używać klucza serverUrl zamiast starszych kluczy url lub httpUrl — użycie url powoduje ciche błędy połączenia.

{
  "mcpServers": {
    "remote-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "local-tool": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.example.com/mcp"]
    }
  }
}

5. Migracja ze starszego Gemini CLI do `agy`

Konsumencka warstwa bezpłatna oraz żądania Google AI Pro/Ultra w Gemini CLI zostały wygaszone 18 czerwca 2026 r. (pozostawiając wyłącznie korporacyjne Gemini Code Assist oraz płatne przepływy oparte na kluczach API). Kluczowe mapowania migracji do agy:

Komponent	Starsze Gemini CLI	Antigravity CLI (`agy`)	Działanie migracyjne
Środowisko i binarka	Otwartoźródłowy TypeScript (`gemini`)	Wieloagentowe CLI w Go (`agy`)	Przełącz wywołania na `agy`; kreator startowy uruchamia się automatycznie
Rozszerzenia	Rozszerzenia Gemini CLI	Natywne wtyczki Antigravity	Uruchom `agy plugin import gemini`, aby przekonwertować i zaimportować
Pliki instrukcji	`GEMINI.md`	`GEMINI.md` i `AGENTS.md`	Pełna zgodność — dotychczasowe pliki `GEMINI.md` działają bez zmian
Lokalna ścieżka Skills	`.gemini/skills/`	`.agents/skills/`	Przenieś katalogi umiejętności do `.agents/skills/<name>/SKILL.md`
Starsze przepływy (Workflows)	`.agents/workflows/`	Zmigrowane do Agent Skills	Przekonwertuj jednoplikowe workflow do `.agents/skills/` (`/migrate-workflows`)
Konfiguracja i klucze MCP	Wewnątrz `settings.json` z użyciem `url`	Dedykowany `mcp_config.json` z użyciem `serverUrl`	Wydziel bloki MCP do `mcp_config.json` i zmień nazwę `url` na `serverUrl`

Google Antigravity CLI (agy): Polecenia i konfiguracja — ściągawka

1. Instalacja, podkomendy i flagi startowe

1.1 Instalacja i uruchomienie

1.2 Główne podkomendy i flagi startowe

2. Interaktywne komendy slash w TUI

2.1 Sterowanie ogólne, sesją i historią

2.2 Modele, przepływy pracy, agenci i rozszerzenia

3. Skróty klawiszowe terminala i składnia wprowadzania

4. Hierarchia konfiguracji i `mcp_config.json`

4.1 Mapa katalogów globalnych i projektowych

5. Migracja ze starszego Gemini CLI do `agy`

Powiązane tematy

1. Instalacja, podkomendy i flagi startowe

1.1 Instalacja i uruchomienie

1.2 Główne podkomendy i flagi startowe

2. Interaktywne komendy slash w TUI

2.1 Sterowanie ogólne, sesją i historią

2.2 Modele, przepływy pracy, agenci i rozszerzenia

3. Skróty klawiszowe terminala i składnia wprowadzania

4. Hierarchia konfiguracji i mcp_config.json

4.1 Mapa katalogów globalnych i projektowych

5. Migracja ze starszego Gemini CLI do agy

Powiązane tematy

Powiązane materiały

4. Hierarchia konfiguracji i `mcp_config.json`

5. Migracja ze starszego Gemini CLI do `agy`