Antigravity CLI nasıl kullanılır? Google agy için pratik rehber

Antigravity CLI, Google’ın terminalde çalışan kodlama ajanı. Tek bir betikle kuruyorsun, proje klasöründe agy yazıp başlatıyorsun, Google hesabınla giriş yapıyorsun ve ne istediğini anlatıyorsun. Dosyalarını okuyor, düzenleme ve komut öneriyor; varsayılan modda bir şeyi değiştirmeden önce soruyor.

Gemini CLI’ı kişisel bir hesapla kullanıyorduysan yolun buraya çıktı. Google 19 Mayıs 2026 tarihli geliştirici blog yazısında Gemini CLI’ın 18 Haziran 2026 itibarıyla Google AI Pro ve Ultra abonelerine ve bireyler için Gemini Code Assist’in ücretsiz kullanıcılarına hizmet vermeyeceğini duyurdu. Bu rehber kurulumu, girişi, proje talimatlarını, model ve effort seçimini, modları ve izinleri, MCP’yi, önemli komutları, Gemini CLI’dan geçişi ve Google’ın açıkladığı limitleri anlatıyor. Buradaki her şey Kasım 2026 itibarıyla Google’ın Antigravity belgelerine dayanıyor.

Antigravity CLI nedir, kimin için?

Antigravity CLI, Google’ın ajan odaklı geliştirme platformu Antigravity’nin terminal istemcisi. Google’a göre Go ile yazıldı ve ajan altyapısını Antigravity 2.0 masaüstü uygulamasıyla paylaşıyor; ajana gelen iyileştirmeler iki tarafa da yansıyor. Gemini CLI kullanıcılarının bildiği yapı taşları duruyor: agent skill’ler, hook’lar, alt ajanlar ve artık “plugin” adını alan eklentiler.

Şu durumdaysan senin için:

• Gemini CLI’ı kişisel Google hesabı, Google AI Pro ya da Ultra ile kullanıyordun;
• terminalde Gemini modelleriyle (planına göre başka modellerle de) çalışan bir kodlama ajanı istiyorsun;
• Antigravity’yi masaüstünde kullanıyorsun ve aynı ajanı SSH üzerinden ya da betiklerde de istiyorsun.

Gemini Code Assist Standard ya da Enterprise lisansı veya ücretli Gemini API anahtarı olan ekipler Gemini CLI’da kalabilir; o yol için Gemini CLI nasıl kullanılır rehberine bak. Google eksikleri saklamıyor: blog yazısı ilk günden birebir özellik eşitliği olmayacağını açıkça söylüyor.

Kurulum

macOS ve Linux’ta program ~/.local/bin/agy konumuna, Windows’ta AppData\Local\agy\bin altına kuruluyor. Kontrol et:

agy --version

Giriş

Projene geç ve başlat:

cd projem
agy

İlk açılışta renk şeması, görüntü modu (Alt-Screen ya da Inline) ve klasöre güvenip güvenmediğin soruluyor. Ardından tarayıcı açılıyor ve Google hesabınla giriş yapıyorsun. Free, Pro ve Ultra planlarındaki kişisel hesaplar çalışıyor; iş hesapları Gemini Enterprise üzerinden giriyor. Oturum anahtarı işletim sisteminin anahtar zincirinde (Keychain, Secret Service ya da Windows Credential Manager) saklanıyor, sonraki açılışlarda tarayıcı açılmıyor.

Diğer seçenekler:

• SSH üzerinden: agy bir adres yazdırıyor. Kendi bilgisayarında aç, giriş yap ve verilen kodu terminale yapıştır.
• Gemini API anahtarı: ~/.gemini/antigravity-cli/settings.json içinde "modelProvider": "gemini" ayarla ve GEMINI_API_KEY değişkenini tanımla. Bu ayar olmadan anahtar tek başına işe yaramıyor.
• Google Cloud kimlik bilgileri: gcloud auth application-default login çalıştır ve AGY_ADC_AUTH=true ayarla.

/logout kayıtlı girişi siler.

İlk görev

Ödeme modülünün yapısını açıkla, sonra iade endpoint'ine girdi doğrulaması
ekle ve testleri çalıştır.

