Ajan çalışır, insan karar verir

Ne istediğinizi kendi cümlelerinizle anlatın. Zahmetli kısmı ajan üstlenir; her değişikliğin kontrolü sizde kalır.

Bir proje seçinAjan yalnızca o klasörü ve açıkça eklediğiniz dizinleri görebilir.

Görevi anlatınGündelik dille. Sonraki mesajlar aynı oturumda devam eder.

Planı inceleyinÖnce salt okunur keşif. Siz onaylayana kadar hiçbir şey düzenlenmez.

Her işlemi onaylayınHer yazma için diff; her komut için komut, klasör ve gerekçe.

Doğrulayın ve saklayınHer dosyayı kabul edin veya reddedin, testleri çalıştırın, istediğiniz zaman commit edin.

Neyin değişeceğini tam olarak görün

Her düzenleme, yazılmadan önce unified diff olarak gelir. Siz karar verirken diskteki dosya değişirse düzenleme reddedilir; böylece kendi çalışmanızın üzerine asla sessizce yazılmaz.

Önerildi → uygulandı → test edildi → commit edildi: her dosya için net bir durum.
Dosya bazında kabul / ret; reddetmek orijinal içeriği geri getirir.
Yerel Git kontrol noktaları; dalınıza ve index'inize asla dokunmaz.
Yalnızca Commit'e tıkladığınızda commit. Asla push yok.

Önerilen bir dosya değişikliğinin unified diff'ini gösteren onay penceresi

Her şey tek pencerede

Uygulamadan çıkmadan planlayın, geliştirin, inceleyin ve yayınlayın; token’larınızın nereye gittiğini de tam olarak görün.

Mod seçici: düzenlemeden önce sor, otomatik düzenle, Auto ve Plan modu — Dört mod
Düzenlemeden önce sor, otomatik düzenle, korumalı alanda Auto ya da Plan modu: önce yalnızca okuma, sonra onayınız için bir plan. Shift+Tab, görevin ortasında bile modlar arasında geçiş yapar.

Bir pull request’i ve konuşmasını gösteren GitHub paneli — GitHub paneli
Cihaz koduyla veya bir token ile giriş yapın; pull request’lere, issue’lara, workflow çalıştırmalarına ve sürümlere göz atın, konuşmaları okuyup yorum yazın. Token anahtarlığınızda kalır.

Workers ve Pages projelerini listeleyen Cloudflare paneli — Cloudflare paneli
Bir API token’ı yapıştırın; Workers’larınızı, Pages projelerinizi, R2 bucket’larınızı, D1 veritabanlarınızı ve KV ad alanlarınızı salt okunur olarak bir bakışta görün.

Son 30 günün günlük kullanımını gösteren token kullanım panosu — Token tasarrufu ve pano
Varsayılan olarak açık: uzun oturumları 120k token’da sıkıştırır ve komut çıktısını kırpar. Pano, son 30 günü model bazında ve yükün nereden geldiğini gösterir.

Modele güvenilemeyeceği varsayımıyla tasarlandı

Model çıktısı ve depo içeriği güvenilmeyen girdi olarak ele alınır. Onaylar ilk savunma katmanıdır, tek katman değil.

⌘

İşlem bazında onay

Tam komut, çalışma dizini, ajanın belirttiği gerekçe ve komutun ne yaptığı (okuma, yazma, ağ, git, kurulum). Onaylar asla hatırlanmaz.

⛨

Bubblewrap korumalı alanı

Ajanın komutları yalnızca proje içine yazabilir ve belirli alan adlarına izin vermediğiniz sürece ağa erişemez.

Kesin engeller

sudo, geniş kapsamlı rm -rf, push, geçmişi yeniden yazma, yayınlama, yükleme, SSH, anahtarlık erişimi ve uygulamanın kendi ayarlarına dokunma girişimleri doğrudan reddedilir.

⌖

Yol standartlaştırma

.., sembolik bağlantılar ve ~ ile projenin dışına çıkılamaz. SSH anahtarları, bulut kimlik bilgileri, tarayıcı profilleri ve anahtarlıklar her zaman yasaktır.

⚿

Sırlar sır olarak kalır

.env, özel anahtarlar ve kimlik bilgisi dosyaları açık onay gerektirir; günlüklerde, geçmişte ve arayüzde gizlenir.

⏻

Asla root değil, telemetri yok

root olarak çalışmayı reddeder. Geliştirici sunucusu, proxy veya analiz yok: veriler yalnızca seçtiğiniz model sağlayıcısına ve VOID Portal için kendi kurduğunuz relay sunucusuna gider.

