İçeriğe atla
ColliePWA

Terminal ajanlarınız için mobil bir arayüz.

ColliePWA, zaten çalıştığınız yerde, makinenizdeki terminal multiplexer içinde sizinle buluşur. Kodlama ajanları bölünmüş panellerde çalışır ve girdi ister. ColliePWA çalışan örnekleri listeler, engellenen oturumları işaretler ve bir telefondan yanıt vermenizi sağlar.

  • Multiplexer arka ucu:
  • Herdr
  • tmux
  • Zellij

1.0 sürümünde birincil olarak desteklenen arka uç Herdr sistemidir. tmux ve zellij desteği deneyseldir. Ayrıntılar Çoklayıcılar içinde

Sahte oturumlarla statik arayüz yakalama. Demo arayüzü etkileşimli değildir.

01/Demo

Etkileşimli demo.

Bu, üretim ColliePWA istemcisidir. Ajanlar, terminaller ve yanıtlar tarayıcınızda yerel olarak yeniden oynatılan sahte verileri kullanır. Bir sunucuda hiçbir şey çalışmaz ve ağ trafiği gönderilmez.

  1. 01Listenin başındaki engellenen ajanı seçin.
  2. 02İstemi inceleyin. Bu, ham terminal çıktısını doğrudan yansıtır.
  3. 03Yürütmeyi sürdürmek için bir yanıta dokunun.
  4. 04Değiştiricilere ve gezinmeye erişmek için Tuşlar'ı seçin: Esc, Tab, oklar ve Ctrl.
Tam ekran demoyu açın

02/Çekirdek mimari

Çekirdek temeller ve 1.0 eklemeleri.

yürütme sırasında

Doğrudan terminal yansıtma

ColliePWA, kayıplı dökümlerden veya özetlerden kaçınarak tam ANSI renk desteğiyle ham ajan terminal çıktısını aktarır. Mobil görünüm, masaüstü terminalinizle bayt bayt eşleşir.

ANSI renkleriyle ajan yürütmesi sırasında yansıtılan terminal bölmesi. ColliePWA bağlantı olmadan çalışıyor. Etkin bir arka uç olmadan dokunma etkileşimleri devre dışı bırakılır.

girdi gerektiğinde

Tek dokunuşla girdi yanıtları

Etkileşimli izin istemleri ayrı işlem düğmeleri olarak oluşturulur. Senkronizasyon dışı gönderimleri önlemek için girdi gönderilmeden önce geçerli terminal durumuna göre doğrulanır.

Bir izin isteminde kullanıcı onayını bekleyen engellenmiş bölme. ColliePWA bağlantı olmadan çalışıyor. Etkin bir arka uç olmadan dokunma etkileşimleri devre dışı bırakılır.

1.0 sürümündeki yenilikler

03Yerelleştirme desteği

Ayarlar içinde yapılandırılan İngilizce, Almanca, İspanyolca, Korece, Japonca ve Çince için arayüz çevirileri. Yalnızca kullanıcı arayüzü çerçevesi çevrilir; ajan terminal akışları bayt düzeyinde kesin kalır.

Ayrıntılar Yapılandırma içinde

Ayarlar içindeki dil seçim arayüzü. ColliePWA bağlantı olmadan çalışıyor. Etkin bir arka uç olmadan dokunma etkileşimleri devre dışı bırakılır.

04Açık cihaz yetkilendirmesi

collie pair, on dakikalık TTL ve beş deneme sınırına sahip sekiz karakterlik bir belirteç oluşturur. İstemci bunu, karması bridge tarafından saklanan bir kimlik doğrulama belirteciyle takas eder. Bir cihazın yetkisinin iptal edilmesi, sonraki isteğini düşürür.

Ayrıntılar Güvenlik içinde

Bağlantısız bir bridge üzerindeki ilk eşleştirme ekranı. ColliePWA bağlantı olmadan çalışıyor. Etkin bir arka uç olmadan dokunma etkileşimleri devre dışı bırakılır.

05Sesli girdi transkripsiyonu

Bas-konuş doğrudan girdi düzenleyicisine yazıya döker. Ayrı anahtarlar olmadan OpenAI uyumlu API'leri, yerel whisper.cpp veya parakeet.cpp örneklerini ya da mevcut Codex CLI kimlik bilgilerini destekler. tailscale serve veya bir ters proxy aracılığıyla HTTPS gerektirir.

Ayrıntılar Ses girişi ve Web Push içinde

Transkripsiyon çıktı hedeflerini yönlendiren ses yapılandırması. ColliePWA bağlantı olmadan çalışıyor. Etkin bir arka uç olmadan dokunma etkileşimleri devre dışı bırakılır.

06Durum değişikliğinde Web Push

İsteğe bağlı Web Push, bir ajan girdi için beklediğinde veya işlemi tamamladığında bildirimler iletir. Bir bildirimin seçilmesi o ajanı açar. Geçiş filtreleri ve rahatsız etmeyin dönemleri, her cihazda bridge genelindedir. HTTPS ve collie push-keys gerektirir.

Ayrıntılar Ses girişi ve Web Push içinde