İlk günden işe yarayan birkaç kısayol: @ dosya yolu önerir, istemin başındaki ! doğrudan kabuk komutu çalıştırır, ? yardımı ve slash komutlarını gösterir. Betikler için agy -p "README.md dosyasını özetle" tek bir istemi arayüzsüz çalıştırıp cevabı yazdırır; çıktıyı başka bir program okuyacaksa --output-format json ekle. agy -i "istem" etkileşimli arayüzü ilk istemle açar.

Proje talimatları: AGENTS.md ya da GEMINI.md

Antigravity, agy’yi başlattığın klasörde ve repo köküne kadar üst klasörlerde AGENTS.md ya da GEMINI.md dosyasını okur. İkisi de her zaman etkin ve frontmatter istemez. Global kurallar ~/.gemini/AGENTS.md ya da ~/.gemini/GEMINI.md içine yazılır. Kurallar birbirinin yerine geçmez, toplanır.

# Proje: billing-service

## Komutlar
- Kurulum: npm ci
- Test: npm test (bir işi bitti demeden önce çalıştır)

## Yapma
- src/generated içindeki dosyalara dokunma.

Daha ince kontrol için .agents/rules/ klasörüne Markdown dosyaları koyabilirsin. Her biri trigger alanlı bir frontmatter ister: always_on, model_decision, glob (ajan eşleşen dosyalara dokunduğunda devreye girer) ya da manual. Trigger yoksa ya da geçersizse kural sessizce yok sayılıyor; CLI kural anmayı desteklemediği için manual kurallar orada çalışmıyor. Dosyaları kısa tut: her dosya 24.000 bayttan sonra kesiliyor, global ve always_on kurallar da 20.000 tokenlık ortak bir bütçeyi paylaşıyor.

Codex ya da başka bir ajan zaten AGENTS.md okuyorsa Antigravity aynı dosyayı kullanır. Claude Code ile tek bir kural setini nasıl paylaşacağını CLAUDE.md nasıl yazılır yazısında bulabilirsin.

Modeller ve effort

Modeli tek bir çalıştırma için --model ile (agy models listeyi verir) ya da oturum içinde /model ile seçiyorsun. Google’ın model sayfası Gemini 3.8 Flash ve Gemini 3.1 Pro gibi Gemini modellerinin yanında Claude ve GPT-OSS modellerini de listeliyor; hangilerini göreceğin planına bağlı.

Effort, modelin ne kadar derin düşüneceğini belirler. /effort bir gösterge açar ve seçimini varsayılan olarak kaydeder; --effort low yalnızca o çalıştırma için geçerli. Seviyeler low, medium, high, xhigh ve max; ama çoğu model yalnızca low ile high arasını sunuyor, sabit bütçeli modeller ise bu ayarı yok sayıyor.

Modlar ve izinler

--mode=accept-edits (ya da auto, plan) ile başlatabilir, Shift+Tab ile geçiş yapabilir ya da ~/.gemini/antigravity-cli/settings.json içinde "agentMode" ayarlayabilirsin. auto için sandbox ve kişisel hesap gerekiyor (macOS ve Linux’ta v1.3.5+, Windows’ta v1.4.4+); iş hesaplarında yok. --sandbox oturumu terminal sandbox’ında çalıştırır.

Ayrıntılı kurallar aynı ayar dosyasında allow, ask ve deny listeleri olarak durur; örneğin command(git) ya da mcp(sql/execute_mutation). Deny, ask’ten; ask de allow’dan önce gelir. /permissions bunları arayüzde düzenler. --dangerously-skip-permissions her şeyi onaylar; yalnızca atılabilir bir ortamda kullan. Nedenini yapay zeka kodlama ajanı güvenliği yazısı anlatıyor.

MCP sunucuları

MCP sunucuları kendi dosyalarında duruyor: tüm projeler için ~/.gemini/config/mcp_config.json, tek bir çalışma alanı için .agents/mcp_config.json.

{
  "mcpServers": {
    "local-db": { "command": "node", "args": ["/path/to/server.js"] },
    "docs": { "serverUrl": "https://api.example.com/mcp/", "headers": { "Authorization": "Bearer TOKEN" } }
  }
}

Uzak sunucular Streamable HTTP kullanmak zorunda; eski HTTP+SSE taşıması ve httpUrl desteklenmiyor. /mcp durum, yeniden yükleme ve loglarla bir yönetici açar. İzin vermediğin araçlar Ask modunda çalışır.

Bilmeye değer komutlar