Abonelik veya anahtar. Dürüst rakamlar.

Claude aboneliğinizi veya masaüstü anahtarlığınızda saklanan bir Anthropic Console API anahtarını kullanın ve tek tıkla geçiş yapın. VOID Workshop tek bir istek göndermeden önce kimlik bilgisinin kaynağını doğrular.

Görev başına ve günlük limitler (varsayılan: 1 $ ve 3 $), ayrıca tur ve çıktı token sınırları.
Kredi bittiğinde durur; asla kredi satın almaz veya ödeme yöntemini değiştirmez.
Modeller Models API'den anahtarınıza göre gelir; hiçbiri koda gömülü değildir.
Kesin bir tavan için Console çalışma alanı harcama limitiyle birlikte kullanın.

Bunlar tahmindir, bakiye değil. Maliyet, Agent SDK'nın bildirdiği token kullanımından tahmin edilir. Yeniden denemeler, önbellekleme, fiyat değişiklikleri ve kuruluşunuzdaki diğer kullanımlar gerçek faturayı etkiler ve uygulamanın kalan kredinizi okuyabileceği bir API yoktur. VOID Workshop bunu durum çubuğunda belirtir ve Console Billing bağlantısı verir.

Nebula temasında yerleşik kod düzenleyici, sözdizimi renkleri temadan türetilmiş

Gerçek bir düzenleyici, sizin renklerinizle

Projedeki herhangi bir dosyayı yerleşik CodeMirror düzenleyicide açın, küçük düzeltmeleri kendiniz yapın, gerisini ajana bırakın. Sözdizimi vurgulaması temanızdan üretilir; böylece kendi yaptıklarınız dahil her tema uyumlu renkler alır.

Sekmeler, arama ve kaydetme; ajan veya başka bir program diskteki dosyayı değiştirdiğinde uyarı.
Çoklu imleç ve projeler arasında geçerken korunan geri alma geçmişi.
Hassas dosyalar önce sorar, sonra açılır veya kaydedilir.

VOID Portal: telefonunuz bir kumanda

Android için yardımcı uygulama. Her yerden görev başlatın ve sıraya koyun, değişiklikleri ve komutları onaylayın (doğrudan bildirimden bile), model, mod ve hesap değiştirin; bir görev bittiğinde, size ihtiyaç duyduğunda veya PC çevrimdışı olduğunda haberdar olun.

telefon ──wss──► relay'iniz ◄──wss── PC
└──── uçtan uca şifreli, AES-256-GCM ────┘

QR koduyla eşleştirme. Sır yalnızca kodun içindedir; relay ne onu ne istemlerinizi ne de kodunuzu görür.
Evde hiçbir şey açıkta değil. İki taraf da dışarıya bağlanır; açık port veya port yönlendirme yoktur.
Masaüstüyle aynı kurallar. Engellenen komutlar engelli kalır; riskli olanlar yine onayınızı gerektirir.
PC'nizle uyumlu temalar, Material You ve rengi değiştirilebilen uygulama simgesi.

VOID Portal ana ekranı: PC çevrimiçi, etkin görevler ve bekleyen bir onay — PC durumu, görevler, sizi bekleyenler

Telefonda diff'iyle birlikte bir dosya değişikliğini onaylama — Tüm diff'i görerek onaylayın

VOID Portal'da bir görev sohbeti — Görevi takip edin ve yanıtlayın

VOID Portal ayarları ve tema seçimi — PC ayarları ve temalar

Beş dakikada kendi relay'iniz

Ortak bir relay yok: herkes kendi relay'ini ücretsiz bir Cloudflare hesabına kurar, böylece trafiğiniz asla başkasının sunucusundan geçmez. Ücretsiz Workers planı tek bir kişi için fazlasıyla yeterlidir.

Cloudflare hesabıÜcretsiz kaydolun ve bir workers.dev alt alan adı seçin.

Worker'ı kurunwrangler deploy komutunu remote/relay içinden çalıştırın.

DoğrulayınDuman testi relay'inize karşı 18 kontrol çalıştırır.

Workshop'a tanıtınSettings → VOID Portal (phone) → Relay.

Telefonu eşleştirinPair a phone'a tıklayın, ardından uygulamada QR kodunu tarayın.

# depo klonunuzdan
$ cd remote/relay
$ npm install
$ npx wrangler login     # wrangler'ı tarayıcıda yetkilendirin, bir kez
$ npx wrangler deploy    # → https://void-relay.<your-subdomain>.workers.dev
$ node test/smoke.mjs wss://void-relay.<your-subdomain>.workers.dev

