# 🤖 Antigravity Telegram Suite
**Hem [Antigravity Standalone App](https://antigravity.google/) hem de [Antigravity IDE](https://antigravity.google/) ile çalışır.**
🌍 Diller: [English](README.md) | [中文](README.zh.md) | [한국어](README.ko.md) | [Türkçe](README.tr.md) | [Deutsch](README.de.md) | [Español](README.es.md) | [Français](README.fr.md)
Antigravity AI ajanınızı Telegram üzerinden uzaktan kontrol edin.
Telefonunuzdan mesaj gönderin, yapay zeka modellerini değiştirin, çalışma alanlarını (workspace) yönetin, ekran görüntüsü alın ve çoklu ajan (multi-agent) iş akışlarını çalıştırın.
[](LICENSE)
[](https://nodejs.org)
[]()
[]()
---
## 📢 Topluluk
- **Duyuru Kanalı:** [@agts_updates](https://t.me/agts_updates)
- **Sohbet Grubu:** [@agts_community](https://t.me/agts_community)
## ✨ Özellikler
| Özellik | Açıklama |
|---|---|
| 💬 **Headless Chat** | Telegram üzerinden AI ajanına doğrudan mesaj gönderin |
| 📎 **Dosya ve Görsel Yükleme** | Ajanınıza açıklamalarla birlikte dosya/görsel iletin |
| 📸 **IDE Ekran Görüntüsü** | Uzaktan IDE'nin ekran görüntüsünü alın |
| 🤖 **Model ve Efor Seçimi** | Satıriçi (inline) butonlarla AI modelini ve düşünme efor seviyesini (Düşük / Orta / Yüksek) değiştirin |
| 📂 **Dosya Gezgini** | Proje dosyalarınızda gezinin ve indirin |
| 🔄 **Workspace Yönetimi** | Klavyeye dokunmadan projeler arası geçiş yapın |
| 🪟 **Çoklu Pencere Desteği** | Birden fazla IDE açıkken komutları belirli bir pencereye yönlendirin |
| 👥 **Çoklu Kullanıcı (Multi-User)** | Virgülle ayrılmış Chat ID'leri ile botunuzu ekibinizle paylaşın |
| 💬 **İnteraktif Sohbet Yönetimi** | Son sohbetler, proje klasörleri, hızlı arama (`/agents `) ve 2ms anında geçiş butonları |
| ⚡ **Oto-Onay (Auto-Accept)** | DOM MutationObserver ile Run, Accept, Allow butonlarına otomatik tıklayın |
| 🚀 **Turbo Mod** | Çoklu ajan orkestrasyonu: Claude planlar → Gemini kodlar → Claude inceler → Gemini düzeltir |
| 🎯 **Goal Modu** | Otonom uzun süreli görevler — ajan hedef tamamlanıncaya kadar çalışır |
| 📋 **Plan Modu** | Kodlamadan önce uygulama planı oluşturur |
| 🔔 **Proaktif Bildirimler** | TaskWatcher, ajanın kendiliğinden gönderdiği mesajları (timer, alt-ajan) Telegram’a iletir |
| 🤔 **Mesaj Reaksiyonları** | İşlem sırasında 🤔 gösterir, tamamlanınca temizler |
| 🔄 **Oto-Güncelleme** | Tek bir komutla güncellemeleri kontrol edin ve botu güncelleyin |
| 🌐 **Çoklu Dil** | 7 dil desteği: İngilizce, Çince, Korece, Türkçe, Almanca, İspanyolca, Fransızca |
| ⌨️ **Yazıyor Göstergesi** | Ajan çalışırken Telegram’da "yazıyor..." durumunu gösterir |
| 🖥️ **Çapraz Platform** | Linux, macOS (Intel & Apple Silicon) ve Windows’ta çalışır |
| 🔀 **Çift Uygulama Desteği** | Antigravity IDE ve Standalone App arasında sorunsuzca geçiş yapın |
| 📡 **Telegraph Yayını** | Görev listeleri, planlar ve walkthrough belgeleri 128-bit tahmin edilemez kripto slug URL'leri ile yayınlanabilir (veya sohbette gizli tutulabilir), tam açma/kapama ve silme kontrolü |
---
## 🚀 Hızlı Başlangıç
### Gereksinimler
- **Çift Motor Desteği (IDE & Standalone):** `/app` komutu ile Classic Monaco IDE ve Standalone Agent arasında sorunsuzca geçiş yapın. İzole sürücü mimarileri, sıfır çakışma ve geçiş yaparken kusursuz arka plan süreç yönetimi sağlar.
- [Node.js](https://nodejs.org/) >= 18
- [Antigravity IDE](https://antigravity.google/) ve/veya [Antigravity Standalone App](https://antigravity.google/) yüklü olmalıdır
- Bir Telegram bot token'ı ([@BotFather](https://t.me/BotFather)'dan alınabilir)
### 1. Klonla & Yükle
```bash
git clone https://github.com/emreturkmencom/antigravity-telegram-suite.git
cd antigravity-telegram-suite
npm install
```
### 2. Yapılandırma
```bash
cp .env.example .env
```
`.env` dosyasını kendi bilgilerinizle düzenleyin:
```env
# Telegram
BOT_TOKEN=sizin_bot_tokeniniz
ALLOWED_CHAT_ID=sizin_chat_id,diger_kullanici_chat_id
# CDP Debug Portları (başlatırken kullanılan --remote-debugging-port ile eşleşmelidir)
AGENT_CDP_PORT=9333 # Standalone Antigravity App için port
IDE_CDP_PORT=9334 # Antigravity IDE için port
# Yeni sohbetlerde otomatik seçilecek yapay zeka modeli
DEFAULT_MODEL=Gemini 3.1 Pro (High)
# Dil: en | zh | ko | tr | de | es | fr
LANGUAGE=tr
# Tercih edilen uygulama: 'agent' (Standalone) veya 'ide' (IDE)
ANTIGRAVITY_PREFERRED_APP=ide
# Oto-onay özelliğini varsayılan olarak açık tut
AUTOACCEPT_DEFAULT=true
# Telegraph artefakt yayınını etkinleştir (varsayılan: true)
ENABLE_TELEGRAPH=true
```
> 💡 Chat ID'nizi öğrenmek için botunuza `/start` mesajı gönderebilirsiniz.
### 3. Uygulamayı CDP ile Başlatın
Bot, Antigravity ile Chrome DevTools Protokolü (CDP) üzerinden iletişim kurar. Uygulamayı bir debug portu ile başlatmalısınız.
**Her iki uygulamayı aynı anda kullanıyorsanız farklı portlar kullanın:**
```bash
# --- Standalone Antigravity App ---
# Linux
antigravity --remote-debugging-port=9333
# macOS
open -a Antigravity --args --remote-debugging-port=9333
# Windows
Antigravity.exe --remote-debugging-port=9333
```
```bash
# --- Antigravity IDE ---
# Linux
antigravity-ide --remote-debugging-port=9334
# macOS
open -a "Antigravity IDE" --args --remote-debugging-port=9334
# Windows
"Antigravity IDE.exe" --remote-debugging-port=9334
```
> ⚠️ Port numaraları `.env` dosyanızdaki `AGENT_CDP_PORT` ve `IDE_CDP_PORT` ile tam olarak eşleşmelidir.
### 4. Botu Başlatın
```bash
npm start
```
PM2 ile 7/24 çalışma için:
```bash
npm install -g pm2
pm2 start src/index.js --name antigravity-bot
pm2 save
pm2 startup
```
### Otomatik Kurulum (İsteğe Bağlı)
```bash
# Linux & macOS
bash scripts/install.sh
# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -File scripts\install.ps1
```
---
## 📱 Komutlar
### Temel Komutlar
| Komut | Açıklama |
|---|---|
| *(herhangi bir metin)* | AI ajanına doğrudan mesaj gönderir |
| `/latest` | Ajanın verdiği son cevabı metin olarak getirir |
| `/screenshot` | Aktif IDE/Ajan penceresinin ekran görüntüsünü alır |
| `/status` | Sistem durumunu (IDE, CDP bağlantısı, Bot) gösterir |
| `/stop` | O an çalışan ajanı durdurur |
| `/new` | Yeni bir sohbet oturumu açar |
### AI Model & Ajan
| Komut | Açıklama |
|---|---|
| `/model` | Yapay zeka modelini (Gemini, Claude vb.) değiştirir |
| `/turbo` | **Turbo Modu** aç/kapat — çoklu ajan orkestrasyonu |
| `/goal ` | **Goal Modu** — ajan görev tamamlanıncaya kadar otonom çalışır |
| `/plan ` | Kodlamadan önce **uygulama planı** oluşturur |
| `/schedule_task ` | IDE’de tekrarlayan veya tek seferlik görev planlar |
| `/agents [arama]` | İnteraktif sohbet yöneticisi (Son sohbetler, proje klasörleri, hızlı arama) |
| `/quota` | AI kredilerini ve model kullanım limitlerini kontrol eder |
### Uygulama & Pencere Yönetimi
| Komut | Açıklama |
|---|---|
| `/start_ide` | Antigravity IDE'yi uzaktan başlatır |
| `/start_ag` | Standalone Antigravity Ajan Uygulamasını başlatır |
| `/close_ide` | Antigravity IDE'yi kapatır |
| `/close_ag` | Standalone Ajan Uygulamasını kapatır |
| `/close` | O an aktif olan uygulamayı kapatır |
| `/app` | IDE ve Standalone Ajan arasında hedefi değiştirir (`ANTIGRAVITY_PREFERRED_APP`) |
| `/window` | Birden fazla pencere açıkken belirli birini seçer |
| `/workspace` | Proje çalışma alanını (workspace) değiştirir |
| `/restart` | Bot sürecini yeniden başlatır (PM2) |
### Dosyalar & Araçlar
| Komut | Açıklama |
|---|---|
| `/file` | Proje dosyalarına göz atın ve indirin |
| `/artifacts` | Mevcut sohbetteki artifact (dosya) çıktılarını listeler ve indirir |
| `/autoaccept` | Oto-onay özelliğini yönetir (aç / kapat / durum) |
| `/telegraph` | Telegraph yayınını aç/kapat (aç / kapat / durum ve silme butonları) |
| `/cleartelegraph` | Yayınlanan Telegraph sayfalarını temizle ve kaldırma bildirimleriyle değiştir |
| `/lang` | Görüntüleme dilini değiştirir |
| `/update` | Güncellemeleri kontrol eder, changelog'u gösterir ve botu otomatik günceller |
| `/version` | Mevcut sürüm bilgisini gösterir |
| `/menu` | Telegram komut menüsünü yeniler |
| `/fix_shortcuts` | Antigravity uygulamaları için masaüstü kısayollarını onarır |
---
## 🚀 Turbo Mod (Multi-Agent Orkestrasyonu)
Turbo Mod, birden fazla AI modelini otomatik koordine eden bir **Ajan Konseyi** (Agents Council) iş akışı yürütür:
```
┌─────────────────────────────────────────────────────────────────────┐
│ TURBO MOD AKIŞI │
│ │
│ Aşama 1: PLANLAMA Claude Opus → Mimari planı oluşturur │
│ Aşama 2: KODLAMA Gemini Pro → Kodu yazar │
│ Aşama 3: İNCELEME Claude Opus → Güvenlik ve kod incelemesi │
│ Aşama 4: DÜZELTME Gemini Pro → Bulunan sorunları çözer │
│ Aşama 5: ÖZET Gemini Pro → Kullanıcıya nihai özet sunar│
└─────────────────────────────────────────────────────────────────────┘
```
**Nasıl Kullanılır:**
1. Turbo Modu Etkinleştirin: `/turbo` → "Etkinleştir" (Enable) seçin
2. İsteğinizi normal bir metin olarak gönderin
3. Bot otomatik olarak modelleri değiştirip tüm aşamaları tamamlar
4. Gerçek zamanlı güncellemeler ve nihai bir özet alırsınız
> 💡 Turbo Mod, Antigravity aboneliğinizde hem Claude hem de Gemini modellerine erişim gerektirir.
---
## 🎯 Goal Modu vs 🚀 Turbo Mod
| | Goal Modu (`/goal`) | Turbo Mod (`/turbo`) |
|---|---|---|
| **Nasıl çalışır** | Ajan tek oturumda otonom çalışır, bitene kadar durur | Bot dışarıdan çoklu model hattını yönetir |
| **Kullanılan modeller** | O an seçili olan model | Claude (plan/inceleme) + Gemini (kod/düzeltme) — otomatik geçiş |
| **Temel avantaj** | Basit, güvenilir, IDE’ye entegre | Çoklu model işbirliği: farklı modeller birbirini kontrol eder |
| **Token kullanımı** | Tek context penceresi (verimli) | Birden fazla round-trip (daha fazla token) |
| **İlerleme** | 🤔 reaksiyon → sonuç | Gerçek zamanlı pinned mesaj ile aşama güncellemeleri |
| **En uygun** | Tek model ile uzun görevler | Çoklu model incelemesi gerektiren karmaşık görevler |
| **Mimari** | IDE-native (`/goal` slash komutu) | Dış orkestrasyon: CDP + `turbo_orchestrator.js` |
**Hangisini ne zaman kullanmalı:**
- **Basit uzun görev** (ör. "bu modülü refactor et") → `/goal`
- **Çoklu model incelemesi gereken görev** (ör. "özellik yap, güvenlik incele, sorunları düzelt") → `/turbo`
- **Planlama** → `/plan` (plan oluşturur, sonra siz karar verirsiniz)
---
## 🏗️ Mimari
```
antigravity-telegram-suite/
├── src/
│ ├── index.js # Ana bot mantığı ve Telegram komutları
│ ├── cdp_controller.js # Chrome DevTools Protocol iletişimi
│ ├── autoaccept.js # DOM MutationObserver tabanlı oto-onay botu
│ ├── turbo_orchestrator.js # Çoklu ajan (Turbo Mod) orkestrasyonu
│ ├── task_watcher.js # Proaktif bildirim izleyici (transcript.jsonl)
│ ├── updater.js # Oto-güncelleme modülü (git pull + pm2 restart)
│ ├── ui_locators.js # Arayüz ile etkileşim için DOM seçicileri
│ ├── i18n.js # Çoklu dil (yerelleştirme) modülü
│ └── platform.js # Çapraz platform OS soyutlaması
├── locales/
│ ├── en.json # İngilizce
│ ├── zh.json # Çince (中文)
│ ├── ko.json # Korece (한국어)
│ ├── tr.json # Türkçe
│ ├── de.json # Almanca
│ ├── es.json # İspanyolca
│ └── fr.json # Fransızca
├── scripts/
│ ├── install.sh # Linux/macOS yükleyicisi
│ └── install.ps1 # Windows yükleyicisi
├── .env.example # Ortam değişkenleri şablonu
├── CHANGELOG.md # Sürüm geçmişi
└── package.json
```
### Nasıl Çalışır?
```
┌──────────┐ Telegram API ┌──────────────┐ CDP (WebSocket) ┌─────────────────┐
│ Telegram │ ◄──────────────────► │ Antigravity │ ◄────────────────────► │ Antigravity IDE │
│ App │ Bot Komutları │ Bot │ DOM Etkileşimi │ veya │
└──────────┘ └──────────────┘ │ Standalone Ajan │
└─────────────────┘
```
### Çift Uygulama Mimarisi
Bot eşzamanlı çalışan **iki Antigravity uygulamasını** destekler:
| Uygulama | Varsayılan Port | Config Anahtarı | Açıklama |
|-----|-------------|------------|-------------|
| **Standalone Ajan** | `9333` | `AGENT_CDP_PORT` | Sohbet odaklı hafif Antigravity uygulaması |
| **Antigravity IDE** | `9334` | `IDE_CDP_PORT` | Tam teşekküllü geliştirme ortamı (IDE) |
---
## ⚠️ Bilinen Sorunlar
| Sorun | Detay |
|-------|---------|
| **Standalone Uygulama Desteği** | Tüm komutlar Antigravity 2.0 Standalone App ile tam uyumlu çalışmaktadır. `/agents`, model seçimi, otomatik onay ve sohbet takibi dahil tüm özellikler desteklenmektedir. |
| **IDE 2.0 Oto-Güncellemeleri** | Antigravity IDE kendini güncellerse, DOM seçicileri bot da güncellenene kadar geçici olarak bozulabilir. |
| **Turbo Mod Model Erişimi** | Turbo Mod, hem Claude hem de Gemini modellerine erişim gerektirir. Biri eksikse işlem başarısız olur. |
---
## 🤝 Katkıda Bulunma
1. Depoyu fork edin
2. Özellik dalınızı oluşturun (`git checkout -b feature/amazing-feature`)
3. Değişikliklerinizi commit edin (`git commit -m 'feat: add amazing feature'`)
4. Dalınıza push edin (`git push origin feature/amazing-feature`)
5. [`emreturkmencom/antigravity-telegram-suite`](https://github.com/emreturkmencom/antigravity-telegram-suite) deposuna bir Pull Request açın
---
## 🙏 Teşekkürler
- **[ATX-AI-Dev](https://github.com/ATX-AI-Dev)** — PR #8: Standalone App desteği, Watchdog aracı ve dinamik model listesi
- **[yvg](https://github.com/yvg/antigravity-telegram-suite)** — Çoklu Pencere Desteği özelliği
- **[achshar](https://github.com/achshar/antigravity-telegram-suite)** — Thread yönetimi için Agent Manager UI Locators
- **[mine260309](https://github.com/mine260309)** — Sabit kodlanmış mesajlar için i18n çevirileri
- **[acmavirus/antigravity-telegram-control](https://github.com/acmavirus/antigravity-telegram-control)** — Bu projenin temelini oluşturan açık kaynak Telegram entegrasyonu
- **[yazanbaker94/AntiGravity-AutoAccept](https://github.com/yazanbaker94/AntiGravity-AutoAccept)** — Auto-Accept modülünde DOM observer deseni ilham kaynağı
- **[vassoz](https://github.com/vassoz)** — PR #12: CDP bağlantısı, otomatik X11 ekran tespiti ve dinamik port kısayolları onarımları
- **[wade19990814-hue](https://github.com/wade19990814-hue)** — PR #14: Chinese (中文) localization
- **[ienground](https://github.com/ienground)** — PR #17: Korean (한국어) localization
- **[mo7amed-said-223](https://github.com/mo7amed-said-223)** — Issue #29: Telegram Sesli Mesajlar ve Ses transkripsiyon desteği
- **[Forwead](https://github.com/Forwead)** — Issue #32: Yanıt gecikmesi optimizasyonu ve TaskWatcher baseline senkronizasyonu
- **[Blakey](https://github.com/Blakey)** — PR #33: Telegraph gizlilik kontrolü, tahmin edilemez kripto slug URL'leri, bot komutları ve bağımsız testler
- **[0ALI0ZARGAR0](https://github.com/0ALI0ZARGAR0)** — PR #34: Doğal skill çipleri, çoklu slash komut zincirleme ve skill menü toggle'ı
## 🌟 Krediler & İlham Kaynakları
Çoklu ajan **Turbo Mod** orkestrasyonu, Interdesigncorp Lab'ın [Agents-Council](https://github.com/interdesigncorp-lab/Agents-Council) deposundan ilham alınarak geliştirilmiştir.
---
## 📄 Lisans
Bu proje MIT Lisansı altında lisanslanmıştır — detaylar için [LICENSE](LICENSE) dosyasına bakın.
---
Kanepesinden kod yazan tembel geliştiriciler için ❤️ ile
Emre Türkmen tarafından yapılmıştır.
**Hey Google, eğer bana iş vermek isterseniz bana [hello@emreturkmen.com](mailto:hello@emreturkmen.com) adresinden ulaşabilirsiniz 😂**