RepoRadar CCGram: управление AI-агентами через Telegram в реальном времени
CCGram — это мост между Telegram и твоими сессиями в tmux, herdr или agterm для управления AI-кодирующими агентами. Он позволяет следить за выводом, реагировать на запросы и управлять многими сессиями параллельно прямо со смартфона.
Задача CCGram — предоставить возможность взаимодействовать с терминальными AI-агентами из Telegram, сохраняя контроль и динамику сессий. В отличие от стандартных Telegram-ботов, CCGram подключается к мультиплексору терминала, позволяя перенаправлять ввод и получать вывод в реальном времени, не теряя доступа к терминальным сессиям. Это может пригодиться разработчикам, которые хотят иметь возможность управлять своими AI-агентами, не привязываясь к рабочему месту.
Проект написан на Python и доступен на PyPI. Есть необходимость в tmux, herdr или agterm для работы. Учти, что проект может находиться на ранней стадии развития, поэтому стоит проверять его стабильность и функционал.
CCGram — это проект, который позволяет управлять ИИ-кодирующими агенты через Telegram. Он обеспечивает возможность следить за работой агентов и отправлять им команды, не теряя доступа к терминалу, с помощью приложений Telegram на мобильных устройствах.
Зачем нужен CCGram?
Основное преимущество CCGram в том, что он работает в связке с твоим терминальным мультиплексором (например, tmux, herdr или agterm). Это позволяет сохранять состояние сессии, так как агенты работают в терминале, и взаимодействие с ними можно продолжать через Telegram, не теряя возможности управлять ими с компьютера.
Как это работает?
Каждая тема в Telegram соответствует одной вкладке tmux или сессии агента в Herdr или agterm. CCGram считывает вывод терминала и отправляет на него команды, а также уведомляет о событиях в реальном времени.
Ты можешь управлять несколькими агентами одновременно, каждому из которых будет сопоставлена своя тема в Telegram. Это позволяет, например, иметь один чат для общения с агентом Claude, другой — с Codex, и так далее.
Как установить и запустить CCGram?
Для установки CCGram используй следующую команду:
uv tool install ccgramЛибо можно установить его с помощью pipx:
pipx install ccgramПосле установки необходимо настроить бота в Telegram:
- Создать бота через @BotFather.
- Выбрать один из вариантов настройки темы (частный чат или группа).
- Создать файл конфигурации
~/.ccgram/.envс токеном бота и разрешёнными пользователями.
Запустите CCGram командой:
ccgramТеперь открой чат с ботом и отправь сообщение, после чего появится браузер директорий для выбора проекта и агента.
Ограничения и особенности
CCGram работает только на Linux, macOS и WSL2, поддержка нативного Windows отсутствует. Для работы требуется Python 3.14+, а также один из терминальных мультиплексоров. База данных Telegram также может иметь ограничения на количестве запросов, поэтому следи за частотой их отправки.
Если терминальная сессия будет закрыта, история тем будет удалена, что может повлиять на возможность восстановления данных.
Дополнительные возможности
Ты можешь активировать веб-дошборд, который позволяет следить за терминалом в режиме реального времени и искать транскрипции. Эта функция отключена по умолчанию.
Проект активно развивается, и для участия в разработке можно ознакомиться с документацией и руководствами, доступными на GitHub.
Радар проекта: 69 из 100 — крепкий проект
- Импульс 7 ≈ 13 звёзд в месяц
- Темп разработки 95 223 коммита за 12 недель
- Зрелость 82 проекту 9 месяцев, больше 100 релизов
- Сообщество 58 26 участников, 89 форков
- Свежесть 96 последний коммит — 7 дней назад
- Быстрый старт 50 есть: команда установки
- Готовность к продакшену 100 релиз v4.21.1, автосборка, тесты
- Безопасность и доверие 55 лицензия MIT
- Документация 98 README 10 тыс. знаков, 15 разделов, папка docs
- Экосистема 51 2 подписчика на обновления, 15 тем
Как считаем
Только открытые данные GitHub на 07.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.
- Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
- Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
- Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
- Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
- Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
- Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
- Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
- Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
- Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
- Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.
Открыть на GitHub: alexei-led/ccgram →
