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

Почни звідси#

Встановлення за допомогою агента#

Ця сторінка для ШІ-агента для програмування (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-, плюс коротка примітка, лише якщо ти її напишеш.