Rehberli kurulum, SuperDevSpace'in bu boşluğu kapatma yolu. Agent siteyi uygulamanın kendi tarayıcısında açar, yapmasına izin verilen tıklamaları yapar ve sıradaki adım sizinse sayfayı bir işaret ve tek bir cümleyle tam o anda size devreder.

"Bırakın agent yapsın" neden yanlış cevap

Bu özelliğin kolay versiyonu agent'a tarayıcının tamamını verirdi: her alanı okusun, her kutuya yazsın, her düğmeye bassın. Hızlı olurdu ve kötü bir fikir olurdu. Bir kurulum akışı, bir agent'ın asla dokunmaması gereken şeylerle doludur:

• şifreniz ve telefonunuza gelen tek kullanımlık kod;
• kart numaraları, banka bilgileri ve kimlik belgeleri;
• kabul ettiğiniz koşullar ve onayladığınız ödeme.

Bu yüzden tasarım tersten başlıyor. Agent rutin işi yapar — gezinir, doğru sayfayı bulur, bir proje adı yazar, Oluştur'a basar — kişisel ya da bağlayıcı olan her şey sizde kalır.

Rehberli kurulum nasıl ilerler

Döngü her sitede aynı — kimsenin talimat yazmadığı siteler dahil.

İş bitince sonucu, ekrana bir sır basmadan kontrol edebilirsiniz:

$ grep -o '^PADDLE_[A-Z_]*=' .env
PADDLE_API_KEY=
PADDLE_CLIENT_TOKEN=
PADDLE_WEBHOOK_SECRET=
PADDLE_ENVIRONMENT=

Uygulamanın uyguladığı kurallar

Bunlar uygulamadaki kontroller ve agent bunları kapatamaz:

• İçeri sır yok, dışarı sır yok. Agent şifre, kart, CVC, IBAN, tek kullanımlık kod ya da kimlik alanına yazamaz. Sayfayı okuduğunda ya da anlık görüntü aldığında bu değerler gizlenir ve okuduğu her metinden temizlenir.
• Ekran görüntülerinin üstü örtülür. Hassas alanlar ve her cross-origin frame — bir kart widget'ı, bir "Google ile giriş yap" kutusu — agent bir görüntü görmeden önce kapatılır.
• Hassas sayfalarda betik yok. Böyle bir alan gösteren her sayfada sayfa içinde JavaScript çalıştırmak reddedilir.
• Onay ve ödeme sizindir. Bir koşullar kutucuğuna ya da "Öde" / "Siparişi ver" düğmesine tıklamak reddedilir.
• Her şey görünür. Agent'ın tarayıcı panelinde yaptıkları, olurken panelin şeridinde size gösterilir.
• Sırlar konuşmanın dışında kalır. Sır olarak okunan bir değer hassas diye işaretlenir ve agent'a onu sohbette, raporlarda, görev notlarında ya da bildirimlerde asla tekrarlamaması söylenir.

Bir entegrasyon listesi değil, her web sitesi

Rehberli kurulum bir döngüdür, bir betik kütüphanesi değil. Kimsenin ipucu yazmadığı bir sitede de çalışır, çünkü agent önündeki gerçek sayfayı okur. Birkaç servis için kısa ipucu dosyaları veriyoruz — örneğin Paddle'ın sandbox paneli ve RevenueCat — geliştirici ayarlarının genelde nerede olduğunu agent'a söyleyen dosyalar. Paneller menülerini sürekli değiştirir; bu yüzden ipuçları açıkça şunu söyler: sayfa ile ipucu çelişirse sayfaya güven.

Bu, kulağa geldiğinden daha önemli. Bir agent'ın yazdığı entegrasyon kodu bir özelliğin yalnızca yarısı; diğer yarısı başkasının sitesindeki hesap, anahtar ve webhook. Rehberli kurulumla iki yarı da aynı oturumda, aynı agent'la olur; siz de zamanınızı yalnızca sizin yapabileceğiniz adımlara harcarsınız.

Nereye oturuyor

