Документация

Начни отсюда#

Установка с помощью агента#

Эта страница для ИИ-агента для программирования (Claude Code или любого агента с shell), которого попросили установить и настроить aipager для своего человека. Следуй ей шаг за шагом. Каждая команда здесь выполняется без вопросов и никогда не требует интерактивного терминала.

Справочник#

Архитектура#

aipager это программа на asyncio из одного процесса, которая работает в фоне. Она соединяет три мира: твой чат в Telegram, процессы Claude Code, которые ты запускаешь под dtach, и систему hooks Claude Code. Всё проходит через один цикл событий: никаких пулов воркеров, никакой базы данных, никаких очередей между процессами.

События hooks#

Claude Code запускает команды hooks в определённые моменты задачи: отправлено сообщение, инструмент вот-вот запустится, инструмент закончил, задача завершилась и так далее. aipager цепляется за каждый из этих моментов и превращает их в действия в Telegram: рабочую карточку, запросы разрешения, ответы, уведомления и журнал аудита.

Команды и интерфейс бота#

Как управлять aipager из Telegram. Четыре способа ввода: slash-команды, кнопки клавиатуры, панель Mini App и свободные сообщения (текст, файлы, голосовые).

Работа в команде и группы#

По умолчанию aipager это личный бот: ты и бот в одном личном чате, больше никого. Командный режим открывает его для других людей: группа Telegram, где сессиями управляют несколько программистов, личные чаты других людей с ботом или и то и другое. У каждого чата свои участники, и у каждого участника есть роль, которая решает, что ему там можно: отправлять сообщения, отвечать на вопросы и запросы разрешения Claude, управлять сессиями или только смотреть.

Эксплуатация#

Модель безопасности#

aipager запускает Claude Code вместо тебя, а управляется он из Telegram. Отсюда два вопроса:

Решение проблем#

Частые сбои и как их исправить. Если сомневаешься, запусти:

Отчёты о проблемах#

Когда aipager натыкается на баг, можно одним нажатием отправить отчёт о проблеме тому, кто его поддерживает. Ты видишь весь отчёт до того, как что-то будет отправлено, ничего не уходит с твоего компьютера, пока ты не скажешь, и в отчёте никогда нет твоих чатов, сообщений, имён, путей или токенов. Он собирается только из фиксированного списка полей: версии, количества, даты, ответы да/нет, выбор из фиксированных списков, места в собственном коде aipager и имена его багов с ap1-, плюс короткая заметка, только если ты её напишешь.