Cursor Origin Eğitimi: CLI Kurulumu, GitHub Yansıtma ve Pull Request’ler

Cursor Origin Nedir?

Cursor Origin bir Git dökümhanesidir. Depoları barındırır, GitHub projelerini aynalar ve pull request’leri ile kod gezinmeyi destekler. Origin depoları ayrıca Cursor’ın bulut ajanları ve otomasyonlarıyla çalışır.

Cursor Origin ile GitHub arasındaki fark nedir?

Origin tüm GitHub özelliklerini kapsamaz. Genel depolar belgelenmemiştir ve aynalar GitHub Issues, GitHub Actions iş akışları ve Actions gizlilerini içermez. GitHub, bugün için genel depolar, Issues, Actions ve üçüncü taraf uygulamalar açısından daha geniş bir platform olmaya devam ediyor; bu nedenle Origin şu an daha dar kapsamlı bir hizmettir.

Temel fark, alışık olduğunuz Git iş akışının altında yatar: Cursor, ajanların ürettiği dal ve commit hacmi için ayrı bir depolama katmanı oluşturdu. Cursor bu odağı “ajan ölçeği” olarak adlandırıyor: Çok sayıda ajanın aynı depo üzerinde dal açtığı, commit yaptığı ve pull request oluşturduğu iş yükleri.

Cursor neden kendi Git barındırıcısını kurdu?

Depolama tasarımı, Cursor’ın mevcut bir host’a yeni bir arayüz eklemek yerine neden yeni bir Git barındırıcısı kurduğunu açıklar.

Cursor’ın Continuity üzerine mühendislik yazısı, mevcut Git host’larının bir depoyu birkaç sunucuda tutup çoğunluk onayından sonra push’u kalıcılaştırdığını anlatır. Cursor, binlerce kısa ömürlü depo veya tek bir depoya çok sık push yapılan sistemlerde bu modelin daha pahalıya mal olduğunu söylüyor.

Cursor Origin’in Continuity depolaması nasıl çalışır?

Continuity veya “Cnt”, Origin’in arkasındaki depolama sistemidir. Gerçek kayıt olarak S3 uyumlu nesne depolamada bir write-ahead log tutar. Yerel diskteki Git deposu, log’dan yeniden kurulabilen sıcak bir önbellektir.

Continuity, Git yazmalarını nesneler olarak depolar. Görsel: Yazar.

Gerçek kayıt nesne log’u olduğundan, Cursor yoğun depolar için okuma çoğaltmaları ekleyebilir ve talep azalınca kaldırabilir. Cursor’ın testlerinde, 100 çoğaltmaya kadar ekledikçe okuma bant genişliği arttı. Sistem standart S3 üzerinde saniyede 120 push’a kadar dayanabildi, ancak bu rakamlar bağımsız bir kıyaslamayla doğrulanmadı.

Kullanıcı açısından ana etki daha basittir: Yoğun bir depo okuma kapasitesi kazanabilir; kısa ömürlü bir depo ise her sunucuda kalıcı bir yerel kopyaya ihtiyaç duymaz.

Kimler Cursor Origin’e erişebilir?

Origin, Pro, Teams ve Enterprise planlarında mevcuttur; ücretsiz planlarda yoktur. Erişim kademeli sunulur; bu nedenle uygun bir plan, Codebase sekmesinin hemen görüneceğini garanti etmez. Pro’da bireysel bir ad alanınız olur ve kendi codebase adınızı siz alırsınız.

Kurumsal yöneticiler bunu kuruluşları için devre dışı bırakabilir. Cursor’ın genel bakışında, ilk codebase adını herhangi bir ekip üyesinin alabileceği, Codebase Ayarları sayfasında ise bir ekip yöneticisinin alması gerektiği yazıyor. Kurulumdan önce bu izni ekibinizde kontrol edin.

Cursor Origin CLI Nedir?

Origin, kimlik doğrulama, depolar, pull request’ler ve hesap yapılandırması için kendi komut satırı aracını sunar.

Cursor Origin CLI vs. Cursor Agent CLI

Origin’in CLI’sı, Cursor’ın Agent CLI’sından ayrı bir ikiliktir, origin olarak çalışır; Agent CLI ise agent olarak çalışır. 

İsimleri karıştırması kolay geldi çünkü origin aynı zamanda bir Git uzak deposu için geleneksel addır. Bu yazıda “origin’e push” Git uzak deposunu, “origin’i çalıştır” ise CLI’yı ifade eder.

