Skip to content

emreturkmencom/antigravity-telegram-suite

BranchesTags

Repository files navigation

🤖 Antigravity Telegram Suite

Works with both Antigravity Standalone App* and Antigravity IDE.

🌍 Languages: English | Türkçe | Deutsch | Español | Français

Control your Antigravity AI agent remotely via Telegram. Send messages, switch AI models, manage workspaces, take screenshots, and run multi-agent workflows — all from your phone.

License: MIT Node.js Platform Version

* Some features may have limitations on the Standalone App. See Known Issues.

✨ Features

Feature Description
💬 Headless Chat Send messages directly to the AI agent via Telegram
📎 File & Image Upload Forward files/images to the agent with captions
📸 IDE Screenshots Capture and receive screenshots remotely
🤖 Model Switching Change AI models (Gemini, Claude, GPT) with inline buttons
📂 File Explorer Browse, navigate, and download project files
🔄 Workspace Management Switch between projects without touching the keyboard
🪟 Multi-Window Support Route commands to a specific IDE window when multiple are open
👥 Multi-User Share bot control with your team via comma-separated Chat IDs
💬 Thread Management List, switch, and manage chat threads (agent conversations)
⚡ Auto-Accept Automatically click Run, Accept, Allow, Continue buttons via a DOM MutationObserver
🚀 Turbo Mode Multi-agent orchestration: Claude plans → Gemini codes → Claude reviews → Gemini fixes
🎯 Goal Mode Autonomous long-running tasks — agent works until the goal is fully achieved
📋 Plan Mode Generate implementation plans before coding
🔔 Proactive Notifications TaskWatcher detects unsolicited agent messages (timers, sub-agents) and forwards to Telegram
🤔 Message Reactions Shows 🤔 while processing, clears when done
🔄 Auto-Update Check for updates and self-update with one command
🌐 Multi-Language 5 languages supported: English, Turkish, German, Spanish, French
⌨️ Typing Indicator Shows "typing..." in Telegram while the agent is working
🖥️ Cross-Platform Works on Linux, macOS (Intel & Apple Silicon), and Windows
🔀 Dual App Support Seamlessly switch between Antigravity IDE and Standalone Agent App

🚀 Quick Start

Prerequisites

1. Clone & Install

git clone https://github.com/emreturkmencom/antigravity-telegram-suite.git
cd antigravity-telegram-suite
npm install

2. Configure

cp .env.example .env

Edit .env with your values:

# Telegram
BOT_TOKEN=your_telegram_bot_token
ALLOWED_CHAT_ID=your_chat_id,another_chat_id_optional

# CDP Debugging Ports (must match the --remote-debugging-port used when launching)
AGENT_CDP_PORT=9333    # Port for the Standalone Antigravity App
IDE_CDP_PORT=9334      # Port for the Antigravity IDE

# Default AI model to select on new chat
DEFAULT_MODEL=Gemini 3.1 Pro (High)

# Language: en | tr | de | es | fr
LANGUAGE=en

# Preferred app target: 'agent' (Standalone) or 'ide' (IDE)
ANTIGRAVITY_PREFERRED_APP=ide

# Enable auto-accept by default
AUTOACCEPT_DEFAULT=true

💡 Send /start to your bot to get your Chat ID.

3. Launch the App with CDP

The bot communicates with Antigravity via Chrome DevTools Protocol (CDP). You must launch the app with a debugging port.

If running both apps side-by-side, use different ports:

# --- 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
# --- 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

⚠️ The port numbers must match AGENT_CDP_PORT and IDE_CDP_PORT in your .env file.

4. Start the Bot

npm start

For 24/7 operation with PM2:

npm install -g pm2
pm2 start src/index.js --name antigravity-bot
pm2 save
pm2 startup

Automated Setup (Optional)

# Linux & macOS
bash scripts/install.sh

# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -File scripts\install.ps1

📱 Commands

Core Commands

Command Description
(any text) Send directly to the AI agent
/latest Get the latest agent response as text
/screenshot Take a screenshot of the active agent window
/status Show system status (IDE, CDP connection, Bot)
/stop Stop the currently running agent
/new Open a new chat session

AI Model & Agent

Command Description
/model Switch AI model (Gemini, Claude, etc.)
/turbo Toggle Turbo Mode — multi-agent orchestration (see below)
/goal <task> Start Goal Mode — agent works autonomously until done
/plan <task> Generate an implementation plan before coding
/schedule_task <task> Schedule a recurring or one-time task in the IDE
/agents List and switch between chat threads
/quota Check AI credits and model usage limits

App & Window Management

Command Description
/start_ide Start the Antigravity IDE remotely
/start_ag Start the Standalone Antigravity Agent App
/close_ide Close the Antigravity IDE
/close_ag Close the Standalone Agent App
/close Close the currently active app
/app Switch between IDE and Standalone Agent (ANTIGRAVITY_PREFERRED_APP)
/window Select a specific window when multiple are open
/workspace Switch project workspace
/restart Restart the bot process (PM2)

Files & Utilities

Command Description
/file Browse & download project files
/artifacts List and download artifacts from the current thread
/autoaccept Toggle auto-accept (on / off / status)
/lang Switch display language
/update Check for updates, view changelog, and auto-update the bot
/version Show current version info
/menu Update the Telegram command menu
/fix_shortcuts Repair desktop shortcuts for Antigravity apps

🚀 Turbo Mode (Multi-Agent Orchestration)

Turbo Mode runs an Agents Council workflow that coordinates multiple AI models automatically:

┌─────────────────────────────────────────────────────────────────────┐
│                        TURBO MODE PIPELINE                         │
│                                                                     │
│  Phase 1: PLANNING        Claude Opus → Creates implementation plan │
│  Phase 2: CODING          Gemini Pro  → Writes the code             │
│  Phase 3: REVIEW          Claude Opus → Security & code review      │
│  Phase 4: FIX (if needed) Gemini Pro  → Fixes issues found          │
│  Phase 5: SUMMARY         Gemini Pro  → Executive summary for user  │
└─────────────────────────────────────────────────────────────────────┘

How to use:

  1. Enable Turbo Mode: /turbo → Select "Enable"
  2. Send your request as normal text
  3. The bot will automatically switch models and run all phases
  4. You'll receive real-time phase updates and a final summary

💡 Turbo Mode requires access to both Claude and Gemini models in your Antigravity subscription.

🎯 Goal Mode vs 🚀 Turbo Mode

Goal Mode (/goal) Turbo Mode (/turbo)
How it works Agent works autonomously in a single session until done Bot orchestrates multi-model pipeline externally
Models used Whichever model is currently selected Claude (plan/review) + Gemini (code/fix) — automatic switching
Key advantage Simple, reliable, native IDE feature Multi-model collaboration: different models cross-check each other
Token usage Single context window (efficient) Multiple round-trips (more tokens)
Progress 🤔 reaction → final result Real-time pinned message with phase updates
Best for Long tasks with a single model Complex tasks benefiting from multi-model review
Architecture IDE-native (/goal slash command) External orchestration via CDP + turbo_orchestrator.js

When to use which:

  • Simple long task (e.g., "refactor this module") → /goal
  • Complex task needing cross-model review (e.g., "build this feature, review security, fix issues") → /turbo
  • Planning → /plan (generates plan, then you decide)

🏗️ Architecture

antigravity-telegram-suite/
├── src/
│   ├── index.js              # Main bot logic & Telegram command handlers
│   ├── cdp_controller.js     # Chrome DevTools Protocol communication
│   ├── autoaccept.js         # Auto-accept button clicker via CDP MutationObserver
│   ├── turbo_orchestrator.js # Multi-agent Turbo Mode (Agents Council) orchestration
│   ├── task_watcher.js       # Proactive notification watcher (transcript.jsonl monitor)
│   ├── updater.js            # Self-update module (git pull + pm2 restart)
│   ├── ui_locators.js        # DOM element locators for IDE/Agent UI interaction
│   ├── i18n.js               # Internationalization module
│   └── platform.js           # Cross-platform OS abstraction (launch, close, paths)
├── locales/
│   ├── en.json               # English
│   ├── tr.json               # Turkish
│   ├── de.json               # German
│   ├── es.json               # Spanish
│   └── fr.json               # French
├── scripts/
│   ├── install.sh            # Linux/macOS installer
│   └── install.ps1           # Windows installer
├── .env.example              # Environment variable template
├── CHANGELOG.md              # Release history
└── package.json

How It Works

┌──────────┐     Telegram API     ┌──────────────┐     CDP (WebSocket)     ┌─────────────────┐
│ Telegram │ ◄──────────────────► │ Antigravity  │ ◄────────────────────► │ Antigravity IDE  │
│   App    │     Bot Commands     │     Bot      │    DOM Interaction     │       or         │
└──────────┘                      └──────────────┘                        │ Standalone Agent │
                                                                          └─────────────────┘
  1. You send a message via Telegram
  2. The bot injects your text into the AI agent's chat input via CDP
  3. The bot monitors the agent for completion (typing indicator shown in Telegram)
  4. Once done, the response is extracted and sent back to Telegram
  5. Auto-Accept: When enabled, a MutationObserver watches for action buttons (Run, Accept, Allow, Continue) and clicks them automatically

Dual App Architecture

The bot supports two Antigravity applications running simultaneously:

App Default Port Config Key Description
Standalone Agent 9333 AGENT_CDP_PORT Lightweight chat-focused Antigravity app
Antigravity IDE 9334 IDE_CDP_PORT Full IDE with editor, terminal, and extensions

Use /app to switch the bot's focus between apps. The ANTIGRAVITY_PREFERRED_APP setting in .env determines which app the bot targets by default.

🌐 Adding a Language

  1. Copy locales/en.json to locales/xx.json
  2. Translate all string values
  3. Set LANGUAGE=xx in your .env

⚠️ Known Issues

Issue Details
Standalone App Limitations Some features (workspace switching, thread management) may not work reliably with the Standalone Antigravity App. Antigravity IDE is fully supported and recommended.
Auto-Update on IDE 2.0 If Antigravity IDE auto-updates, DOM selectors may break until the bot is also updated.
Turbo Mode Model Access Turbo Mode requires both Claude and Gemini models to be available. If one model is unavailable, the pipeline will fail.

💡 As a developer, I prefer to focus on IDE support. The Standalone App integration is provided on a best-effort basis.

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

🙏 Acknowledgments

🌟 Credits & Inspirations

The multi-agent Turbo Mode orchestration was inspired by the Agents-Council repository by Interdesigncorp Lab.

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

Made with ❤️ by Emre Türkmen for remote developers who code from their couch.

Hey Google, if you would like to give me a job you can contact me at hello@emreturkmen.com 😂

About

Antigravity Telegram bot — remote-control your AI agent via Telegram. Chat, switch models, orchestrate multi-agent workflows, and manage workspaces from your phone.

emreturkmen.com/antigravity-telegram-suite-ai-kod-editorunuzu-telefonunuzdan-kontrol-edin/

Topics

google telegram cdp telegrambot antigravity

Resources

Readme

License

MIT license
Activity

Stars

109 stars

Watchers

3 watching

Forks

28 forks
Report repository

Releases

10 tags

Packages

 
 
 

Contributors

Languages