# isteğe bağlı: VOID Portal uygulama içi güncellemeleri (veya wrangler.toml'daki [[r2_buckets]] bloğunu silin)
$ npx wrangler r2 bucket create void-portal-updates

Ardından wss://void-relay.<your-subdomain>.workers.dev adresini Settings → VOID Portal (phone) → Relay alanına girin. Eşleştirme kodunu veya telefonu mu kaybettiniz? Aynı yerden cihazın eşleştirmesini kaldırın; anahtarı artık çalışmaz. Tam kılavuz remote/README.md dosyasında (İngilizce).

Linux'a kurulum

Kaynaktan birkaç dakikada derlenir ve yalnızca kendi kullanıcınız için kurulur. root yok, sistem dosyası yok.

# 1. bağımlılıklar (Node.js ≥ 22.13, Rust ≥ 1.80)
#    Arch Linux
$ sudo pacman -S --needed base-devel nodejs npm rust git webkit2gtk-4.1 gtk3 libsoup3 \
    librsvg libayatana-appindicator openssl libsecret bubblewrap socat ripgrep
#    Debian / Ubuntu 24.04+ (artı nodejs.org / rustup.rs'den Node.js 22 ve Rust)
$ sudo apt install build-essential git libwebkit2gtk-4.1-dev libgtk-3-dev libsoup-3.0-dev \
    librsvg2-dev libayatana-appindicator3-dev libssl-dev libsecret-1-dev bubblewrap socat ripgrep

# 2. derleyin ve ~/.local'a kurun
$ git clone https://github.com/M4S4T0-V01D/void-workshop.git
$ cd void-workshop
$ ./scripts/build.sh
$ ./scripts/install.sh

# 3. başlatın, ardından Settings → Sign-in & API key: Claude ile giriş yapın, bir anahtar yapıştırın veya Ollama'yı seçin
$ void-workshop

VOID Portal	`cd remote/android && ./gradlew :app:assembleRelease` (JDK 17), APK'yı telefonunuza kurun ve relay'inizle eşleştirin
Güncelleme	`git pull && ./scripts/build.sh && ./scripts/install.sh`
Kaldırma	`./scripts/uninstall.sh` (geçmişi, ayarları ve kayıtlı anahtarı da silmek için `--purge` ekleyin)
Kılavuzlar	Claude aboneliği · API anahtarı kurulumu · Ollama · Faturalama ve limitler · Güvenlik modeli (İngilizce)

Sorular

Kısa yanıtlar. Ayrıntılar depodaki kılavuzlarda.

Ücretsiz mi?

VOID Workshop ve VOID Portal ücretsiz ve açık kaynaklıdır (MIT). Yalnızca kullandığınız model için ödeme yaparsınız: Claude aboneliği, kendi Console hesabınızdaki Anthropic API kullanımı veya yerel Ollama modelleriyle hiçbir şey. Relay, Cloudflare'in ücretsiz planına sığar.

Kodum veya anahtarım bir yere gönderiliyor mu?

Yalnızca seçtiğiniz model sağlayıcısına. Telemetri yok, geliştirici sunucusu yok. Anahtarlar masaüstü anahtarlığınızda kalır ve VOID Portal trafiği kendi kurduğunuz relay üzerinden uçtan uca şifrelenir.

Claude Code'dan farkı ne?

Aynı Claude Agent SDK'yı incelemeye göre tasarlanmış bir masaüstü penceresinde çalıştırır: her yazmadan önce diff, her komut için onay, dosya bazında kabul ve ret, korumalı alan, harcama limitleri ve telefon kumandası.

Hangi sistemlerde çalışır?

Linux (Arch üzerinde geliştirildi; WebKitGTK 4.1 bulunan Debian/Ubuntu ve diğerlerinde çalışır). VOID Portal için Android 8 veya üstü gerekir.

Başkasının relay'ini kullanabilir miyim?

Kullanmayın: kendinizinkini kurun. Birkaç dakika sürer, ücretsizdir ve trafiğinizi ve erişilebilirliği kendi elinizde tutar.

Uygulamaları kendi dilimde kullanabilir miyim?

Evet. VOID Workshop ve VOID Portal bu siteyle aynı 13 dili konuşur. İkisi de ilk açılışta sorar; sonradan PC'de Ayarlar → Görünüm ve dil, telefonda Ayarlar → Dil altından değiştirebilirsin. Çeviriler src/i18n/locales ve remote/android/app/src/main/assets/i18n içinde; düzeltmelere açığız.

Kodunuz. Anahtarınız.
Kararınız.