07Git worktree çalışma alanları

Herdr, üst düzey girdiler oluşturmak yerine git worktree yapılarını doğrudan üst depo kopyasının altına yuvalar. Worktree yapıları yerel çalışma alanları olarak izlenir.

`collie` deposu altında yuvalanmış iki worktree; harici çalışma alanı `blog` düz olarak oluşturulur. ColliePWA bağlantı olmadan çalışıyor. Etkin bir arka uç olmadan dokunma etkileşimleri devre dışı bırakılır.

08Zen modu

Tüm gezinmeyi daraltmak ve yalnızca terminali görüntülemek için bölme menüsüne bir açma/kapatma düğmesi ekleyen isteğe bağlı bir ayar. Çıkmak için tek bir kayan düğme bırakır.

Ayrıntılar Yapılandırma içinde

Bölme ayarlarında Zen modu açma/kapatma yapılandırması. ColliePWA bağlantı olmadan çalışıyor. Etkin bir arka uç olmadan dokunma etkileşimleri devre dışı bırakılır.

Ağ topolojisi

09Yapılandırılabilir aktarım ağ geçidi

ColliePWA, genel giriş olmadan yalnızca localhost'a bağlanır. Mobil cihazlara aktarım, collie start içindeki otomatik Tailscale yapılandırmasını, WireGuard ağlarını, tünelleri veya standart ters proxy'leri kullanabilir.

Ayrıntılar Güvenlik içinde

10Çok ana bilgisayarlı crew koordinasyonu

crew, her makinedeki ColliePWA'dır. Telefonunuz lider aracılığıyla hepsine erişir. Yüklemeler, günlükler, denetim günlükleri, güncellemeler ve yük devretme; makine başınadır, tmux ve zellij altında da geçerlidir. Herdr'ın kayıtlı makineleri Herdr'ın kendi penceresinde kalır. crew, telefonunuzun gördüğü şeydir.

Ayrıntılar Crew'lar içinde

lead, deputy ve peer düğümlerini gösteren ana bilgisayar topolojisi görünümü. ColliePWA bağlantı olmadan çalışıyor. Etkin bir arka uç olmadan dokunma etkileşimleri devre dışı bırakılır.

Ek özellikler

11Birleşik süreç denetimi
Çalışan aracıları yürütme durumuna göre toplar, engellenen süreçleri arayüzün en üstünde önceliklendirir.
12Tam kaydırma geçmişini saklama
ColliePWA, geçmiş kaydırma alanını geçerli terminal görünüm alanının ötesinde koruyarak eksiksiz aracı oturumu günlüklerini aktarır.
13Çoklu oturum çoğullama
Yapılandırılmış tüm Herdr oturumlarını, üst gezinti çubuğundan seçilebilen tek bir ağ geçidinden sunar.

ColliePWA README dosyasındaki tam liste

03/Kimin için

Aracıları bir çoğullayıcıda çalıştıran ve masadan uzaklaşan geliştiriciler için.

ColliePWA, tek bir ana makinedeki terminal bölmelerinde çalışan birden fazla kodlama aracına sahip tek bir operatör içindir. Terminalin yerini almaz. Bekleyen bir aracıya telefondan yanıt vermenizi, ardından yaptığınız işe geri dönmenizi sağlar.

Zaten çalıştığınız yerde sizinle buluşur
Zaten çalıştırdığınız çoğullayıcıya (Herdr, tmux veya zellij) bağlanır. Yeni bir oturum modeli ve aracıyı saran bir katman yoktur. 1.0 sürümünde desteklenen arka uç Herdr sistemidir. tmux ve zellij deneyseldir.
Uygulama mağazası yok, bulut yok, hesap yok
tailnet ağınız üzerinden kendi makinenizden sunulan bir PWA. Mağaza kaydı, sağlayıcı hesabı ve bulut katmanı yoktur. Tek harici servisler sizin etkinleştirdiklerinizdir: tarayıcı anında iletme servisi ve yerel bir motor yerine seçerseniz bulut transkripsiyon uç noktası. Ana ekrana ekleyin ve bir uygulama gibi çalışsın.
Sahip olmadığınız klavye için tasarlandı
Özel tuşlar, oklar ve değiştiriciler bir tuş takımında bulunur. Kendi hızlı yanıtlarınız ve eğik çizgi komutlarınız tek bir dokunuş gerektirir. Giriş alanı düz bir metin alanıdır, bu nedenle telefonda sesle yazma doğrudan çalışır. Bir HTTPS kaynağında collie stt setup komutunu çalıştırdığınızda yerleşik ses girişi kullanılabilir.
Bir aracı girdi beklediğinde bildirimler
İsteğe bağlı Web Push, bir aracı girdi beklediğinde veya tamamlandığında sizi uyarır. Bildirime dokunmak ilgili bölmeyi açar. HTTPS ve collie push-keys gerektirir.
Birden fazla makine, tek bir URL
Bir crew, önceden yetkilendirdiğiniz ve tarayıcıdan tetiklediğiniz bir yük devretme ile her ana makineyi tek bir adresin arkasına yerleştirir. Tek bir onay, aynı ekrandan tüm crew yapısını günceller.
MIT lisanslıdır. Katkıda bulunun.
Kaynak kod MIT lisansı altında GitHub üzerindedir. Çalışan kurulumların bildirimleri de dahil olmak üzere, tmux ve zellij kurulumlarından gelen hata bildirimleri memnuniyetle karşılanır.

