CCGram CLI
Мост между Telegram и терминальными агентами Claude Code, Codex, Gemini и Pi: сессии идут в терминале, отвечать можно с телефона.
- 286 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Сообщение из Telegram запускает агента в режиме YOLO и отправляет нажатия клавиш в терминал: код выполняется на вашей машине.
- Токен бота и список `ALLOWED_USERS` лежат в `~/.ccgram/.env`; доступ к боту равен доступу к сессиям.
- Транскрипты и скриншоты терминала уходят в Telegram.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/ccgramОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сообщение из Telegram запускает агента в режиме YOLO и отправляет нажатия клавиш в терминал: код выполняется на вашей машине.
- Токен бота и список `ALLOWED_USERS` лежат в `~/.ccgram/.env`; доступ к боту равен доступу к сессиям.
- Транскрипты и скриншоты терминала уходят в Telegram.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
CCGram сидит поверх tmux, `herdr` или `agterm` и не оборачивает SDK агентов. Агент остается в вашем терминале, а каждая тема Telegram привязана к одному окну или сессии. Бот читает транскрипты и вывод терминала, присылает ответы и скриншоты, отправляет нажатия клавиш. Сессию можно начать одной строкой вида `codex ccgram fix the hook timeout`. Бот находит проект, запускает агента и передает инструкцию. Голосовые сообщения распознаются через Whisper, а кнопки отвечают на запросы подтверждения одним касанием.
Для кого. Разработчикам с долгими сессиями Claude Code или Codex, которые отходят от компьютера и хотят следить за агентом и отвечать ему из Telegram.
Подходит, если
- Агент собирает проект час, и результат надо увидеть, не сидя перед монитором.
- Запрос подтверждения прилетает, пока вы в дороге, и хочется ответить кнопкой.
- Параллельно работают Claude Code, Codex и Gemini в разных окнах tmux.
- Голосом с телефона нужно поставить агенту задачу по проекту.
Не подходит, если
- Терминального мультиплексора нет и ставить его не планируется: нужны tmux, `herdr` или `agterm`.
- Используется нативный Windows без WSL2: он не поддерживается.
- Хочется изолированный API-бот без доступа к терминалу: CCGram управляет живой сессией.
Пример запроса к агенту
В теме Telegram напиши `claude:safe myproject refactor the parser` и пришли скриншот терминала, когда агент попросит подтверждение.Ограничения
Нужны Python 3.14 или новее, один из мультиплексоров (tmux, `herdr`, `agterm`) и CLI агента. Поддерживаются Linux, macOS и WSL2; нативный Windows нет, а `agterm` работает только на macOS. Доставка сообщений идет по принципу «хотя бы раз», поэтому после сбоя сообщение может повториться. Для `herdr` доставка не атомарна: сессия может смениться между проверкой и отправкой. Бот требует токен от @BotFather и список `ALLOWED_USERS` в `~/.ccgram/.env`.
Как отключить. Остановите процесс `ccgram`, отзовите токен бота в @BotFather и уберите пакет командой `uv tool uninstall ccgram`. Хуки, которые поставила `ccgram hook --install`, удалите из настроек Claude Code.
Частые вопросы
Чем сессия CCGram отличается от бота на SDK агента?
Агент живет в вашем tmux, `herdr` или `agterm`. Сессию можно подхватить в терминале с полной историей вывода.
Как начать новую сессию?
Создайте тему в Telegram и напишите строку `<agent>[:<mode>] <project|path> [@branch] <instruction...>`. Уже работающее окно подключает `/bind`.
Какие агенты поддерживаются?
Claude Code, Codex, Gemini, Pi и обычная оболочка. Провайдер определяется автоматически, `/agent` показывает и меняет выбор.
Работает ли CCGram на Windows?
Только внутри WSL2. Нативный Windows не поддерживается: там нет файловых блокировок, сигналов и мультиплексоров терминала.
Как подключить хуки Claude Code?
Выполните `ccgram hook --install`. Хуки `SessionStart` и `Stop` асинхронные; после обновления команду повторяют, дубликатов не появляется.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыМост связывает WeChat, WeCom или Telegram с локальными Codex, Claude Code, OpenCode и Pi, а агентом можно управлять с телефона.
Терминальная рабочая область, где несколько CLI-агентов вроде Codex, Claude и Gemini обмениваются сообщениями и работают над одной задачей под наблюдением челов
CLI MetaBot связывает локальных кодовых агентов с чатами и веб-панелью, сохраняя их задачи, команды и сессии
Telegram-мост к агенту Pi: продолжайте сессию с телефона голосом и скриншотами и возвращайте ее в терминал
botmux связывает Lark и Feishu с Claude Code, Codex, Gemini CLI и OpenCode: каждое сообщение запускает отдельную сессию агента с живыми карточками
ccmux показывает все кодовые агенты в tmux: кто работает, кто ждет вас, запуск в worktree и передача ответа между сессиями.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| CCGram (эта карточка) | нет | 286 | |
| tlive | нет | 214 | отдельный сервис наблюдения и одобрения действий в Telegram, Feishu и веб-терминале; CCGram привязывает темы Telegram к окнам tmux, `herdr` и `agterm` |
| OpenCode Telegram Bot | нет | 1 339 | Telegram-бот для одного агента OpenCode; CCGram ведет Claude Code, Codex, Gemini и Pi в одной группе тем |
Коротко о README
Установка идет через `uv tool install ccgram`, хуки Claude Code ставит `ccgram hook --install`. Для `herdr` и `agterm` в README есть отдельные разделы настройки.