Origin CLI hangi platformlarda destekleniyor?

Cursor, macOS, Linux ve WSL üzerinden Windows’u belgeliyor. Benim testim sırasında Windows, yerel bir yükleyici olmadığı için WSL anlamına geliyordu.

Windows’da ilerliyorsanız, CLI’yı kurmadan önce Ubuntu terminalini açın. Kabuk yükleyicisini PowerShell’de çalıştırmak aynı kurulum değildir.

Cursor Origin CLI komutları

Cursor Origin CLI şu anda dokuz komut grubuna sahiptir.

Çoğu depo komutu, hedefi origin adlı Git uzak deposundan okur. -R owner/repo seçeneği hedefi doğrudan belirler; bu, birden fazla depo üzerinde çalışan betikler için yararlıdır. ruleset komutları yalnızca mevcut push ve merge kurallarını gösterir; bunları değiştirmez.

Cursor Origin CLI Nasıl Kurulur ve Oturum Açılır

Cursor, CLI’yı bir paket yöneticisi yerine kabuk betiğiyle sağlar. Komut, Cursor’ın kurulum sayfasında bulunur.

Cursor Origin CLI nasıl kurulur

Kurulum tek satıra iner:

curl -fsSL https://downloads.cursor.com/origin/install.sh | sh

Yükleyici, origin ikili dosyasını ~/.local/bin/origin konumuna yerleştirdi. Ekibiniz komut dosyalarını çalıştırmadan önce inceliyorsa, betiği doğrudan sh’ye yönlendirmek yerine önce indirip gözden geçirin.

Origin CLI “command not found” hatası nasıl düzeltilir

Kurulumdan sonra kabuğunuz origin’i bulamıyorsa, dizinini PATH’e ekleyin:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

~/.zshrc yerine bash için ~/.bashrc kullanın. Bu, makine başına bir kez yapılacak bir düzeltmedir.

Kurulumu ve oturumu kontrol etme

Kurulumu doğrulamak için origin --version ve origin --help komutlarını çalıştırın, ardından Cursor’ın tarayıcıyla oturum açma akışını başlatmak için origin auth login kullanın.

WSL’de doğrulama çıktısı şu şekilde görünüyordu:

Origin CLI sürümü ve yardım çıktısı. Görsel: Yazar.

Ekransız bir ortamda CLI bunun yerine bir URL yazdırır. Oturum açma, Git’in kimlik bilgisi yardımcısını da yapılandırır; böylece Origin uzakları için ayrı bir Git belirteci gerekmez. Sonrasında oturumu kontrol etmek için origin auth status çalıştırın.

Tarayıcı olmadan bir Cursor API anahtarı kullanma

CI veya betikler için origin auth login --api-key <key> komutunu çalıştırın veya CURSOR_API_KEY değişkenini origin auth login öncesinde ayarlayın. Anahtarı commit’lenmiş dosyalardan uzak tutun. CURSOR_AUTH_TOKEN farklıdır ve bearer token bekler.

Cursor Origin Deposunu Oluşturma, Klonlama ve Push’lama

Oturum açtıktan sonra bir depoyu web sayfasından veya CLI’dan oluşturabilirsiniz. Push işlemleri standart Git komutlarını kullanır.

origin repo create ile depo oluşturma

cursor.com/codebase adresinden New seçeneğini belirleyin, bir ad girin ve görünürlüğü Internal veya Private olarak seçin. 

CLI’dan origin repo create my-project hesabınızın ad alanını kullanır. Ekip ad alanı için origin repo create acme/my-project gibi bir sahip ekleyin. İsteğe bağlı --default-branch bayrağı, sunucu varsayılanı olan main dalını değiştirir.

origin repo clone acme/my-project komutu, CLI tarafından kaydedilen oturumla depoyu HTTPS üzerinden klonlar.

İlk commit’inizi Origin’e push’lama

İlk push’tan sonra depo Codebase’de görünür:

Depo push’landı ve Codebase’de göründü. Video: Yazar.

Tamamen yeni ve boş bir depo için, klonlayın, bir dosya ekleyin ve push’layın:

git clone https://origin.cursor.com/{owner}/{repo}.git
cd {repo}
echo "# {repo}" > README.md
git add .
git commit -m "Initial commit"
git push -u origin main

Git, WSL altında /mnt yolunda bir .git/config.lock izin hatası bildirirse, bunun yerine ~ altında klonlayın. Testimde bu, hatayı düzeltti.