Rehberli kurulum, SuperDevSpace'teki her şeyle aynı çalışma alanının parçası: ödeme entegrasyonunuzu yazan agent, onun anahtarlarını oluştururken size eşlik eden agent'ın ta kendisidir — terminalinin yanındaki bir tarayıcı panelinde. Yeniyseniz, SuperDevSpace'i neden yaptığımızı anlatan yazı etrafındaki ekibin geri kalanını açıklıyor.

Deneyin

Deneme süresi 14 gün Premium, kart gerekmez. SuperDevSpace'i indirin, bir agent'tan projeniz için bir ödeme ya da analitik sağlayıcısı kurmasını isteyin ve sıra size geldiğinde sayfayı size devretmesine izin verin.

SuperDevSpace bir manager'ı ve birkaç worker'ı aynı repoda aynı anda çalıştırır. Bu yazı onları birbirinden ayıran mekanizmayı — git worktree'leri — ve uygulamanın bunlar etrafında uyduğu kuralları anlatıyor.

Git worktree nedir

Bir git reposunun normalde tek bir çalışma dizini vardır. git worktree aynı repoya birden çok çalışma dizini verir; her biri kendi dalında checkout edilmiştir ve hepsi aynı nesne veritabanını paylaşır. İkinci bir clone ya da geçmişin ikinci bir kopyası yoktur: yeni bir worktree yalnızca bir checkout'un dosyaları kadar yer kaplar.

Herhangi bir repoda elle deneyebilirsiniz. Komutlar her yerde aynı; değişen yalnızca kabuk:

git worktree add -b agent/frontend-demo ../myrepo-frontend
git worktree list
cd ../myrepo-frontend && git status
cd - && git worktree remove ../myrepo-frontend

git worktree add -b agent/frontend-demo ..\myrepo-frontend
git worktree list
cd ..\myrepo-frontend; git status
cd ..\myrepo; git worktree remove ..\myrepo-frontend

Her worktree'nin kendi HEAD'i, kendi index'i ve kendi dosyaları var. İki süreç iki worktree'de aynı anda düzenleme, build ve test yapabilir; birbirinin yarım kalmış değişikliklerini görmez. Bir agent ekibinin ihtiyaç duyduğu özellik tam olarak bu.

SuperDevSpace bunları nasıl kullanıyor

Kurallar basit ve her organizasyon için aynı:

• Manager ana checkout'unuzda çalışır. Planlar, inceler ve birleştirir; dalların bir araya geldiği tek yer orasıdır.
• Her worker kendi dalında kendi worktree'sini alır. Manager bir worker işe aldığında uygulama onun için git worktree add -b <dal> <yol> çalıştırır. Siz bir ad vermediyseniz dalın adı agent/<worker-adı>-<damga> olur.
• Worktree'ler uygulamanın kendi veri klasöründe, worktrees/<organizasyon>/<worker> altında durur; asla reponuzun içinde değil. Proje klasörünüz agent dizinleriyle dolmaz.
• Her tur commit'lenir. Bir worker bir turu bitirdiğinde uygulama worktree'sinde değişen her şeyi commit'ler (agent(<ad>): turn). Bir worker'ın yaptığı hiçbir şey yalnızca commit'lenmemiş bir çalışma dizininde kalmaz.
• Birleştirme bir squash merge'dür. Manager bir worker'ın raporunu kabul ettiğinde dal, git merge --squash ile tek bir commit olarak sizin hattınıza birleştirilir. Merge çakışırsa uygulama onu iptal eder ve sizi çakışmalı bir merge'ün ortasında bırakmak yerine repoyu bir sonraki işlem için temiz bırakır.
• Repo başına aynı anda tek bir git işlemi. Worktree dizinleri dosyaları ayırır; repo başına bir kuyruk git komutlarının kendisini sıraya koyar. Aynı anda biten iki worker git'in meta verisi üzerinde asla yarışmaz.

Panoda bu, aynı anda ilerleyen birkaç görev olarak görünür; her biri farklı bir worker'a ait, her birinin altında kendi dalı var.

İşi pratik yapan parçalar

