OrbitPrompter 🚀

Control your AI coding assistant from anywhere — right from Telegram.

OrbitPrompter is a powerful, local Telegram bot that lets you remotely operate your Antigravity IDE on your computer from your smartphone, tablet, or any Telegram-capable device.

This is a custom, v2-compatible fork of Remoat, featuring full support for the latest Antigravity updates and streamlined CDP (Chrome DevTools Protocol) integrations.

📖 Table of Contents

• Quick Start
• Key Features
• How It Works
• Commands
• Headless Prompt (Orbit integration)
• Acknowledgements & Credits
• License

⚡ Quick Start

1. Install OrbitPrompter Globally

To run OrbitPrompter on your system, install it globally using npm:

npm install -g orbitprompter

2. Configure Your Environment

Run the interactive setup wizard to link your Telegram bot:

orbitprompter setup

The wizard will guide you through:

• Telegram Bot Token — Get this from @BotFather on Telegram.
• Allowed User IDs — Whitelist your account. Message @userinfobot to get your ID.
• Workspace Directory — The parent directory of your coding projects.

3. Launch Antigravity with CDP Enablement

orbitprompter open

4. Start the Bot Service

orbitprompter start

Now open Telegram, locate your bot, and start sending instructions!

🎨 Key Features

• v2 Antigravity Compatibility: Fully optimized with updated DOM selectors to match the newest Antigravity IDE updates.
• Workspace Isolation via Topics: Each of your projects maps cleanly to a Telegram Forum Topic.
• Real-Time Progress Streaming: Long-running tasks report live progress, timers, and logs.
• Security by Design: Whitelist-based access control, credentials stored locally, and no external port exposures.

🛠️ Commands

CLI Commands

orbitprompter         # Auto-detect: runs setup if needed, otherwise starts the bot
orbitprompter setup   # Interactive setup wizard
orbitprompter open    # Launch Antigravity IDE with CDP port enabled
orbitprompter start   # Start the Telegram bot service
orbitprompter doctor  # Diagnose configuration and connectivity issues
orbitprompter doctor --prompt-ready  # Check CDP + chat input (no Telegram config required)
orbitprompter prompt --text "Say hello"  # Headless prompt submit (see below)

Headless Prompt (Orbit integration)

Minimum version: ≥ 1.0.3

Orbit Auto Runner and other tools can submit prompts to Antigravity without running the Telegram bot:

orbitprompter prompt --text "Run the /auto-run workflow." [--model <modelId>] [--timeout-minutes 3]

| Option | Required | Description | |--------|----------|-------------| | --text <string> | Yes | Full prompt body (shell-escaped) | | --model <modelId> | No | Switch Antigravity model before submit (omit for Auto). IDs match the IDE, e.g. gemini-3-flash, claude-opus-4.6-thinking | | --timeout-minutes <N> | No | Max time to wait for connect + submit (default: 3) |

Prerequisites

• Antigravity must be running with CDP enabled (Orbit Ignite, or orbitprompter open).
• Does not require orbitprompter start or Telegram configuration.
• Connects to the first Antigravity workbench window found on CDP ports. If multiple windows are open, the first match is used.

Exit codes

| Code | Meaning | |------|---------| | 0 | Prompt submitted successfully | | 1 | General failure (empty text, workspace busy, lock held) | | 2 | CDP not available — Ignite Antigravity first | | 3 | Antigravity workbench not found / UI not ready | | 4 | Submit failed (model switch, inject, or timeout) |

On success, stdout prints one line of JSON: {"ok":true,"workspace":"..."}. Errors go to stderr.

Config is read from ~/.remoat/config.json and environment variables (e.g. WORKSPACE_BASE_DIR, ANTIGRAVITY_PATH) when present, but Telegram tokens are not required for prompt.

Telegram Commands

| Command | Description | |---------|-------------| | /project | Browse and select an active project | | /new | Start a new session in the current project | | /screenshot | Capture and send Antigravity IDE's current window | | /status | Show connection status and active configuration | | /autoaccept | Toggle auto-approval of file edit dialogs | | /help | Show available commands |

🤝 Acknowledgements & Credits

OrbitPrompter is proud to build upon the work of the open-source community:

• Remoat: The brilliant original Telegram-based remote controller for Antigravity, which serves as the foundation for this repository.
• LazyGravity: The pioneering Discord bot that proved remote control via CDP was possible.

Our deepest appreciation goes to the creators and contributors of these repositories for making this ecosystem possible!

📄 License

This project is licensed under the MIT License.