HN 표시: 커서-tg – 텔레그램에서 커서 클라우드 에이전트 실행

A single-process Python service that bridges a Telegram bot with the Cursor Cloud Agents API, so you can create agents, receive their responses, and send follow-ups directly from Telegram. Run Cursor Cloud workflows from chat, keep up with unread agent replies, and inspect or act on pull requests without leaving Telegram. Issues or suggestions? Reach me on Telegram at @tb5z035i. - Create and manage Cursor Cloud agents directly from Telegram. - Send follow-up messages to the active agent and receive replies in chat. - Monitor unread updates from multiple agents with configurable notification behavior. - Inspect PR status and diffs from Telegram. - Mark PR as ready for review or merge PR when a GitHub token is configured. - Route agent conversations into dedicated Telegram threads/topics when threaded mode is enabled (thread mode of telegram bot should be enabled). - Persisted agent state, unread tracking, and wizard progress. - Demo walkthrough - Key functionalities - Setup Guide - Bot commands - Configuration Reference - Q&A - Development - Architecture - License | Requirement | Where to get it | |---|---| | Python 3.12+ | python.org or your system package manager | | Telegram Bot Token | Create a bot via @BotFather on Telegram (see step-by-step below) | | Your Telegram User ID | Send /start to @userinfobot — the numeric ID it returns is your user ID | | Cursor API Key | Generate one at Cursor Dashboard → My User API Keys | | GitHub token (optional) | Create one in GitHub fine-grained PAT settings if you want Telegram to inspect PR diffs, mark PRs ready for review, or merge them | - Open Telegram and search for @BotFather. - Send /newbot and follow the prompts to choose a name and username. - BotFather will reply with a token like 123456:ABC-DEF... . Save this asTELEGRAM_BOT_TOKEN . Send /start to @userinfobot. It replies with your numeric user ID. Save this as TELEGRAM_ALLOWED_USER_ID . Only this user will be allowed to interact with the bot. - Go to Cursor Dashboard → My User API Keys. - Create a new user API key. - Copy the key and save it as CURSOR_API_KEY . You only need this if you want the bot to inspect PR diffs, mark PRs ready for review, or merge them from Telegram. Fine-grained PAT (recommended): - Open GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens. - Click Generate new token. - Restrict it to the repository (or org repositories) the Cursor agent works on. - Under Repository permissions, grant at least: - Pull requests: Read and write for PR status reads and the /ready action - Contents: Read and write for the /merge action - Pull requests: Read and write for PR status reads and the - Copy the token and use it as GITHUB_TOKEN (orGITHUB_PAT ). Classic PAT (alternative): - Open GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic). - Generate a token with the repo scope from the classic token creation page. - Copy it into GITHUB_TOKEN . cp .env.example .env Open .env and start with this minimal copy-paste configuration: TELEGRAM_BOT_TOKEN=123456:ABC-DEF... TELEGRAM_ALLOWED_USER_ID=987654321 CURSOR_API_KEY=cur_... If you want PR actions from Telegram, also add: GITHUB_TOKEN=github_pat_... GITHUB_DEFAULT_MERGE_METHOD=merge See full Configuration Reference for details. By default the service reads .env from the working directory. To load from a different path (useful for container deployments), use either: # CLI argument python -m cursor_tg_connector --env-file /path/to/secrets.env # or environment variable ENV_FILE=/path/to/secrets.env python -m cursor_tg_connector Environment variables always take precedence over values in the env file. Local: python3.12 -m venv .venv source .venv/bin/activate pip install -e . python -m cursor_tg_connector Docker: docker build -t cursor-tg-connector . docker run --rm --env-file .env -v "$(pwd)/data:/data" cursor-tg-connector The SQLite database defaults to /data/connector.db . Mount /data to persistent storage so state survives container restarts. | Command | Description | |---|---| /current | Show info about the active agent (name, status, repo, branches, PR link) | /history | Replay the last N conversation messages for the current agent, including prior user prompts | /agents | List running and finished agents; tap one to select it, or create/open its thread when thread mode is enabled | /focus | Show clickable agent options to choose the active agent | /configure_unread | Configure how unread messages from unselected agents are shown: full , count , or none | /unfocus | Clear the currently selected active agent | /stop | Stop the currently selected running agent and clear the active selection | /clear | Mark all unread messages as read for the active agent | /close | Close the current bound Telegram thread/topic in threaded mode without deleting the Cursor agent | /threadmode | Show status or toggle per-agent Telegram thread routing with `/threadmode on | /newagent | Create a new agent with a 4-