Bir sunucuda Antigravity CLI (agy)

18 Haziran 2026'dan beri Gemini CLI ücretsiz, Google AI Pro veya Ultra kişisel hesaplarına hizmet vermiyor. Google'ın duyurusu bu kullanıcıları Antigravity CLI'a, yani agy'ye yönlendiriyor. Bir sunucuda dikkat gerektiren kısımlar; tarayıcı olmadan oturum açmak, Google girişi ile API anahtarı arasında seçim yapmak ve terminalin başında kimse yokken agy'nin izinleri nasıl ele aldığını bilmek. Hepsi sırayla burada.

agy'yi kurun

Linux veya macOS'ta, normal (root olmayan) kullanıcınızla:

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

Resmi kurulum sayfası, ikili dosyanın ~/.local/bin/agy konumuna gittiğini söylüyor ve macOS, Linux ve Windows'u listeliyor. Yükleyici platforma özel bir yapı indirir; Linux için hem amd64 hem arm64 yapıları var, yani ARM bir VPS sorun değil. Yeni kabukların ve tmux pencerelerinin onu görmesi için PATH satırını ~/.bashrc veya ~/.profile dosyasına ekleyin.

Sunucuya özgü bir alışkanlık: agy kendini arka planda günceller. Bu bir dizüstünde kullanışlıdır. Çalışır halde bıraktığınız bir makinede ise sürümün uzun bir oturumun ortasında değişebileceği anlamına gelir. Maude kurduğu sürümü sabitler ve bunu AGY_CLI_DISABLE_AUTO_UPDATE=1 ile kapatır. Aynı öngörülebilirliği istiyorsanız, bu değişkeni agy'yi başlatan kabukta veya birimde dışa aktarın.

SSH ile oturum açma akışı

Bir SSH oturumunda agy başlatın ve Google ile oturum açmayı seçin. Dizüstünde bir tarayıcı açardı. SSH üzerinden uzak oturumu algılar ve bunun yerine bir yetkilendirme URL'si yazdırır. Ardından:

1. URL'yi kopyalayın ve telefonunuzda veya dizüstünüzde açın.
2. Antigravity için kullandığınız Google hesabıyla oturum açın.
3. Sayfanın verdiği kodu kopyalayın ve terminale geri yapıştırın.

Kimlik bilgileri işletim sisteminin anahtarlığında saklanır; Linux'ta bu Secret Service'tir. Çıplak bir VPS'te anahtarlığın kilidini açacak bir masaüstü oturumu yoktur. agy 1.0.0 için açılmış bir GitHub kaydı, headless Linux'ta tam olarak bundan kaynaklanan bir giriş döngüsünü ve dosya yedeğindeki bir saat dilimi hatasını bildiriyor. Bildirenin geçici çözümü GEMINI_FORCE_FILE_STORAGE=true TZ=UTC agy … idi. Güncel sürümlerin buna hâlâ ihtiyaç duyup duymadığını doğrulamadık. agy her başlatmada yeniden oturum açmanızı istiyorsa ilk bakılacak yer o kayıt. Aksi halde API anahtarı modunu kullanın.

Oturumu kapatmak ve kayıtlı profili silmek için agy içinde /logout çalıştırın.

Headless için API anahtarı modu

CI, paylaşılan bir makine ya da Google oturumu tutmak istemediğiniz herhangi bir sunucu için agy'yi bir Gemini API anahtarıyla çalıştırın. Kurulum belgeleri iki adım veriyor. Önce ~/.gemini/antigravity-cli/settings.json içinde model sağlayıcısını ayarlayın. Dosya zaten varsa bunu içeriğiyle birleştirin:

{
  "modelProvider": "gemini"
}

Ardından anahtarı sürece sağlayın:

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

Bu, hesap girişini tamamen atlar. Kullanım, bir Google AI planından düşmek yerine Gemini API fiyatlandırmasıyla token başına faturalandırılır. Anahtarı kabuk geçmişinden ve ajanın çalıştığı depodan uzak tutun.

Kimse izlemezken izinler

İnsanları en çok şaşırtan sunucu davranışı bu. agy 1.2.14 üzerindeki testlerimizde headless çalıştırmalar (agy -p … veya stream-json modu) bir araç çalışmadan önce durup soramıyor. İzin gerektiren bir komut veya dosya yazma işlemi reddedilir ve turun sonucu onu reddedilmiş olarak listeler. İşin geçmesine izin vermenin üç yolu var:

