İçeriğe geç
Pathrule

dokümanlar

VS Code için Pathrule

VS Code ve türevleri için Pathrule editör yüzeyi; bilgi ağacı, Markdown sekmelerinde düzenleme, hesap gerektirmeyen yerel mod ve tek komutla ajan kurulumu sunar.

Bu sayfada

VS Code için Pathrule, editöre özgü bir yüzeydir. Çalışma alanının bilgi ağacını, içerik düzenlemeyi ve yapay zekâ istemcisi kurulumunu editörün içine taşır; böylece açık olan klasör çalışma alanı, düzenlediğiniz dosya da yol olur. VS Code, Cursor veya Windsurf'te çalışıyor ve bilginizin kodunuzun yanında durmasını istiyorsanız doğru yüzey budur.

Odaklı bir editör yüzeyidir. CLI ile kullanılan içerik ve hook'lar, zaten kullandığınız editörden yönetilir; harici istemci kurulumu da CLI'ın kurulum aracını kullanır.

Kurulum

Eklentiyi Visual Studio Marketplace üzerinden ya da Cursor ve Windsurf'ün de kurabilmesi için Open VSX üzerinden kurun. Terminalden:

code --install-extension Pathrule.pathrule-vscode

Ya da editörde Quick Open istemini açıp şunu çalıştırın:

ext install Pathrule.pathrule-vscode

Apache-2.0 lisansıyla ücretsiz ve açık kaynaktır. Yerel mod hesap gerektirmediği için kurulum biter bitmez kullanmaya başlayabilirsiniz.

Eklentinin üstlendikleri

  • Bilgi ağacı. Yalnızca bilgi taşıyan yolları depo yapısına uygun şekilde gösteren, her yolun altında hafıza kayıtlarını, kuralları ve becerileri gruplayan bir kenar çubuğu. İçerik sayıları hem ağaç satırlarında hem de yerleşik gezginde ilgili dosya ve klasörlerde rozet olarak görünür.
  • Etkin dosya senkronizasyonu. Dosyalar arasında geçtikçe ağaç, editörü takip ederek geçerli dosyayı kapsayan en derin yola gider; durum çubuğu da bu yolu içerik sayılarıyla birlikte gösterir.
  • İçerik düzenleme. Hafıza kayıtları, kurallar ve beceriler sıradan Markdown editör sekmeleri olarak açılır. Kaydettiğinizde değişiklik Pathrule üzerinden kalıcı hale gelir; editörün tüm araçları da ek bir çaba gerektirmeden elinizin altındadır.
  • Ajan kurulumu. Tek bir komut yapay zekâ istemcilerinizi bağlar ve yola bağlı hook'ları kurar; CLI'ın yaptığı kurulumun aynısıdır.
  • İlk kurulum. Henüz çalışma alanı olmayan bir klasör açtığınızda eklenti, editörden çıkmanıza gerek kalmadan sizi kurulumdan bağlı bir çalışma alanına kadar yönlendirir.
  • Doctor. Her istemcinin bağlı olduğunu, hook'ların yerinde olduğunu ve bağlam sunucusuna erişilebildiğini denetleyen tek bir komut.

Yerel mod ve Cloud modu

Eklenti, tek bir kullanıcı arayüzünün arkasında iki modda çalışır; bu ayrım CLI ve açık kaynak çekirdek ile aynıdır.

  • Yerel mod hesap gerektirmez. Bir klasörü yerel olarak başlattığınızda hafıza kayıtlarınız, kurallarınız ve becerileriniz kendi makinenizde durur. Başlamanın en hızlı yolu budur.
  • Cloud modu giriş yapmanızı sağlar ve ekip katmanını ekler: paylaşılan bilgi, ekip etkinliği ve yönetilen arka uç.

Mod bir tahmin değil, açık klasörün bir özelliğidir. Giriş yapmış ancak klasörü henüz Cloud çalışma alanı olmayan bir kullanıcıya iki seçenek sunulur: geçerli organizasyonda bir Cloud çalışma alanı oluşturmak ya da klasörü yerel olarak başlatmak. Klasör yerel moddayken yalnızca Cloud'da çalışan işlemler bozuk görünmez, gizlenir; böylece aynı eklenti iki modda da çalışır.

Markdown sekmelerinde düzenleme