Push’tan sonra Codebase’i açın ve commit’in göründüğünü kontrol edin. Code sekmesi dosya ağacını ve commit geçmişini gösterir. T tuşuna basarak Go to file’ı açabilir veya arama alanıyla kodda arama yapabilirsiniz.

Mevcut bir Git deposunu Origin’e push’lamak

Halihazırda Git geçmişi olan bir projeniz varsa önce git remote -v çalıştırın. Aşağıdaki komut yalnızca depoda halihazırda origin adlı bir uzak yoksa geçerlidir:

git remote add origin https://origin.cursor.com/{owner}/{repo}.git
git push -u origin main

origin zaten GitHub’ı işaret ediyorsa, mevcut URL’yi değiştirmek yerine cursor gibi başka bir uzak adı kullanın. Origin CLI komutları bu addan depoyu çıkarsamayacağı için onları çalıştırırken -R owner/repo bayrağını geçin.

GitHub Deposunu Cursor Origin’de Nasıl Aynalarsınız

Bir ayna, mevcut bir GitHub projesini Origin’e kopyalar ve iki hizmeti birbirine bağlı tutar.

Cursor Origin GitHub yansıtma gereksinimleri

Origin erişimine, depoya sahip olan kuruluş veya hesaba bağlı Cursor GitHub uygulamasına ve o depoya GitHub yönetici erişimine ihtiyacınız var. Yalnızca yazma erişimi yeterli değildir.

Cursor Origin GitHub aynasını başlatma

cursor.com/codebase adresinden Sync from GitHub seçeneğini belirleyin, kuruluşu ve depoyu seçin ve onaylayın. CLI alternatifi, Cursor’ın origin repo create-mirrored owner/repo komutudur; detaylar Cursor’ın yansıtma dokümanlarında yer alır.

Cursor Origin, GitHub’dan neleri aynalar

Origin Git verisini, ancak her GitHub özelliğini değil aynalar:

GitHub Actions GitHub’da çalışmaya devam eder. Depot ve Buildkite entegrasyonları, aynalanmış kopyalar için değil Origin’de barındırılan depolar için geçerlidir.

GitHub’ın gerçeğin kaynağı olarak kaldığı durumlar

Bir depo aynalanmış durumdayken, Origin üzerinden yapılan push’lar GitHub’a aktarılır. Detach from GitHub (Ayarlar altında), GitHub deposunu değiştirmeden Origin kopyasını bağımsız hâle getirir.

Cursor Origin’de Pull Request Nasıl Açılır ve Gözden Geçirilir

Origin pull request’leri, diğer Git barındırıcılarında bulunan aynı dal açma, push ve inceleme dizisini kullanır. Pull request’lerin nasıl çalıştığına dair rehberimiz bu dizini açıklar.

Dal oluşturma ve bir değişikliği push’lama

Çalışma dalını oluşturup push’layın:

git checkout -b my-change
echo "Example change" >> README.md
git add README.md
git commit -m "Add example change"
git push -u origin my-change

Git üzerinize düşeni yaptı; sıradaki komut Origin’e aittir.

Origin CLI ile pull request açma

Depo komutları hedefi origin adlı Git uzak deposundan çıkarır. origin pr create çalıştırın ya da depoyu doğrudan belirtmek için -R owner/repo bayrağını geçin. Komut varsayılan olarak bir taslak oluşturur; incelemeye hazır bir PR için --status open geçin.

Cursor Origin pull request’ini gözden geçirme

CLI, origin pr list, origin pr view, origin pr diff ve origin pr checks komutlarını içerir. Herhangi bir CI uygulaması yapılandırılmadığında origin pr checks “No checks reported.” yazdırdı ve testimde 1 çıkış koduyla sonlandı.

Bu çıkış kodu, set -e kullanan kabuk betiklerinde önemlidir; çünkü boş bir Checks sekmesi, pull request’in kendisi sorunsuz olsa bile betiği durdurabilir.

Dört sekmeli pull request incelemesi. Görsel: Yazar.

Web görünümünde her pull request’te şu dört sekme bulunur: Activity, Commits, Checks ve Files Changed; ayrıca değerlendirici istekleri, satır içi yorumlar ve bir birleştirme düğmesi vardır. Web sayfası birleştirme çakışmalarını gösterir ve origin pr status --conflict-status bunları terminalden raporlar.

Terminal ayrıca origin pr merge komutunu da destekler. Origin’de barındırılan bir depoda oluşturulan pull request’ler Origin’de kalır; aynalanmış bir depodaki etkinlik ise GitHub’a geri gönderilir.