Kabuktan agy -c bu klasördeki son konuşmaya devam eder, --conversation <id> belirli bir konuşmayı açar. --add-dir çalışma alanına başka bir klasör ekler.

Gemini CLI’dan geçiş

Gemini CLI ayarları olan bir makinede agy’yi ilk çalıştırdığında bir kontrol listesi neyi taşımak istediğini soruyor: eklentiler, global ayarlar, oturum anahtarları ve görünüm ayarları. Google’ın geçiş rehberine göre neyin taşındığı, neyin taşınmadığı:

• Olduğu gibi kalan: projedeki GEMINI.md ve AGENTS.md, ~/.gemini/GEMINI.md ve ~/.gemini/skills/ içindeki global skill’ler.
• Dönüştürülen: eklentiler agy plugin import gemini ile plugine dönüşüyor; içlerindeki komutlar skill oluyor.
• Elle taşınacak: çalışma alanı skill’leri .gemini/skills/ yerine .agents/skills/ klasörüne; MCP sunucuları ~/.gemini/settings.json dosyasından mcp_config.json dosyasına, url ya da httpUrl alanı da serverUrl olarak.
• Garanti olmayan: bazı özel temalar ve görsel katmanlar.
• Bayraklar: --approval-mode yok, yerine --mode var. Yolo modu da yok.

Limitler ve fiyat

Google’ın plan sayfası CLI’ı her plana dahil ediyor ve kotaları rakam vermeden anlatıyor: Ultra en yüksek kotaya sahip ve beş saatte bir yenileniyor; Pro yüksek bir kotayı haftalık limite ulaşana kadar beş saatte bir yeniliyor; diğer planlarda kota haftalık yenileniyor. Limitler ajanın yaptığı iş miktarına göre işliyor. Pro ve Ultra’da kota bittiğinde AI kredileri Gemini Enterprise tüketim fiyatlarıyla devreye girebiliyor; bir ayarla bunu kapatabiliyorsun. Nerede olduğunu /usage ve /credits gösteriyor.

Claude Code ve Codex ile yan yana

Antigravity çoğu zaman kullandığın ajanlardan yalnızca biri. Birkaç alışkanlık işleri düzenli tutar:

• Tek kural dosyası. Antigravity ve Codex ikisi de AGENTS.md okuyor; Claude Code CLAUDE.md okuyor ve bu dosya AGENTS.md’ye yönlendirebilir.
• Her ajana bir worktree. Her ajana kendi git worktree’sini ver ki aynı dosyaları düzenlemesinler.
• Her yerde aynı MCP sunucuları. Her aracın kendi ayar dosyası var; aynı sunucuyu üç kez eklemen gerekiyor.

AgentVera’yı biz geliştiriyoruz: Antigravity CLI’ı Claude Code, Codex, Gemini CLI ve diğer ajanlarla yan yana, her birini kendi kurulumun ve girişinle gerçek bir terminalde çalıştıran macOS, Windows ve Linux masaüstü uygulaması. Antigravity özelinde (ayrıntılar):

• Çalışma alanı: Antigravity, proje başına ajan ızgarasında bir kutu; uygulama yeniden açıldığında kendi konuşmasına döner.
• İzinler: ajan başına Sor, Otomatik (--mode=accept-edits) ya da Tam erişim (--dangerously-skip-permissions).
• Model ve effort: ajanı oluştururken model ve low, medium ya da high effort seç.
• Talimatlar: agy’nin ek talimat bayrağı yok; kuralları AGENTS.md ya da GEMINI.md içinde tut.
• MCP yöneticisi: bir kez kurduğun sunucular açılışta Antigravity’ye, kendi mcp_config.json dosyanın yanına eklenir.
• Worktree’ler: Git panelinden bir worktree aç, Antigravity’yi orada, Claude Code’u başka birinde başlat.

Izgara, worktree’ler, kod incelemesi ve MCP yöneticisi ücretsiz planda. Google ve Anthropic ajanlarının karşılaştırması için Gemini CLI mı Claude Code mu yazısını oku ya da AgentVera’yı indir.

Özetle

Betikle kur, agy çalıştır, Google ile giriş yap ve mevcut AGENTS.md ya da GEMINI.md dosyanı koru. MCP sunucularını mcp_config.json dosyasına taşı, eklentileri agy plugin import gemini ile içe aktar, default ya da accept-edits modunda başla ve uzun oturumlardan önce /usage ile kotana bak.