# đŸ€– Antigravity Telegram Suite **Fonctionne avec l'[Antigravity Standalone App](https://antigravity.google/)\* et l'[Antigravity IDE](https://antigravity.google/).** 🌍 Langues : [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) ContrĂŽlez votre agent IA Antigravity Ă  distance via Telegram. Envoyez des messages, changez de modĂšle d'IA, gĂ©rez les espaces de travail, prenez des captures d'Ă©cran et exĂ©cutez des flux de travail multi-agents — le tout depuis votre tĂ©lĂ©phone. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-green.svg)](https://nodejs.org) [![Platform](https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)]() [![Version](https://img.shields.io/badge/Version-3.8.3-orange.svg)]() \* *Certaines fonctionnalitĂ©s peuvent ĂȘtre limitĂ©es sur l'application autonome (Standalone). Voir [Known Issues (ProblĂšmes connus)](#-problĂšmes-connus-known-issues).*
--- ## 📱 CommunautĂ© - **Canal d'ActualitĂ©s:** [@agts_updates](https://t.me/agts_updates) - **Groupe de Discussion:** [@agts_community](https://t.me/agts_community) ## ✹ FonctionnalitĂ©s | FonctionnalitĂ© | Description | |---|---| | đŸ‘„ **Multi-Utilisateurs** | Partagez le contrĂŽle du bot avec votre Ă©quipe via des identifiants de chat sĂ©parĂ©s par des virgules | | 💬 **Headless Chat** | Envoyez des messages directement Ă  l'agent IA via Telegram | | 📎 **Envoi de fichiers & d'images** | TransfĂ©rez des fichiers/images Ă  l'agent avec des lĂ©gendes | | 📾 **Captures d'Ă©cran de l'IDE** | Capturez et recevez des captures d'Ă©cran Ă  distance | | đŸ€– **Changement de modĂšle** | Changez de modĂšle d'IA (Gemini, Claude, GPT) avec des boutons | | 📂 **Explorateur de fichiers** | Parcourez, naviguez et tĂ©lĂ©chargez les fichiers du projet | | 🔄 **Gestion de l'espace de travail** | Changez de projet sans toucher au clavier | | đŸȘŸ **Prise en charge multi-fenĂȘtres** | Dirigez les commandes vers une fenĂȘtre IDE spĂ©cifique | | 💬 **Gestion des discussions (Threads)** | Listez, basculez et gĂ©rez les discussions (conversations de l'agent) | | ⚡ **Auto-Accept** | Cliquez automatiquement sur Run, Accept, Allow, Continue via un MutationObserver | | 🚀 **Mode Turbo** | Orchestration multi-agents : Claude planifie → Gemini code → Claude vĂ©rifie → Gemini corrige | | 🎯 **Mode Goal** | TĂąches autonomes de longue durĂ©e — l'agent travaille jusqu'Ă  atteindre l'objectif | | 📋 **Mode Plan** | GĂ©nĂšre des plans d'implĂ©mentation avant le codage | | 🔔 **Notifications Proactives** | TaskWatcher dĂ©tecte les messages non sollicitĂ©s de l'agent (timers, sous-agents) et les transmet Ă  Telegram | | đŸ€” **RĂ©actions aux Messages** | Affiche đŸ€” pendant le traitement, efface Ă  la fin | | 🔄 **Mise Ă  jour automatique** | VĂ©rifiez et installez les mises Ă  jour avec une seule commande | | 🌐 **Multilingue** | 7 langues supportĂ©es : Anglais, Chinois, CorĂ©en, Turc, Allemand, Espagnol, Français | | ⌚ **Indicateur de frappe** | Affiche "en train d'Ă©crire..." dans Telegram pendant que l'agent travaille | | đŸ–„ïž **Multiplateforme** | Fonctionne sur Linux, macOS (Intel & Apple Silicon) et Windows | | 🔀 **Prise en charge double application** | Basculez facilement entre Antigravity IDE et Standalone Agent App | | 📡 **Publication Telegraph** | Les listes de tĂąches, plans et walkthroughs peuvent ĂȘtre publiĂ©s avec des URL avec slug cryptographique indĂ©chiffrable 128 bits (ou conservĂ©s privĂ©s dans le chat), avec contrĂŽle total d'activation et de suppression | --- ## 🚀 DĂ©marrage Rapide ### PrĂ©requis - **Support Double Moteur (IDE & Standalone) :** Passez facilement du Classic Monaco IDE au Standalone Agent via la commande `/app`. Les architectures de pilotes isolĂ©es garantissent zĂ©ro conflit et une gestion parfaite des processus en arriĂšre-plan lors du changement. - [Node.js](https://nodejs.org/) >= 18 - [Antigravity IDE](https://antigravity.google/) et/ou [Antigravity Standalone App](https://antigravity.google/) installĂ© - Un jeton de bot Telegram (obtenez-le auprĂšs de [@BotFather](https://t.me/BotFather)) ### 1. Cloner & Installer ```bash git clone https://github.com/emreturkmencom/antigravity-telegram-suite.git cd antigravity-telegram-suite npm install ``` ### 2. Configurer ```bash cp .env.example .env ``` Modifiez le fichier `.env` avec vos valeurs : ```env # Telegram BOT_TOKEN=votre_token_bot_telegram ALLOWED_CHAT_ID=votre_chat_id # Ports de dĂ©bogage CDP (doivent correspondre au port utilisĂ© lors du lancement) AGENT_CDP_PORT=9333 # Port pour Standalone Antigravity App IDE_CDP_PORT=9334 # Port pour Antigravity IDE # ModĂšle IA par dĂ©faut pour les nouveaux chats DEFAULT_MODEL=Gemini 3.1 Pro (High) # Langue: en | zh | ko | tr | de | es | fr LANGUAGE=fr # Cible de l'application prĂ©fĂ©rĂ©e: 'agent' (Standalone) ou 'ide' (IDE) ANTIGRAVITY_PREFERRED_APP=ide # Activer l'acceptation automatique par dĂ©faut AUTOACCEPT_DEFAULT=true # Activer la publication d'artefacts sur Telegraph (par dĂ©faut : true) ENABLE_TELEGRAPH=true ``` > 💡 Envoyez `/start` Ă  votre bot pour obtenir votre Chat ID. ### 3. Lancer l'Application avec CDP Le bot communique avec Antigravity via le Chrome DevTools Protocol (CDP). Vous devez lancer l'application avec un port de dĂ©bogage. **Si vous exĂ©cutez les deux applications en mĂȘme temps, utilisez des ports diffĂ©rents:** ```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 ``` > ⚠ Les numĂ©ros de port doivent correspondre Ă  `AGENT_CDP_PORT` et `IDE_CDP_PORT` dans votre fichier `.env`. ### 4. DĂ©marrer le Bot ```bash npm start ``` Pour un fonctionnement 24/7 avec PM2 : ```bash npm install -g pm2 pm2 start src/index.js --name antigravity-bot pm2 save pm2 startup ``` ### Installation Automatique (Optionnel) ```bash # Linux & macOS bash scripts/install.sh # Windows (PowerShell) powershell -ExecutionPolicy Bypass -File scripts\install.ps1 ``` --- ## đŸ“± Commandes ### Commandes Principales | Commande | Description | |---|---| | *(tout texte)* | Envoyer directement Ă  l'agent IA | | `/latest` | Obtenir la derniĂšre rĂ©ponse de l'agent en texte | | `/screenshot` | Prendre une capture d'Ă©cran de la fenĂȘtre de l'agent actif | | `/status` | Afficher l'Ă©tat du systĂšme (IDE, connexion CDP, Bot) | | `/stop` | ArrĂȘter l'agent en cours d'exĂ©cution | | `/new` | Ouvrir une nouvelle session de discussion | ### ModĂšle IA & Agent | Commande | Description | |---|---| | `/model` | Changer le modĂšle IA (Gemini, Claude, etc.) | | `/turbo` | Basculer en **Mode Turbo** — orchestration multi-agents (voir ci-dessous) | | `/goal ` | **Mode Goal** — l'agent travaille de maniĂšre autonome jusqu'Ă  la fin | | `/plan ` | GĂ©nĂ©rer un **plan d'implĂ©mentation** avant le codage | | `/schedule_task ` | Planifier une tĂąche rĂ©currente ou ponctuelle dans l'IDE | | `/agents` | Lister et basculer entre les fils de discussion (threads) | | `/quota` | VĂ©rifier les crĂ©dits IA et les limites d'utilisation du modĂšle | ### Gestion de l'App & des FenĂȘtres | Commande | Description | |---|---| | `/start_ide` | DĂ©marrer l'Antigravity IDE Ă  distance | | `/start_ag` | DĂ©marrer la Standalone Antigravity Agent App | | `/close_ide` | Fermer l'Antigravity IDE | | `/close_ag` | Fermer la Standalone Agent App | | `/close` | Fermer l'application actuellement active | | `/app` | Basculer entre IDE et Standalone App (`ANTIGRAVITY_PREFERRED_APP`) | | `/window` | SĂ©lectionner une fenĂȘtre spĂ©cifique lorsque plusieurs sont ouvertes | | `/workspace` | Changer d'espace de travail du projet | | `/restart` | RedĂ©marrer le processus du bot (PM2) | ### Fichiers & Utilitaires | Commande | Description | |---|---| | `/file` | Parcourir et tĂ©lĂ©charger les fichiers du projet | | `/artifacts` | Lister et tĂ©lĂ©charger les artefacts de la discussion actuelle | | `/autoaccept` | Basculer l'acceptation automatique (on / off / Ă©tat) | | `/telegraph` | Basculer la publication Telegraph (on / off / Ă©tat et boutons de suppression) | | `/cleartelegraph` | Effacer les pages Telegraph publiĂ©es et les remplacer par des avis de suppression | | `/lang` | Changer la langue d'affichage | | `/update` | VĂ©rifier les mises Ă  jour et mettre Ă  jour automatiquement le bot | | `/version` | Afficher les informations de la version actuelle | | `/menu` | Mettre Ă  jour le menu de commandes Telegram | | `/fix_shortcuts` | RĂ©parer les raccourcis de bureau pour les applications Antigravity | --- ## 🚀 Mode Turbo (Orchestration Multi-Agents) Le Mode Turbo exĂ©cute un flux de travail **Agents Council (Conseil d'Agents)** qui coordonne automatiquement plusieurs modĂšles d'IA : ``` ┌─────────────────────────────────────────────────────────────────────┐ │ PIPELINE MODE TURBO │ │ │ │ Phase 1 : PLANIFICATION Claude Opus → CrĂ©e le plan de mise en Ɠuvre│ │ Phase 2 : CODAGE Gemini Pro → Écrit le code │ │ Phase 3 : RÉVISION Claude Opus → SĂ©curitĂ© et revue de code │ │ Phase 4 : CORRECTION Gemini Pro → Corrige les problĂšmes trouvĂ©s│ │ Phase 5 : RÉSUMÉ Gemini Pro → RĂ©sumĂ© exĂ©cutif pour l'usager│ └─────────────────────────────────────────────────────────────────────┘ ``` **Comment utiliser :** 1. Activez le Mode Turbo : `/turbo` → SĂ©lectionnez "Activer" (Enable) 2. Envoyez votre demande sous forme de texte normal 3. Le bot changera automatiquement de modĂšle et exĂ©cutera toutes les phases 4. Vous recevrez des mises Ă  jour de phase en temps rĂ©el et un rĂ©sumĂ© final > 💡 Le Mode Turbo nĂ©cessite l'accĂšs aux modĂšles Claude et Gemini dans votre abonnement Antigravity. --- ## 🎯 Mode Goal vs 🚀 Mode Turbo | | Mode Goal (`/goal`) | Mode Turbo (`/turbo`) | |---|---|---| | **Fonctionnement** | L'agent travaille de maniĂšre autonome en une seule session | Le bot orchestre un pipeline multi-modĂšles en externe | | **ModĂšles utilisĂ©s** | Le modĂšle actuellement sĂ©lectionnĂ© | Claude (plan/vĂ©rification) + Gemini (code/correction) — changement auto | | **Avantage principal** | Simple, fiable, intĂ©grĂ© Ă  l'IDE | Collaboration multi-modĂšles : diffĂ©rents modĂšles se vĂ©rifient mutuellement | | **Utilisation de tokens** | FenĂȘtre de contexte unique (efficace) | Plusieurs aller-retours (plus de tokens) | | **Progression** | RĂ©action đŸ€” → rĂ©sultat final | Message Ă©pinglĂ© avec mises Ă  jour en temps rĂ©el | | **IdĂ©al pour** | TĂąches longues avec un seul modĂšle | TĂąches complexes nĂ©cessitant une rĂ©vision multi-modĂšles | | **Architecture** | Natif IDE (commande `/goal`) | Orchestration externe : CDP + `turbo_orchestrator.js` | **Quand utiliser lequel :** - **TĂąche longue simple** (ex. "refactoriser ce module") → `/goal` - **TĂąche complexe avec rĂ©vision multi-modĂšles** (ex. "construire cette fonctionnalitĂ©, vĂ©rifier la sĂ©curitĂ©, corriger les erreurs") → `/turbo` - **Planification** → `/plan` (gĂ©nĂšre le plan, vous dĂ©cidez ensuite) --- ## đŸ—ïž Architecture ``` antigravity-telegram-suite/ ├── src/ │ ├── index.js # Logique principale du bot et commandes Telegram │ ├── cdp_controller.js # Communication avec le Chrome DevTools Protocol │ ├── autoaccept.js # Clic automatique via CDP MutationObserver │ ├── turbo_orchestrator.js # Orchestration Mode Turbo multi-agents │ ├── task_watcher.js # Surveillant de notifications proactives (transcript.jsonl) │ ├── updater.js # Module de mise Ă  jour (git pull + pm2 restart) │ ├── ui_locators.js # SĂ©lecteurs DOM pour l'interaction IDE/Agent UI │ ├── i18n.js # Module d'internationalisation (i18n) │ └── platform.js # Abstraction multiplateforme (lancement, arrĂȘt, chemins) ├── locales/ │ ├── en.json # Anglais │ ├── zh.json # Chinois (äž­æ–‡) │ ├── ko.json # CorĂ©en (한ꔭ얎) │ ├── tr.json # Turc │ ├── de.json # Allemand │ ├── es.json # Espagnol │ └── fr.json # Français ├── scripts/ │ ├── install.sh # Installateur Linux/macOS │ └── install.ps1 # Installateur Windows ├── .env.example # ModĂšle de variables d'environnement ├── CHANGELOG.md # Historique des versions └── package.json ``` ### Comment ça marche ``` ┌──────────┐ API Telegram ┌──────────────┐ CDP (WebSocket) ┌─────────────────┐ │ Telegram │ ◄──────────────────â–ș │ Antigravity │ ◄────────────────────â–ș │ Antigravity IDE │ │ App │ Commandes du Bot │ Bot │ Interaction au DOM │ ou │ └──────────┘ └──────────────┘ │ Standalone Agent │ └─────────────────┘ ``` 1. Vous envoyez un message via Telegram 2. Le bot injecte le texte dans l'entrĂ©e de discussion de l'agent IA via CDP 3. Le bot surveille l'agent (un indicateur "en train d'Ă©crire..." s'affiche dans Telegram) 4. Une fois terminĂ©, la rĂ©ponse est extraite et renvoyĂ©e Ă  Telegram 5. **Auto-Accept** : S'il est activĂ©, un MutationObserver surveille les boutons d'action (Run, Accept, Allow, Continue) et clique dessus automatiquement ### Architecture Ă  Double Application Le bot prend en charge **deux applications Antigravity** exĂ©cutĂ©es simultanĂ©ment : | Application | Port par DĂ©faut | ClĂ© Config | Description | |-----|-------------|------------|-------------| | **Standalone Agent** | `9333` | `AGENT_CDP_PORT` | Application Antigravity lĂ©gĂšre axĂ©e sur la discussion | | **Antigravity IDE** | `9334` | `IDE_CDP_PORT` | IDE complet avec Ă©diteur, terminal et extensions | Utilisez `/app` pour basculer le bot entre les applications. Le paramĂštre `ANTIGRAVITY_PREFERRED_APP` dans `.env` dĂ©termine l'application par dĂ©faut visĂ©e par le bot. --- ## 🌐 Ajouter une Langue 1. Copiez `locales/en.json` vers `locales/xx.json` 2. Traduisez toutes les valeurs de chaĂźne 3. DĂ©finissez `LANGUAGE=xx` dans votre fichier `.env` --- ## ⚠ ProblĂšmes Connus (Known Issues) | ProblĂšme | DĂ©tails | |-------|---------| | **Limitations de Standalone App** | Certaines fonctionnalitĂ©s (changement d'espace de travail, gestion des discussions) peuvent ne pas fonctionner de maniĂšre fiable avec Standalone Antigravity App. **Antigravity IDE est entiĂšrement pris en charge et recommandĂ©.** | | **Mise Ă  jour Auto dans IDE 2.0** | Si Antigravity IDE se met Ă  jour automatiquement, les sĂ©lecteurs DOM peuvent casser jusqu'Ă  ce que le bot soit Ă©galement mis Ă  jour. | | **AccĂšs aux ModĂšles Mode Turbo** | Le Mode Turbo nĂ©cessite que les modĂšles Claude et Gemini soient disponibles. Si un modĂšle n'est pas disponible, le pipeline Ă©chouera. | > 💡 En tant que dĂ©veloppeur, je prĂ©fĂšre me concentrer sur le support de l'IDE. L'intĂ©gration de l'application autonome est fournie "au mieux" (best-effort). --- ## đŸ€ Contribuer 1. Forkez le dĂ©pĂŽt 2. CrĂ©ez votre branche de fonctionnalitĂ© (`git checkout -b feature/amazing-feature`) 3. Validez vos modifications (`git commit -m 'Ajout d'une fonctionnalitĂ© incroyable'`) 4. Poussez vers la branche (`git push origin feature/amazing-feature`) 5. Ouvrez une Pull Request sur [`emreturkmencom/antigravity-telegram-suite`](https://github.com/emreturkmencom/antigravity-telegram-suite) --- ## 🙏 Remerciements - **[ATX-AI-Dev](https://github.com/ATX-AI-Dev)** — PR #8: Standalone App support, Watchdog agent, and dynamic model fetching - **[yvg](https://github.com/yvg/antigravity-telegram-suite)** — Pour la prise en charge multi-fenĂȘtres ! - **[achshar](https://github.com/achshar/antigravity-telegram-suite)** — Pour les localisateurs UI de l'Agent Manager ! - **[mine260309](https://github.com/mine260309)** — Traductions i18n pour les messages en dur - **[acmavirus/antigravity-telegram-control](https://github.com/acmavirus/antigravity-telegram-control)** — L'intĂ©gration Telegram open-source propre qui a servi de base Ă  ce projet. - **[yazanbaker94/AntiGravity-AutoAccept](https://github.com/yazanbaker94/AntiGravity-AutoAccept)** — Inspiration pour le modĂšle d'observateur DOM dans le module Auto-Accept. - **[vassoz](https://github.com/vassoz)** — PR #12: Corrections de la connexion CDP, dĂ©tection automatique de l'affichage X11 et raccourcis de ports dynamiques - **[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: Prise en charge des messages vocaux Telegram et transcription audio - **[Forwead](https://github.com/Forwead)** — Issue #32: Optimisation de la latence de rĂ©ponse et synchronisation de base de TaskWatcher - **[Blakey](https://github.com/Blakey)** — PR #33: Bascule de confidentialitĂ© Telegraph, slugs d'URL crypto impossibles Ă  deviner, commandes de bot et tests autonomes - **[0ALI0ZARGAR0](https://github.com/0ALI0ZARGAR0)** — PR #34: Chips de skills natifs, chaĂźnage de commandes multi-slash et bascule de menu de skills ## 🌟 CrĂ©dits & Inspirations L'orchestration multi-agents du **Mode Turbo** a Ă©tĂ© inspirĂ©e par le dĂ©pĂŽt [Agents-Council](https://github.com/interdesigncorp-lab/Agents-Council) du Interdesigncorp Lab. --- ## 📄 Licence Ce projet est sous licence MIT — voir le fichier [LICENSE](LICENSE) pour plus de dĂ©tails. ---
Fait avec ❀ par Emre TĂŒrkmen pour les dĂ©veloppeurs Ă  distance qui codent depuis leur canapĂ©. **HĂ© Google, si vous voulez me donner un travail, vous pouvez me contacter Ă  [hello@emreturkmen.com](mailto:hello@emreturkmen.com) 😂**