Cursor Origin Ekip Erişimi ve Depo İzinleri

Origin izinleri codebase ve depo seviyelerinde bulunur.

Codebase ayarları ve depo ayarları

Codebase ayarları ekip genelidir: Origin’i kim açabilir, depoları kim oluşturabilir ve uygulamaları kim kurabilir. Depo ayarları tek bir depoyla sınırlıdır ve General, Permissions, Rules and Protections ve Apps başlıklarını kapsar; ancak Cursor’ın dokümanları Permissions ve Rules ekranlarının yeniden tasarlandığı konusunda uyarıyor.

Bir ekip üyesi Origin’i kullanabiliyor ama belirli bir depoyu açamıyorsa, ekip genelindeki ayarlar yerine o deponun izinlerini kontrol edin.

Internal vs. Private depolar

Erişimi kısıtlı iki tür depo vardır:

• Internal depolar, codebase erişimi olan ekip üyeleri tarafından görülebilir. 
• Private depolar sadece doğrudan veya codebase izinleri aracılığıyla erişim verilmiş üyeler tarafından görülebilir. Bir depoyu private’a geçirmek, değişikliği yapan kişiyi yönetici olarak tutar.

Cursor Origin depo erişimi nasıl kontrol edilir

origin repo list komutu, mevcut hesap için görünür tüm depoları gösterir. Tek bir depoya kimin erişebildiğini incelemek için Settings ardından Permissions bölümünü açın.

Cursor Origin En İyi Uygulamalar

Origin ile çalışırken akılda tutulması çok önemli üç nokta:

• Bir depoyu silmeden veya yeniden yapılandırmadan önce tam owner/repo değerini doğrulayın ve uzakları inceleyin. 

• Hedef doğrulanana kadar -y kullanmaktan kaçının. 

• Cursor’ın izin sayfaları çelişkili olabiliyor; erişim değişikliklerini otomatikleştirmeden önce güncel dokümanları kontrol edin.

Cursor Origin vs. GitHub: Özellik Karşılaştırması

Origin, Cursor’ın ajan iş akışına bağlıdır; GitHub ise daha geniş bir depo ekosistemini kapsar.

Git barındırma, pull request’ler ve CI/CD

Her bölümü tekrarlamak yerine özet bir ayrım:

Ajan satırı bağlam gerektirir.

Ajan iş akışları için Cursor Origin vs. GitHub

Her iki platform da ajanların depolar üzerinde çalışmasına izin verir. Origin bu döngüyü Cursor içinde tutar; GitHub ise Agents paneli ve Copilot araçlarıyla, genel kullanıma sunulan CLI dâhil, sunar.

Ne zaman Cursor Origin’i, GitHub’ı veya her ikisini kullanmalı

• Origin’i kullanın depo internal veya private ise, ajan çalışmalarının çoğu zaten Cursor içinde gerçekleşiyorsa ve dağıtım veya CI kurulumunuz Vercel, Depot veya Buildkite üzerinden çalışabiliyorsa.
• GitHub’ı koruyun proje genel ise, Issues ve Actions günlük iş akışının parçasıysa veya ekip GitHub’ın uygulama pazarına bağımlıysa.
• Her ikisini kullanın kaynak depoyu taşımadan Origin’in kod gezinmesi ve ajan iş akışını istiyorsanız. Bir ayna, push ve pull request etkinliğini GitHub’a bağlı tutarken aynı kodu Origin’de de kullanılabilir kılar.

Son Düşünceler

Taze bir WSL kurulumundan, GitHub ile kullandığım aynı dal, commit ve push akışıyla Origin’de açık bir pull request’e ilerledim. CLI, Git’in çalışma şeklini değiştirmedi; farklılıklar barındırma, izinler ve yansıtma etrafında ortaya çıktı.

Kullandıktan sonra, Origin’i tam bir yedek değil, GitHub’ın tamamlayıcısı olarak görürdüm. Mevcut bir depo için en pratik giriş noktası yansıtma çünkü GitHub yetkili olmaya devam edebilir. Genel projeler ve Actions ağırlıklı iş akışlarının taşınması için hâlâ az gerekçe var.

İlgili okumalar için, Cursor Otomasyonları rehberimiz mevcut bir depo üzerinde çalışan ajan görevlerini kapsar. GitHub nedir ve nasıl kullanılır rehberimiz GitHub iş akışını daha ayrıntılı açıklar.