Kısaca. Telekumanda üç parçadan oluşur: bilgisayarda çalışan bir köprü sunucusu, Android uygulaması ve köprünün kendisinin sunduğu web arayüzü. Ajanlar bilgisayarda, orada kurulu ve oturum açılmış komut satırı araçlarıyla çalışır; Telekumanda onları yönetir, kendi modeli yoktur. Köprü internete açılmaz, telefona yalnız özel bir ağ üzerinden bağlanır.
- Ne
- Kodlama ajanları için uzaktan kumandaAndroid uygulaması, Node.js köprü sunucusu ve web arayüzü
- Ajanlar
- Claude Code, Codex, OpenCode, AntigravityHepsi aynı sohbet arayüzünden; ayrıca OMP (Oh My Pi)
- Platform
- Android ve tarayıcıKöprü Windows'ta geliştiriliyor ve çalışıyor
- Kullanım
- Kendi bilgisayarınızda, özel ağdaBulut hesabı, üyelik sistemi ya da üçüncü taraf sunucu yok
- Kaynak kod
- github.com/afsozer/telekumandaAçık kaynak, AGPL-3.0 lisansı
Ne işe yarar?
- Birden çok ajan, tek arayüz. Oturum başlatılır ya da diskteki eski bir oturum sürdürülür, model seçilir, yanıt akış hâlinde okunur, gerekirse çalışma durdurulur. Bütün ajanlar aynı sohbet düzeninde görünür.
- Onaylar ve bildirimler telefona gelir. Ajan bir araç kullanmak ya da dosya değiştirmek için onay istediğinde bu telefona kart olarak düşer. Tur başladı, dikkat istiyor, bitti ya da hata verdi bildirimleri uygulamanın köprüyle kendi bağlantısından gelir; Firebase gibi bir aracı kullanılmaz.
- Ortak çalışma alanı ve devretme. Aynı klasörde birden çok ajan çalışabilir; yazma kilidi ikisinin aynı anda dosya değiştirmesini önler. "Devret" ile bir ajanın işi, son konuşmayı ve teslimatları özetleyen bir dosyayla başka bir ajana aktarılır.
- Dava dosyası şablonu. Yeni çalışma alanı belgeler ve çıktılar klasörleriyle açılabilir; ajan dilekçe taslağını UYAP'a yüklenebilir UDF olarak çıktılar klasörüne yazar, içtihat ve mevzuat araştırmasını Emsal MCP üzerinden yapar.
- İki taraflı dosya yöneticisi. Bilgisayarın ve telefonun dosyaları aynı ekranda gezilir; Markdown, DOCX ve UDF belgeler uygulamanın içinde açılır.
- Takip. Proje merkezi, işlem geçmişi, çalışan süreçlerin durumu, abonelik ve kota göstergeleri, MCP sunucu yönetimi.
Güvenlik nasıl kurgulandı?
Geçerli anahtarı olan biri köprü üzerinden ajan çalıştırabilir, bilgisayardaki dosyaları okuyup yazabilir. Bu tasarım gereğidir; bu yüzden asıl iş, o anahtarı yalnız doğru cihazın taşımasını sağlamaktır.
- Yalnız özel ağ. Köprü internete açılmaz; telefon ve bilgisayar Tailscale gibi özel bir ağ üzerinden konuşur.
- Cihaz eşleştirme. Ayarlardan alınan altı haneli kod beş dakika geçerlidir ve tek kullanımlıktır; yanlış denemeler sınırlanır. Her telefon kendi anahtarını alır, anahtar yenilendiği anda eskisi geçersiz olur.
- Anahtar köprüde açık durmaz. Köprü cihaz anahtarlarının yalnız SHA-256 özetini saklar; açık anahtarı yalnız eşleştirme ya da yenileme yanıtında bir kez verir.
- Gizli bildirim. Güvenlik açıkları, depodaki SECURITY.md dosyasında anlatıldığı gibi herkese açık olmayan bir yoldan bildirilir; projenin tek güvenlik bakımcısı benim.
Ne yapmaz?
- Ajanların yerine geçmez. Kendi yapay zekâ modeli yoktur; Claude Code, Codex gibi araçların bilgisayarda kurulu ve oturum açılmış olması gerekir.
- İnternete açık bir hizmet değildir. Köprü güvenilen yerel bir servis olarak tasarlandı; internete açılması desteklenmez.
- iOS uygulaması yoktur. Telefon tarafı Android; diğer cihazlardan web arayüzü kullanılabilir.
Teknik ayrıntı
- Android
- Kotlin, Jetpack ComposeEkrandan bağımsız mantık ayrı bir JVM modülünde, birim testli
- Köprü
- Node.js 22REST ve WebSocket; ajanlara sözde terminal (node-pty) ve kendi protokolleriyle bağlanır
- Web
- React, TypeScript, ViteKöprü tarafından sunulur, ayrı sunucu gerektirmez
- Test
- Android'de 900'ü, köprüde 800'ü, web arayüzünde 400'ü aşkın birim testi
- Geliştirme
- Tasarım ve ürün kararları bendeKodlama yapay zekâ destekli araçlarla (Claude Code); Ağustos 2026'dan beri her gün kendi işimde kullanıyorum
Kaynak kod
Kaynak kod GitHub'da açık ve GNU Affero Genel Kamu Lisansı sürüm 3 (AGPL-3.0) ile lisanslı. Kodu kullanabilir, değiştirebilir ve dağıtabilirsiniz; değiştirdiğiniz bir sürümü ağ üzerinden başkalarına hizmet olarak sunarsanız, değiştirdiğiniz kaynak kodu da o kullanıcılara aynı lisansla açmanız gerekir. Güvenlik açıkları, depodaki SECURITY.md dosyasında anlatılan yolla gizli olarak bildirilebilir.
github.com/afsozer/telekumanda
Bu sayfa 7 Ekim 2026 itibarıyla 11.115 sürümünü anlatıyor.