Telegram · Mini App · AI-агенты

tg-cockpit

Кабинет управления своими AI-агентами с телефона. Непрерывный агент на каждый тред плюс Mini App-диспетчерская: весь флот твоих сессий, переписка внутри Telegram, пуш когда агент закончил.

Что это даёт

🧠

Непрерывный агент на тред

Один мощный агент держит весь контекст. Продолжаемые сессии переживают рестарт. Работает до результата, делегирует суб-агентам, использует твои skills — не сваливает работу обратно вопросами.

🛰

Кабинет mission-control

Весь флот сессий Claude Code / Cursor по зонам: 🔴 требуют тебя · 🟢 работают · ✓ готово · 💤 простаивают. Статусы, время, бейджи непрочитанного — видно с одного экрана, кто чего ждёт.

💬

Чат с сессией внутри

Открываешь любую сессию — вся история переписки, пишешь агенту, видишь как он печатает и какие инструменты гоняет в реальном времени. Не выходя из Telegram.

Подтверждение опасного

Необратимое — публикация, оплата, rm -rf, git push — требует твоего тапа прямо в потоке чата. Ничего не уходит наружу без явного «да».

Параллельные агенты

Несколько сессий работают одновременно, каждая в своём слоте. Пишешь одному — второй молотит в фоне. Управляешь всей армией из одного места.

📎

Файлы и команды

Скрепка — приложить файл или фото агенту. Меню чата — остановить ход, начать новый, сменить модель (Opus / Sonnet / Haiku) прямо на лету.

🔔

Пуш о завершении

Агент закончил фоном, а ты не в чате — бот пишет в личку с кнопкой «открыть». Поставил задачу, ушёл, вернулся по сигналу.

🔗

Мост к Cursor / Claude Code

Видит и продолжает desktop-сессии, запущенные на том же сервере. Сессия из Cursor — продолжаешь её с телефона, и наоборот.

Установка — 7 шагов

1

Сервер и Claude Code

Нужен Linux-VPS с Python 3.11+. Установи и авторизуй Claude Code под тем пользователем, под которым будет жить бот (режим подписки) — либо подготовь платный Anthropic API-ключ.

2

Клонировать и поставить зависимости

# под аккаунтом cranchagency
git clone https://github.com/cranchagency/tg-cockpit ~/tg-cockpit
cd ~/tg-cockpit
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
3

Бот в BotFather

Создай бота у @BotFather, получи токен. Свой Telegram user id узнай у @userinfobot.

4

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

cp .env.example .env
nano .env

Минимум: TG_BOT_TOKEN, TG_ALLOWED_CHAT_IDS, CLAUDE_WORKSPACE (корень твоей рабочей системы), MINIAPP_URL. Остальное — опционально (см. таблицу ниже).

5

Авторизация Claude Code

claude   # пройди вход один раз под этим пользователем

В режиме подписки (по умолчанию) ключ API гасится автоматически — агент идёт через твою подписку.

6

Reverse-proxy + Mini App

Mini App требует публичный HTTPS. Добавь блок из Caddyfile.example в свой Caddyfile (подставь домен = MINIAPP_URL), перезагрузи Caddy. Затем в BotFather → Bot Settings → Menu Button впиши тот же URL.

cockpit.example.com {
    reverse_proxy 127.0.0.1:8124
}
7

Автозапуск

mkdir -p ~/.config/systemd/user
cp tg-cockpit.service ~/.config/systemd/user/
loginctl enable-linger $USER
systemctl --user daemon-reload
systemctl --user enable --now tg-cockpit
journalctl --user -u tg-cockpit -f   # логи

Готово. Напиши боту в Telegram — он ответит. Команда /app открывает кабинет.

Конфигурация (.env)

ПеременнаяНазначение
TG_BOT_TOKENтокен бота от BotFatherобязат.
TG_ALLOWED_CHAT_IDSтвои Telegram user id через запятую (whitelist доступа)обязат.
CLAUDE_WORKSPACEкорневая рабочая папка агента — твой код и системаобязат.
MINIAPP_URLпубличный HTTPS-домен дашбордадля Mini App
MINIAPP_PORTлокальный порт backend (по умолчанию 8124)опц.
COCKPIT_USE_API_KEY + ANTHROPIC_API_KEYплатный API вместо подпискиопц.
COCKPIT_OWNER_NAMEкак агент обращается к владельцуопц.
COCKPIT_FORCE_IPV4если Telegram таймаутит (сломанный IPv6 у хостера)опц.
TG_PROXYSOCKS5-прокси если Telegram режется провайдеромопц.
COCKPIT_VOICE + ELEVENLABS_API_KEYголосовые ответы (TTS)опц.

Команды бота

/app — кабинет Mini App /sessions — сессии Cursor/Claude Code /subagents — прогресс суб-агентов /status — статус треда /new — чистая сессия /next — хендофф в новую /model — сменить модель /project — рабочая папка /cancel — остановить ход

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

Доступ только из whitelist — чужие Telegram-аккаунты игнорируются. Mini App проверяет подпись Telegram (HMAC) на каждом запросе. Необратимые действия требуют подтверждения тапом. Секреты — только в .env, который не коммитится. Никаких ключей в коде.