• İzin kuralları. agy bunları ~/.gemini/antigravity-cli/settings.json içindeki permissions.allow alanından okur. Girdiler "command(npm test)", "write_file(src/app.ts)" veya "command(*)" gibi görünür. Başlangıçta okunurlar.
• Modlar. --mode accept-edits dosya düzenlemelerini otomatik onaylar, ancak komutlar yine reddedilir. --mode plan harekete geçmeden plan yapar.
• Hiç kontrol yok. Atılabilir bir makine için --dangerously-skip-permissions. Ona başvurmadan önce ajanları tam izinlerle güvenle çalıştırma yazısına bakın.

Terminaldeki etkileşimli agy ve Remote Control (aşağıda) durup sorabilir. Yani bu sınırlama özellikle betikli, headless kullanım için geçerli.

Gemini CLI yapılandırmanızı taşımak

Bunu geçiş rehberi ele alıyor. Üzerinde zaten Gemini CLI bulunan bir sunucu için kısa versiyon:

• İlk başlatma geçiş önerir. agy mevcut Gemini CLI yapılandırması bulursa, dönüştürülecek uzantıların ve genel ayarların bir kontrol listesini gösterir.
• Uzantılar eklentiye dönüşür. Gemini uzantılarını Antigravity eklentilerine dönüştürmek için istediğiniz zaman agy plugin import gemini çalıştırın.
• Bağlam dosyaları olduğu gibi çalışır. GEMINI.md (çalışma alanında ve ~/.gemini/GEMINI.md) ve AGENTS.md değişiklik olmadan okunur.
• MCP sunucuları küçük bir düzenleme ister. Genel sunucular ~/.gemini/config/mcp_config.json, çalışma alanı sunucuları .agents/mcp_config.json içinde durur. Eski url/httpUrl anahtarlarını serverUrl olarak yeniden adlandırın.
• Skill'ler taşınır. Çalışma alanı skill'leri .gemini/skills/ konumundan .agents/skills/ konumuna, genel olanlar ~/.gemini/antigravity-cli/skills/ konumuna gider. Bunları kendiniz taşımanız gerekir.

Google henüz tam özellik eşitliği olmadığını söylüyor ve geçiş rehberi bazı özel temaların ve görsel ince ayarların taşınmadığını belirtiyor. Bir iş akışı belirli bir uzantıya bağlıysa, eski kurulumu silmeden önce içe aktarmanın ardından onu test edin.

Remote Control daemon'ı vs Maude

Google, agy'ye başka bir cihazdan ulaşmak için resmi bir yol sunuyor. Remote Control belgelerine göre onu üç şekilde başlatabilirsiniz:

• Çalışan bir oturumun içinde /remote-control. Tünel, o CLI oturumu kapandığında sona erer.
• Bir oturumu başlatırken agy --remote-control. Bu tünel de oturum kapandığında sona erer.
• Headless daemon: agy remote-control start --name my-vps, agy remote-control status ve agy remote-control stop ile. Arka planda çalışmaya devam eden bir işletim sistemi hizmeti kaydeder.

Onu, aynı Google hesabıyla oturum açarak herhangi bir tarayıcıdaki web panelinden kontrol edersiniz. Belgeler, anlık bildirim almak için paneli telefonunuzun ana ekranına kurabileceğinizi ve izin isteklerini terminalden ya da uzak arayüzden yanıtlayabileceğinizi söylüyor. Ayrıca bir hesap veya kuruluş özellik bayrağının onu engelleyebileceğini de belirtiyorlar.

Kullandığınız tek ajan Antigravity ise ve özellik bayrağı hesabınız için açıksa, resmi daemon apaçık ilk tercihtir. Ücretsizdir ve harekete geçmeden önce sorabilir.

Telefonunuzdan çalıştırın

agy'yi bir sunucuda diğer ajanların yanında ve yerel bir uygulamadan yönetmek istiyorsanız, Maude seçeneklerden biri. Sunucuyu ekleyin; uygulama agy'yi test edilmiş bir sürümde kurar ve sizi telefondan oturum açtırır. Yapıştırılan kodla Google girişini ya da bir Gemini API anahtarını kullanabilirsiniz. Maude'daki Antigravity konusunda açık olmak gerekirse: Maude headless agy'yi yönettiği için bir araç çalışmadan önce durup soramaz. Maude size reddedilen eylemi gösterir ve onaylarsanız bir izin kuralı ekleyip yeniden dener. Ayrıntılar Antigravity ajan sayfasında. Gemini CLI değişikliğinin kendisi ve insanların hangi seçeneklere geçtiği Gemini CLI kapatılma yazımızda ele alınıyor.

Sıkça sorulan sorular

Neler değişti

• 1 Ekim 2026 — İlk yayın. Kurulum, kimlik doğrulama, geçiş ve Remote Control ayrıntıları antigravity.google belgeleriyle karşılaştırılarak kontrol edildi; headless izin davranışı agy 1.2.14 üzerindeki kendi testlerimizden.