telegram-copilot-bridge

Управляйте GitHub Copilot CLI удаленно через Telegram. Отправляйте промпты, управляйте сессиями и одобряйте вызовы инструментов — и все это прямо со смартфона.

Архитектура

📱 Telegram
    ↕ (Bot API long-polling)
🐍 telegram-copilot-bridge
    ↕ (stdin/stdout NDJSON — ACP)
🤖 copilot --acp --stdio

Related MCP server: tsgram-mcp

Возможности

• Удаленное управление промптами — отправляйте промпты Copilot из Telegram и получайте результаты на телефон

• Мультисессионность — запускайте несколько сессий Copilot параллельно и переключайтесь между ними

• Утверждение инструментов — одобряйте или отклоняйте вызовы инструментов Copilot с помощью встроенных кнопок

• Режим автопилота — автоматическое одобрение всех вызовов инструментов для работы без участия пользователя

• История сессий — возобновляйте прошлые сессии Copilot одним нажатием

• Выбор папок — команда /new отображает встроенные кнопки для выбора директорий проекта

Установка

git clone https://github.com/NobufumiMurata/telegram-copilot-bridge.git
cd telegram-copilot-bridge
pip install -e .

Предварительные требования: Установите Copilot CLI и пройдите аутентификацию:

winget install GitHub.Copilot   # or: npm install -g @github/copilot
copilot                         # then /login to authenticate

Настройка

1. Создайте бота в Telegram

1. Откройте Telegram и напишите @BotFather

2. Отправьте /newbot и следуйте инструкциям

3. Скопируйте токен бота

2. Получите свой Chat ID и User ID

Отправьте любое сообщение своему боту, затем:

curl "https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates"

Из ответа запишите:

• "chat": {"id": ...} → ваш Chat ID

• "from": {"id": ...} → ваш User ID (для списка разрешенных пользователей)

3. Конфигурация

Скопируйте файл примера и заполните свои значения:

cp .env.example .env

# .env
TELEGRAM_BOT_TOKEN=1234567890:AAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
TELEGRAM_CHAT_ID=-100000000000
TELEGRAM_ALLOWED_USERS=123456789

# Default AI model
COPILOT_MODEL=claude-opus-4.6

# Root folder for /dirs and /new folder picker
COPILOT_DIRS_ROOT=/home/user/projects

Файл .env загружается автоматически при запуске (из текущей директории). Используйте TELEGRAM_ENV_FILE=/path/to/.env, чтобы указать другой путь. Переменные окружения, заданные в оболочке, всегда имеют приоритет над .env.

Использование

# Start (reads .env automatically)
python -m telegram_copilot_bridge

# With options
python -m telegram_copilot_bridge \
  --cwd /path/to/project \
  --model claude-opus-4.6 \
  --timeout 120 \
  -v

Опции CLI:

Команды Telegram

Переменные окружения

Все переменные можно задать в .env или в оболочке. Значения оболочки имеют приоритет.

Telegram:

Copilot:

Безопасность

• Список разрешенных пользователей: Принимаются только сообщения от TELEGRAM_ALLOWED_USERS. Все остальные пользователи игнорируются без уведомления.

• Тайм-ауты: Настраиваемый тайм-аут автоматического завершения (по умолчанию: без тайм-аута). Запросы на разрешение истекают через 5 минут (настраивается через COPILOT_PERMISSION_TIMEOUT_SECONDS).

• Отсутствие секретов в репозитории: Все учетные данные передаются через файл .env или переменные окружения.

• Список разрешенных инструментов: Используется --allow-tool (а не --allow-all-tools) для ограничения действий Copilot CLI.

• Ограничения директорий: Ограничьте директории, в которых могут работать сессии Copilot, с помощью COPILOT_ALLOWED_DIRS.

• Блокировка единственного экземпляра: На одной машине может быть запущен только один экземпляр (блокировка TCP-порта).

Ограничения

• Локальные запуски в VS Code не отслеживаются — Нет способа получить информацию о том, что делает Copilot внутри VS Code. Инструменты MCP — это односторонние вызовы только из VS Code в Bridge.

• Статус CLI-сессий, запущенных вне Bridge, недоступен — Если вы запускаете copilot напрямую на сервере, статус выполнения в реальном времени отследить невозможно. Отображение активности в /status (оценивается по времени изменения events.jsonl) — единственная альтернатива.

• Запросы на одобрение инструментов из CLI-сессий, запущенных вне Bridge, не могут быть перенаправлены — Только сессии, запущенные через Hub, могут перенаправлять запросы на одобрение инструментов через встроенные кнопки Telegram.

• Ограничение на один экземпляр — Только один процесс Hub на машину (блокировка TCP-порта).

• Лимит длины сообщения Telegram — Ответы, превышающие 4000 символов, разбиваются автоматически.

Лицензия

MIT