Dokumentasi

Mulai dari sini#

Pemasangan dengan agen#

Halaman ini untuk agen coding AI (Claude Code atau agen apa pun yang bisa memakai shell) yang diminta memasang dan mengatur aipager untuk orangnya. Ikuti langkah demi langkah. Setiap perintah di sini berjalan tanpa bertanya dan tidak pernah butuh terminal interaktif.

Rujukan#

Arsitektur#

aipager adalah program asyncio satu proses yang berjalan di latar belakang. Program ini menghubungkan tiga dunia: chat Telegram-mu, proses Claude Code yang kamu jalankan di bawah dtach, dan sistem hook Claude Code. Semuanya lewat satu event loop: tanpa pool worker, tanpa database, tanpa antrean antarproses.

Event hook#

Claude Code menjalankan perintah hook pada momen tertentu dalam tugas: pesan dikirim, alat akan dijalankan, alat selesai, tugas berakhir, dan seterusnya. aipager mengait ke setiap momen itu dan mengubahnya menjadi tindakan di Telegram: kartu kerja, permintaan izin, jawaban, notifikasi, dan log audit.

Perintah dan antarmuka bot#

Cara mengendalikan aipager dari Telegram. Ada empat cara memberi input: perintah slash, tombol keyboard, dasbor Mini App, dan pesan bebas (teks, file, pesan suara).

Mode tim dan grup#

Secara bawaan aipager adalah bot pribadi: kamu dan bot dalam satu chat pribadi, tidak ada orang lain. Mode tim membukanya untuk orang lain: grup Telegram tempat beberapa developer mengendalikan sesi, chat pribadi orang lain dengan bot, atau keduanya. Setiap chat punya anggotanya sendiri, dan setiap anggota punya peran yang menentukan apa yang boleh dilakukannya di sana: mengirim pesan, menjawab pertanyaan dan permintaan izin Claude, mengelola sesi, atau hanya melihat.

Menjalankannya#

Model keamanan#

aipager menjalankan Claude Code atas namamu dan dikendalikan dari Telegram. Dari situ muncul dua pertanyaan:

Pemecahan masalah#

Kegagalan yang sering terjadi dan cara memperbaikinya. Kalau ragu, jalankan:

Laporan masalah#

Saat aipager menemui bug, kamu bisa mengirim laporan masalah ke orang yang merawatnya dengan satu ketukan. Kamu melihat seluruh laporan sebelum apa pun dikirim, tidak ada yang keluar dari komputermu sampai kamu setuju, dan laporan itu tidak pernah berisi chat, pesan, nama, path, atau token milikmu. Laporan disusun hanya dari daftar field yang tetap: versi, jumlah, tanggal, jawaban ya/tidak, pilihan dari daftar tetap, lokasi di kode aipager sendiri, dan nama bug aipager yang berawalan ap1-, ditambah catatan singkat hanya kalau kamu menulisnya.