Documentazione

Si parte da qui#

Installare con un agente#

Questa pagina è per un agente di programmazione AI (Claude Code, o un qualsiasi agente con una shell) a cui è stato chiesto di installare e configurare aipager per una persona. Seguila passo per passo. Nessun comando qui fa domande e nessuno ha bisogno di un terminale interattivo.

Riferimento#

Architettura#

aipager è un programma asyncio a processo singolo che gira in background. Collega tre mondi: le tue chat di Telegram, i processi di Claude Code che fai girare sotto dtach e il sistema di hook di Claude Code. Tutto passa da un solo event loop: niente worker pool, niente database, niente code tra processi.

Eventi hook#

Claude Code esegue comandi hook in momenti precisi di un'attività: quando viene inviato un messaggio, quando uno strumento sta per partire, quando ha finito, quando l'attività termina, e così via. aipager si aggancia a ognuno di questi momenti e li trasforma nell'attività che vedi in Telegram: la scheda di attività, le richieste di permesso, le risposte, gli avvisi e il log di audit.

Comandi del bot e interfaccia#

Come guidi aipager da Telegram. Ci sono quattro modi di dargli input: comandi slash, pulsanti della tastiera, la dashboard della Mini App e messaggi liberi (testo, file, vocali).

Uso in team e gruppi#

Di base aipager è un bot personale: tu e il bot in una chat privata, nessun altro. L'uso in team lo apre a più persone: un gruppo di Telegram in cui più sviluppatori guidano le sessioni, le chat private di altre persone con il bot, o entrambe le cose. Ogni chat ha i suoi membri e ogni membro ha un ruolo che decide cosa può fare lì: inviare messaggi, rispondere alle domande e alle richieste di permesso di Claude, gestire le sessioni o solo guardare.

Tenerlo in piedi#

Modello di sicurezza#

aipager esegue Claude Code per conto tuo e si comanda da Telegram. Da qui nascono due domande:

Risoluzione dei problemi#

I guasti più comuni e come si risolvono. Nel dubbio, esegui:

Segnalazioni di problemi#

Quando aipager incontra un bug, puoi inviare una segnalazione a chi sviluppa aipager con un tocco. Vedi tutta la segnalazione prima che parta qualsiasi cosa, niente lascia il tuo computer finché non dici di sì, e una segnalazione non contiene mai le tue chat, i messaggi, i nomi, i percorsi o i token. È fatta solo da un elenco fisso di campi: versioni, conteggi, date, risposte sì/no, scelte da elenchi fissi, punti del codice di aipager e il nome ap1- del bug, più una breve nota (solo se la scrivi tu).