04/Mimari

Yerel yürütme modeli ve güvenlik sınırları.

ColliePWA, mevcut kullanıcı izinlerinizle etkileşimli terminal oturumlarınıza yazar. Bağlantı noktasına ağ erişimi olan herhangi bir istemci, terminal çıktısını okuyabilir ve rastgele komutlar çalıştırabilir.

Yerel aracı ana makinesinde çalışır
Yerel çoğullayıcı oturumlarını doğrudan yansıtır. Herdr 1.0 sürümünde tam olarak desteklenir; tmux ve zellij arka uçları deneyseldir. Bulut arka uçları, uzak sunucular veya harici hesaplar olmadan çalışır.
Yalnızca loopback bağlama
Loopback arayüzüne bağlanır ve asla 0.0.0.0 adresine bağlanmaz. Tam olarak tek bir güçlendirilmiş ön kapı yayınlanır: tailscale serve veya yapılandırdığınız bir ters proxy. Asla funnel değil.
Ana bilgisayar düzeyinde kimlik doğrulama
Erişim denetimi, uygulama oturumları yerine ağ katmanında ele alınır. Yetkilendirilmiş bir cihazdaki herhangi bir kullanıcı tam kabuk erişimine sahiptir.
Yerel sistem erişim sınırı
Çoğullayıcı unix etki alanı soketleri yerel dosya sistemi izinlerini uygular. ColliePWA'nın TCP bağlantı noktasına diğer yerel kullanıcılar erişebilir. Yalıtımı, giriş filtreleri ve COLLIE_TRUSTED_USER kullanarak uygulayın.

MIT lisanslı kaynak. Ayrıntılı erişim denetimleri ve güven sınırları için güvenlik notunu inceleyin.

05/Kurulum

Kabuk betiği aracılığıyla kurun veya kaynaktan derleyin.

ColliePWA, aracılarınızın yanında, bunları zaten barındıran makinede çalışır. Betik, platformunuz için bir sürüm indirir ve doğrular. Kaynaktan derleme git ve Bun gerektirir; sürümlerin kapsamadığı bir makine için izlenecek yoldur. Her ikisi de collie komutunu PATH'inize ekleyerek sonlanır ve hiçbiri herhangi bir işlem başlatmaz.

$ curl -fsSL https://colliepwa.dev/install.sh | sh

Kısa bir POSIX sh yükleyicisi. sudo adımını atlar, hiçbir sistem hizmetini başlatmaz ve dosyaları ~/.local/share/collie ile ~/.local/bin dizinlerine yalıtır. En son sürümü alır, yayınlanan sha256 karmasını doğrular, ikiliyi yazar ve PATH'i günceller. curl, tar ve sha256 araçlarını gerektirir.

Bu kaynak konumundan yerel olarak sunulur. Kanonik kaynak depodaki scripts/install.sh dosyasında bulunur. Çalıştırmadan önce betiği inceleyin:

$ curl -fsSL https://raw.githubusercontent.com/AltanS/collie/main/scripts/install.sh | less
$ curl -fsSL https://raw.githubusercontent.com/AltanS/collie/main/scripts/install.sh | sh

Daha yeni sürümleri almak, doğrulamak ve bunlara geçmek için collie update komutunu çalıştırın. Önceki sürümler collie update --rollback için önbelleğe alınmış olarak kalır. Kaynak derlemeleri, sürüm geri alma hedefleri olmadan git revizyonlarını doğrudan günceller.

2026-08-31 tarihindeki 2ded11d konumunda scripts/install.sh dosyasından alındı.

Kalan bir adım: başlatın.

# one step left. It asks which multiplexer to mirror — herdr, tmux or
# zellij — and writes your answer to ~/.config/collie/.env, creating it.
$ collie start

Yapılandırma isteğe bağlıdır ve start komutunun oluşturduğu ~/.config/collie/.env dosyasında bulunur. COLLIE_TRUSTED_USER değerini ve varsayılanlar uymuyorsa bağlantı noktasını veya ön kapıyı burada ayarlayın.

Yerel ağınız üzerinden mobil cihazınızdan oluşturulan URL'ye erişin. Tam görünüm alanı modu için ana ekrana ekleyin.

Özel giriş gerektirir. ColliePWA yalnızca loopback arayüzlerine bağlanır. Tailscale varsayılan olarak yapılandırılmıştır: collie start, MagicDNS ana bilgisayar adınız üzerinde tailscale serve komutunu çalıştırır. Özel ters proxy'ler, ağ örgüleri ve SSH tünelleri DEPLOYMENT.md dosyasında belgelenmiştir. Yalnızca tek kullanıcılı mimari.

Önkoşullar, derleme kılavuzları ve ilk çıktı