Dokümanlar

Buradan başla#

Ajanla kurulum#

Bu sayfa, kendi kişisi için aipager'ı kurup yapılandırması istenen bir yapay zekâ kodlama ajanı (Claude Code ya da shell kullanabilen herhangi bir ajan) içindir. Adım adım izle. Buradaki her komut soru sormadan çalışır ve asla etkileşimli bir terminal gerektirmez.

Referans#

Mimari#

aipager, arka planda çalışan tek süreçli bir asyncio programıdır. Üç dünyayı birbirine bağlar: Telegram'daki sohbetini, dtach altında başlattığın Claude Code süreçlerini ve Claude Code'un hook sistemini. Her şey tek bir olay döngüsünden geçer: işçi havuzu yok, veritabanı yok, süreçler arası kuyruk yok.

Hook olayları#

Claude Code, bir görevin belirli anlarında hook komutları çalıştırır: bir mesaj gönderildi, bir araç çalışmak üzere, bir araç bitti, görev sona erdi ve benzerleri. aipager bu anların her birine bağlanır ve onları Telegram'da işlemlere çevirir: çalışma kartı, izin istekleri, yanıtlar, bildirimler ve denetim kaydı.

Komutlar ve bot arayüzü#

aipager'ı Telegram'dan nasıl yönetirsin. Dört girdi yolu: slash komutları, klavye düğmeleri, Mini App paneli ve serbest mesajlar (metin, dosyalar, sesli mesajlar).

Ekip modu ve gruplar#

Varsayılan olarak aipager kişisel bir bottur: sen ve bot, tek bir özel sohbette, başka kimse yok. Ekip modu onu başka kişilere açar: birkaç geliştiricinin oturumları yönettiği bir Telegram grubu, başka kişilerin botla olan özel sohbetleri ya da ikisi birden. Her sohbetin kendi üyeleri vardır ve her üyenin, orada neye izinli olduğuna karar veren bir rolü vardır: mesaj göndermek, Claude'un sorularını ve izin isteklerini yanıtlamak, oturumları yönetmek ya da yalnızca izlemek.

Çalıştırma#

Güvenlik modeli#

aipager Claude Code'u senin yerine çalıştırır ve Telegram'dan yönetilir. Buradan iki soru çıkar:

Sorun giderme#

Sık karşılaşılan arızalar ve nasıl düzeltileceği. Emin değilsen şunu çalıştır:

Sorun raporları#

aipager bir hatayla karşılaştığında, onu sürdüren kişiye tek dokunuşla bir sorun raporu gönderebilirsin. Bir şey gönderilmeden önce raporun tamamını görürsün, sen söylemeden bilgisayarından hiçbir şey çıkmaz ve raporda asla sohbetlerin, mesajların, adlar, yollar ya da token'lar olmaz. Rapor yalnızca sabit bir alan listesinden oluşur: sürümler, sayılar, tarihler, evet/hayır yanıtları, sabit listelerden seçimler, aipager'ın kendi kodundaki yerler ve onun ap1- ile başlayan hata adları, artı yalnızca sen yazarsan kısa bir not.