Yeni bir worktree yalnızca git'in takip ettiği dosyaları içerir. Bu genellikle bir projeyi çalıştırmaya yetmez: node_modules, yerel bir .env, üretilmiş dosyalar. Bunu iki ayrıntı çözüyor.

Repo başına bir kurulum betiği

Reponuzda .super/scripts/setup-worktree.sh varsa, uygulama onu worker başlamadan önce her yeni worktree'nin içinde çalıştırır; SUPERDEV_MAIN_REPO ana checkout'unuzu gösterir. Çıktısı canlı akar, yani uzun bir kurulum kör bir bekleyiş değildir ve iptal edebilirsiniz.

#!/usr/bin/env bash
set -euo pipefail
# Yalnızca yerelde duran dosyaları ana checkout'tan kopyala
cp "$SUPERDEV_MAIN_REPO/.env" .env 2>/dev/null || true
# Bağımlılıkları kur (pnpm tek bir paylaşılan depodan bağlar, hızlıdır)
pnpm install --frozen-lockfile

Submodule'ler

git worktree add submodule'leri boş bırakır. Yeni worktree'de bir .gitmodules dosyası varsa uygulama içinde git submodule update --init --recursive çalıştırır; böylece bir worker sessizce eksik kalmış bir bağımlılığa karşı build almaz.

İş kaybetmeden temizlik

Worktree'ler birikir. Uygulama onları geri alır ama bunu temkinli yapar:

Commit'lenmemiş değişikliği olan ya da dalında henüz sizin hattınıza girmemiş iş bulunan bir worktree olduğu yerde kalır. Silinmiş bir klasör yeniden oluşturulabilir; kaybolan iş geri gelmez. Aynı temkin dallar için de geçerli: uygulama kendi oluşturduğu dalların kaydını tutar ve yalnızca onlara dokunur.

Sizin için ne değişiyor

Her worker kendi dalında olunca "dört agent'ı aynı anda çalıştır" bir kumar olmaktan çıkar. Şunları yapabilirsiniz:

• manager'a bağımsız görevlere bölünen bir direktif verip worker'ları paralel çalıştırmak;
• herhangi bir worker'ın diff'ini, onu üreten konuşmanın yanında tek başına okumak;
• bir worker'ın değişikliğini diğerlerini bozmadan reddetmek;
• ekip çalışırken ana checkout'unuzu kendiniz kullanmaya devam etmek.

Bu, insan ekiplerinin kullandığı disiplinin aynısı; birbirinin ayağına basmak üzere olduklarını size söyleyemeyen agent'lara uygulanmış hali. Bunun etrafında neden koca bir uygulama yaptığımızı merak ediyorsanız ilk yazımız o hikâyeyi anlatıyor.

Deneyin

14 günlük deneme Premium ve kart gerektirmez. SuperDevSpace'i indirin, yeni bir organizasyonu bir repoya yönlendirin ve manager ilk worker'larını işe alırken worktree'lerin belirişini izleyin.

SuperDevSpace'i bu boşluk yüzünden yaptık. Zaten sahip olduğunuz CLI'ı küçük bir takıma dönüştüren bir masaüstü uygulaması: işi planlayan bir manager ve işi yapan worker'lar — her biri kendi terminalinde, kendi git worktree'sinde.

Tek terminalde tek agent'ın sorunu

Tek bir kodlama agent'ıyla çalışmak tek bir iş için harika hissettirir. Aynı repoda üç işiniz olduğu anda dağılır:

• İkinci bir terminal açabilirsiniz ama iki agent artık aynı checkout'u düzenliyor. Biri test suite'i koştururken diğeri bir refactor'ın tam ortasında.
• Proje yöneticisi siz olursunuz. İşi siz bölersiniz, hangi terminalde hangi görev vardı siz hatırlarsınız, bağlamı bir oturumdan diğerine siz taşırsınız.
• Olanları kimse yazmaz. Öğle yemeğinden döndüğünüzde elinizdeki tek kayıt terminalin geçmişidir.

Bunların hiçbiri model sorunu değil. Bu bir organizasyon sorunu — ve organizasyon, yazılımın iyi olduğu bir iş.

SuperDevSpace aslında ne yapıyor

