Docs

Commencer ici#

Installer avec un agent#

Cette page s'adresse à un agent de programmation IA (Claude Code, ou n'importe quel agent qui a un shell) à qui l'on demande d'installer et de configurer aipager pour la personne qu'il aide. Suivez-la étape par étape. Toutes les commandes d'ici s'exécutent sans poser de questions et n'ont jamais besoin d'un terminal interactif.

Référence#

Architecture#

aipager est un programme asyncio d'un seul processus qui tourne en arrière-plan. Il relie trois mondes : votre discussion Telegram, les processus Claude Code que vous lancez sous dtach, et le système de hooks de Claude Code. Tout passe par une seule boucle d'événements : pas de pool de workers, pas de base de données, pas de files d'attente entre processus.

Événements de hook#

Claude Code lance des commandes de hook à des moments précis d'une tâche : un message est envoyé, un outil va s'exécuter, un outil a fini, la tâche est terminée, et ainsi de suite. aipager s'accroche à chacun de ces moments et en fait de l'activité dans Telegram : la carte d'activité, les demandes d'autorisation, les réponses, les notifications et le journal d'audit.

Commandes et interface du bot#

Comment piloter aipager depuis Telegram. Quatre façons d'entrer : les commandes slash, les boutons du clavier, le tableau de bord de la Mini App et les messages libres (texte, fichiers, messages vocaux).

Usage en équipe et groupes#

Par défaut, aipager est un bot privé : vous et le bot dans une discussion privée, personne d'autre. L'usage en équipe l'ouvre à plus de monde : un groupe Telegram où plusieurs personnes qui programment pilotent des sessions, les discussions privées d'autres personnes avec le bot, ou les deux. Chaque discussion a ses propres membres, et chaque membre a un rôle qui décide de ce qu'il peut y faire : envoyer des messages, répondre aux questions et aux demandes d'autorisation de Claude, gérer les sessions, ou seulement regarder.

Le faire tourner#

Modèle de sécurité#

aipager fait tourner Claude Code pour vous et se pilote depuis Telegram. Deux questions en découlent :

Dépannage#

Les pannes courantes et leur solution. En cas de doute, lancez :

Rapports de problèmes#

Quand aipager rencontre un bug, vous pouvez envoyer un rapport de problème à la personne qui le maintient, en un seul appui. Vous voyez tout le rapport avant le moindre envoi, rien ne quitte votre ordinateur tant que vous ne l'avez pas dit, et un rapport ne contient jamais vos discussions, vos messages, vos noms, vos chemins ni vos tokens. Il est construit uniquement à partir d'une liste fixe de champs : des versions, des nombres, des dates, des réponses oui/non, des choix dans des listes fixes, des endroits du code d'aipager lui-même et les noms ap1- de ses bugs, plus une note courte, seulement si vous en écrivez une.