Ağaçtan bir hafıza kaydını, kuralı veya beceriyi açtığınızda normal bir Markdown sekmesi olarak açılır. Herhangi bir dosya gibi düzenleyin ve değişikliği kalıcı hale getirmek için kaydedin. Siz öğeyi açık tutarken bir ekip arkadaşınız aynı öğeyi değiştirdiyse kaydetme işlemi onun çalışmasının üzerine sessizce yazmaz: size yeniden yükleme, kendi sürümünüzün bir kopyasını saklama ya da kendi sürümünüzle üzerine yazma seçenekleri sunulur. Çakışmalar kaybolan düzenlemeler olarak değil, her zaman verilmesi gereken bir karar olarak karşınıza çıkar.

Gezginde herhangi bir dosya veya klasöre sağ tıkladığınızda bir Pathrule alt menüsü açılır: orada geçerli olan bilgiye göz atabilir ya da o yola bağlı yeni bir hafıza kaydı, kural veya beceri oluşturabilirsiniz. Ağaçtaki bir öğeyi prompt işaretçisi olarak kopyalayabilir, ayrıntılarını görüntüleyebilir, yeniden adlandırabilir, başka bir yola taşıyabilir ya da geri alma imkânıyla silebilirsiniz. Çoklu seçimle toplu taşıma ve silme yapılabilir; bulanık arama ise çalışma alanındaki tüm başlıkları kapsar.

CLI ile ortak kimlik

Eklentiden giriş yaptığınızda CLI ile aynı barındırılan giriş akışı kullanılır; GitHub, Google veya e-posta arasından seçim yapabilirsiniz. Oturum ortaktır: burada giriş yaptığınızda CLI'da da giriş yapmış olursunuz, birinde organizasyon değiştirdiğinizde diğerinde de değişir. Eklenti, CLI ve yapay zekâ asistanınız için tek bir kimlik.

Yapay zekâ istemcilerinizi bağlayın

Tek bir Connect AI clients komutu, hiç JSON düzenlemeden asistanınızı Pathrule'a bağlar.

  • GitHub Copilot ajan modu için eklenti, Pathrule'un MCP sunucusunu bağlı klasör adına kaydeder.
  • Claude Code, Codex, Cursor ve Windsurf için yönetilen MCP girdileri, CLI'ın kullandığı kurulum aracıyla yazılır.
  • Hook'lar CLI'ın kullandığı işlem hattıyla kurulur; sonuç bildirimi tam olarak neyin yazıldığını listeler.

Bundan sonra asistanınız, geçerli yol için Pathrule bağlamını desteklediği kanal üzerinden alır: Claude Code ve Codex için prompt hook'u da içeren hook'lar, Cursor ve GitHub Copilot için oturum ve araç hook'ları, hook desteği olmayan Windsurf için ise bir kurallar dosyası ile MCP. Her istemcinin bağlı olduğunu ve hook'ların güncel olduğunu doğrulamak için doctor komutunu istediğiniz zaman çalıştırabilirsiniz.

Ekibinizle çalışma

Cloud'daki yazma işlemleri paylaşılır, ancak mevcut Cloud arka ucu gerçek zamanlı abonelik sunmaz. En güncel durumu görmek için bilgi görünümünü yenileyin ya da bağlamı yeniden isteyin; yerel hook'lar ve talimat dosyaları, yenilenene kadar önceden hazırlanmış bilgiyi kullanır. Organizasyon düzeyindeki işler Pathrule Web tarafında kalır: ekip yönetimi, planlar ve faturalandırma ile çalışma alanları arası genel bakış, editörde yeniden yazılmak yerine bağlantılar üzerinden açılır.

Yerel modda başladıysanız ve bir klasörü ekibinize taşımak istiyorsanız, tek bir işlem giriş yapmanızı, bir organizasyon seçmenizi ve çalışma alanını içeriğiyle birlikte Cloud'a kopyalamanızı sağlar; yerel kopyanız da yedek olarak korunur.

VS Code için Pathrule ne zaman kullanılmalı

Ağırlıklı olarak VS Code, Cursor veya Windsurf'te çalışıyorsanız ve çalışma alanının bilgi ağacını, içerik düzenlemeyi ve ajan kurulumunu açık klasörünüzü ve etkin dosyanızı zaten bilen editörde istiyorsanız eklentiyi kullanın. Yerel modda saniyeler içinde başlayın, ekip katmanına ihtiyaç duyduğunuzda giriş yapın.

Terminalde çalışıyorsanız ya da Pathrule'u CI süreçlerinize betiklerle dahil ediyorsanız Pathrule CLI tercih edin. İkisi aynı girişi paylaştığı için birlikte kullanabilirsiniz.