Docs

Hier anfangen#

Mit einem Agenten installieren#

Diese Seite ist für einen KI-Coding-Agenten (Claude Code oder irgendeinen Agenten mit Shell), der aipager für seine Person installieren und einrichten soll. Folge ihr Schritt für Schritt. Jeder Befehl hier läuft ohne Rückfragen und braucht nie ein interaktives Terminal.

Nachschlagen#

Architektur#

aipager ist ein asyncio-Programm aus einem einzigen Prozess, das im Hintergrund läuft. Es verbindet drei Welten: deinen Telegram-Chat, die Claude-Code-Prozesse, die du unter dtach laufen lässt, und das Hook-System von Claude Code. Alles läuft über eine einzige Event-Loop: keine Worker-Pools, keine Datenbank, keine Warteschlangen zwischen Prozessen.

Hook-Ereignisse#

Claude Code führt Hook-Befehle zu festen Zeitpunkten einer Aufgabe aus: Eine Nachricht wird abgeschickt, ein Tool wird gleich ausgeführt, ein Tool ist fertig, die Aufgabe ist zu Ende und so weiter. aipager hängt sich an jeden dieser Zeitpunkte und macht daraus Aktivität in Telegram: die Arbeitskarte, Berechtigungsanfragen, Antworten, Hinweise und das Audit-Log.

Befehle und Oberfläche des Bots#

Wie du aipager aus Telegram steuerst. Vier Wege der Eingabe: Slash-Befehle, Buttons der Tastatur, das Dashboard der Mini App und freie Nachrichten (Text, Dateien, Sprachnachrichten).

Teambetrieb und Gruppen#

Standardmäßig ist aipager ein privater Bot: du und der Bot in einem privaten Chat, sonst niemand. Der Teambetrieb öffnet ihn für mehr Personen: eine Telegram-Gruppe, in der mehrere Leute, die programmieren, Sitzungen steuern, die eigenen privaten Chats anderer Personen mit dem Bot, oder beides. Jeder Chat hat seine eigenen Mitglieder, und jedes Mitglied hat eine Rolle, die entscheidet, was es dort tun darf: Nachrichten schicken, die Fragen und Berechtigungsanfragen von Claude beantworten, Sitzungen verwalten oder nur zusehen.

Im Betrieb#

Sicherheitsmodell#

aipager führt Claude Code für dich aus und wird aus Telegram gesteuert. Daraus folgen zwei Fragen:

Fehlerbehebung#

Häufige Fehler und ihre Lösung. Im Zweifel führ aus:

Problemberichte#

Wenn aipager auf einen Bug stößt, kannst du der Person, die es pflegt, mit einem Tippen einen Problembericht schicken. Du siehst den ganzen Bericht, bevor irgendetwas gesendet wird, nichts verlässt deinen Computer, bevor du es sagst, und ein Bericht enthält nie deine Chats, Nachrichten, Namen, Pfade oder Tokens. Er besteht nur aus einer festen Liste von Feldern: Versionen, Anzahlen, Daten, Ja/Nein-Antworten, Auswahlen aus festen Listen, Stellen im eigenen Code von aipager und den ap1--Namen seiner Bugs, dazu eine kurze Notiz, nur wenn du eine schreibst.