SuperDevSpace'te her repo bir organizasyondur. Her organizasyonun bir manager'ı vardır: gerçek bir terminalde çalışan, görebildiğiniz ve içine yazabildiğiniz gerçek bir agent CLI oturumu. Manager'a sade bir dille bir direktif verirsiniz — yazarak ya da sesle dikte ederek.

Manager sonra bir ekip liderinin yapacağını yapar:

İstediğiniz an araya girebilirsiniz. Her agent'ın bir sohbet görünümü ve gerçek terminali var — tek oturum, iki bakış açısı. Her değişiklik, onu üreten konuşmanın yanında bir diff olarak görünür; ana dalınıza girmeden önce siz incelersiniz.

Aboneliğiniz, makineniz, kodunuz

En önemli tasarım kararı aynı zamanda en basiti: SuperDevSpace zaten ödediğiniz bir CLI'ı çalıştırır. Model erişimini asla yeniden satmayız; çalıştırdığınız hiçbir şey SuperDevSpace aboneliğinin ötesinde bizden gelen bir faturada görünmez.

Bu kararın sevdiğimiz sonuçları var:

• Agent'lar makinenizde yerel süreçler olarak çalışır, yerel repolarınız üzerinde. Kaynak kodunuz, prompt'larınız, terminal çıktınız ve dosya yollarınız sunucularımıza asla gönderilmez. Hesap servisimiz yalnızca bir hesap, bir abonelik durumu ve bir cihaz listesi tutar.
• CLI'ı organizasyon başına siz seçersiniz. Claude Code, OpenAI Codex, Gemini CLI, Aider, Qwen Code, Cursor CLI ve OpenCode seçilebilir. Uygulamanın bugün akıcı konuştuğu CLI Claude Code — hook'lar, resume, MCP araçları, izin yanıtları. Diğer altısı başlar ve çalışır; uygulama onları deneysel olarak işaretler ve sessizce başarısız olmak yerine hangi eklerin henüz bağlanmadığını söyler.
• Hiçbir şey bizim bulutumuza kilitli değildir, çünkü işi yapan bir bulut yok.

İlk direktiften önce CLI'ın ve reponun beklediğiniz yerde olduğunu kontrol etmekte fayda var:

$ claude --version
$ cd ~/code/projeniz
$ git status

Ekibin etrafındaki parçalar

Bir ekibin terminalden fazlasına ihtiyacı var. Her planla gelenlerden birkaçı:

• Doğruyu söyleyen bir pano. Sprint'ler, görevler, brief'ler ve raporlar. Bir rapor neyin geçtiğini değil, neyin başarısız olduğunu da söyler.
• Inspector. Çalışan web sayfanızda bir öğeye tıklayın ve onu bileşen, dosya ve satır bilgisiyle bir agent'a gönderin. Vite, Next.js ve statik sitelerle çalışır.
• Telefonunuzdan onay. Bir agent'ın karara ihtiyacı olduğunda size sorar. Telefon uygulaması panoyu, agent'ları ve bekleyen onayları gösterir; bir izin isteğini masanızdan uzaktayken yanıtlayabilirsiniz.
• Organizasyon başına bir beyaz tahta (Excalidraw); agent'lar okuyabilir ve üzerine çizebilir.

Premium daha ileri giden parçaları ekler: Penpot üzerine kurulu, dosyaya çizen bir Designer agent'ı olan tasarım modu; direktifleri bir takvime göre çalıştıran zamanlamalar; ve Mac'inizdeki bir manager'ın Windows PC'nizdeki bir manager'a iş devretmesini sağlayan eş bağlantısı. Tam karşılaştırma fiyatlandırma sayfasında.

Söz vermediklerimiz

Bir agent ekibinin yine de bir patrona ihtiyacı var: neyin yapılacağına siz karar verirsiniz, ana dalınıza neyin gireceğini siz onaylarsınız.

Deneyin

Deneme süresi 14 gün Premium, kart gerekmez. CLI aboneliğiniz sizin kalır, kodunuz da. Ekibin kendi reponuzda çalıştığını görmek isterseniz SuperDevSpace'i indirin ve manager'a ilk direktifini verin.