İçeriğe geç
Pathrule

pathrule.iodocs

Pathrule

dokümanlar

DokümanlarBaşlayın

Windsurf

Pathrule CLI'ın Windsurf'ü harici ajan entegrasyonu olarak MCP ve yardımcı bir talimat dosyasıyla nasıl bağladığı.

Bu sayfada

Windsurf, Pathrule çalışma alanınıza Pathrule CLI veya VS Code eklentisi üzerinden bağlanır. Pathrule, yerel bir MCP sunucu kaydının yanı sıra Windsurf'ün oturum başında okuduğu yardımcı bir kural dosyası yazar. Windsurf'te hook yoktur; bu yüzden Claude Code, Codex, Cursor ve GitHub Copilot'tan farklı olarak hook'lar üzerinden bağlam almaz: protokolü ve çalışma alanı özetini kural dosyası taşır, daha derindeki her şeyi MCP araçları iletir. Windsurf yerel MCP sunucusunu kullanır; Windsurf için Remote MCP kurulumu belgelenmemiştir.

Bu sayfada Pathrule'un Windsurf için projenize neler yazdığını, Windsurf'e neden diğer tüm araçlarla aynı içeriğin ulaştığını ve entegrasyonu kendiniz nasıl doğrulayabileceğinizi bulacaksınız.

Pathrule'un yazdıkları

Pathrule'u Windsurf'e kurduğunuzda şunlar oluşur:

  • Bir MCP sunucu kaydı, ~/.codeium/windsurf/mcp_config.json dosyasında. Asistanı yerel Pathrule MCP sunucusuna yönlendirir, böylece asistan pathrule_* araçlarını çağırabilir; diğer sunucularınıza dokunmaz.
  • Yardımcı bir talimat dosyası, .windsurf/rules/pathrule-protocol.md, ve eski Windsurf sürümleri için .windsurfrules. Bu dosya, çalışma alanı özetini ve Pathrule protokolünü taşır; diğer istemcilerin kendi yerel biçimlerinde aldığı içeriğin aynısıdır.
  • Yol bilgisi dosyaları. Bilgi eklenmiş her dizin için, başında geçerli olduğu dizini belirten bir .windsurf/rules/pathrule-k-*.md kuralı.
  • Dosya olarak oluşturulmuş beceriler, .windsurf/skills/<name>/SKILL.md içinde; böylece Windsurf bunları adıyla çağırabilir.

Windsurf'te Pathrule hook'u olmadığından, protokol ve bilgi oturum başında Windsurf'e bu dosyalar aracılığıyla ulaşır. Hook destekleyen istemcilerde Pathrule aynı protokolü artık oturum başlangıcı hook'u üzerinden iletir ve talimat dosyasında yalnızca kısa bir not bırakır; Windsurf'te ise dosyanın tamamı korunur, çünkü onu taşıyacak başka bir şey yoktur.

Yardımcı dosya her istemci için elle kopyalanmaz. Pathrule onu, Claude Code, Cursor ve Codex talimatlarını da üreten ortak bir oluşturucudan üretir; böylece dördü zamanla birbirinden ayrışmaz.

İçeriğin Windsurf'e ulaşması

MCP konuşan her araç Pathrule'u stdio üzerinden kullanabilir: Pathrule MCP komutunu istemci yapılandırmasına eklersiniz ve asistan aynı araç yüzeyini görür. Windsurf için bu yapılandırmayı Pathrule CLI yazar ve yanında yardımcı dosyayı oluşturur. Yardımcı dosya oturum başında çalışma alanı özetini ve protokolü iletir; daha derindeki her şeyi MCP araçları ihtiyaç anında getirir.

İstemciler arasında farklılaşma olmadan bunun çalışmasını iki şey sağlar.

  • Tek araç sözleşmesi. MCP araçları (pathrule_get_context, pathrule_read_memory, pathrule_write_memory ve diğerleri), Claude Code ve Cursor'ın çağırdığı kümenin aynısıdır. Asistan bağlamı getirir; hafıza kayıtlarını, kuralları ve becerileri birebir aynı yüzey üzerinden yazar; değişen tek şey istemci yapılandırmasıdır.
  • Tek doğruluk kaynağı. Yardımcı dosya ve dosya olarak oluşturulmuş beceriler, asıl kopya değil, oluşturulmuş görünümlerdir. CLI, VS Code eklentisi veya MCP üzerinden yazılan bir hafıza kaydı, Windsurf'e diğer tüm istemcilere ulaştığı biçimde ulaşır.

Pathrule depo kaynak kodunuzu otomatik olarak yüklemez. Yerel proje öğrenimi araçları, bir bulguyu doğrulamak için o bulguya bağlı dosyaları inceleyebilir. Saklananlar şunlardır: ekibinizin bilgisi (hafıza kayıtları, kurallar, beceriler), ajanların kaydettiği etkinlikler, ajanların dayandıkları dosyalarla birlikte kaydettiği bulgular ve Cloud çalışma alanında, hangi dosyaların birlikte değiştiğini öğrenmek için Pathrule'un yakın tarihli git geçmişinden okuduğu dosya yolu çiftleri. Cloud modunda neyin gönderildiğini ve saklandığını görmek için Pathrule'un neleri hesapladığı sayfasına bakın.

Tek içerik katmanı, birçok iletim biçimi

Her istemcinin okuduğu talimat biçimi farklıdır; bu yüzden Pathrule her araç için tek tek elle kopyalamak yerine tüm yardımcı dosyaları aynı ortak oluşturucudan üretir. Böylece Windsurf protokolü, dosya biçimi farklı olsa da içerik olarak Claude Code, Cursor ve Codex sürümleriyle aynı kalır.

Yatırım istemcide değil, içerik katmanındadır. Aynı hafıza kayıtları, kurallar ve beceriler hiçbir şeyi yeniden yazmadan Windsurf'e ve diğer tüm istemcilere hizmet eder.

VS Code eklentisi üzerinden

Windsurf bir VS Code fork'udur. Pathrule VS Code eklentisini Windsurf içinde çalıştırırsanız, eklenti ortamı algılar ve aynı yönetilen MCP kaydını CLI'ın kullandığı kurucu üzerinden, JSON'u elle düzenlemeye gerek kalmadan yazar. Bu kayıt, eklentiyle birlikte gelen Pathrule çalışma zamanını gösterir ve hiçbir zaman gizli bilgi içermez.

Bu ayrı bir entegrasyon değil, aynı çalışma alanına açılan bir giriş noktası daha. Eklentinin neler yaptığı için VS Code için Pathrule, yerel stdio ile Remote MCP arasındaki farklar için Yerel ve Remote MCP sayfasına bakın.

İstemci bazında yalıtım

Windsurf aynı makinede Claude Code, Cursor ve Codex ile bir arada çalışır. Bir istemciyi, birkaçını ya da hepsini kurabilirsiniz.

  • Hepsi aynı Pathrule çalışma alanını, aynı MCP sunucusunu ve aynı içerik ağacını paylaşır.
  • Her istemcinin okuduğu yapılandırmalar birbirinden bağımsızdır. Windsurf'ü kurmak diğerlerine dokunmaz.
  • Bir istemciyi kaldırmak diğerlerini ve içeriği olduğu gibi bırakır.

Hangilerinin kurulacağı, Pathrule kurulumu hangi yapay zekâ araçlarını kullandığınızı sorduğunda pathrule setup içinde veya VS Code eklentisinde yaptığınız seçime bağlıdır.

Kurulum

Pathrule CLI ile:

pathrule setup

Komutu proje klasöründe çalıştırın ve hangi yapay zekâ araçlarını kullandığınız sorulduğunda Windsurf'ü seçin. Kurulum gerektiğinde Pathrule Cloud'a giriş yapmanızı sağlar, klasörü bir çalışma alanına bağlar, MCP kaydını kurar, bu klasör için seçiminizi hatırlar ve Windsurf dosyalarını yazar. Pathrule'u hesap olmadan kullanmak için bunun yerine pathrule setup --local komutunu çalıştırın.

Zaten bağlı olan bir klasörde parçaları elle bağlamak için:

pathrule install windsurf
pathrule sync
pathrule doctor

pathrule install windsurf, MCP kaydını ~/.codeium/windsurf/mcp_config.json dosyasına ekler. pathrule sync, proje dosyalarını bu klasör için seçilen yapay zekâ araçlarına göre, seçim yapılmamışsa klasörde algıladığı araçlara göre oluşturur.

Yukarıda anlatıldığı gibi, Windsurf içinde çalışan VS Code eklentisini de kullanabilirsiniz.

Doğrulama

Windsurf'ü bir çalışma alanına bağladığınız bir dizinde açın. Asistan oturum başında yardımcı dosyayı okumalı ve çalışma dizininiz için pathrule_get_context aracını çağırabilmelidir.

İçerik bulunan bir yola dokunan bir prompt çalıştırın. Asistan bu içeriği MCP araçları üzerinden getirmelidir. Getiremiyorsa:

pathrule doctor

Doctor yalnızca okuma yapar. Giriş durumunuzu, çalışma alanınızı ve bu klasörün bağlı olup olmadığını, Pathrule MCP kaydının Windsurf ve diğer her istemci için kurulu olup olmadığını, klasörde hangi Pathrule tarafından yönetilen dosyaların bulunduğunu ve bunları kimin yazdığını raporlar. Tam rapor için --json ekleyin; bu rapor artık var olmayan bir çalışma zamanını gösteren MCP kayıtlarını da işaretler. pathrule repair eskimiş bir kaydı yeniden yazar, yardımcı dosyaları yeniden oluşturur ve doctor'ı tekrar çalıştırır.

Değişmeyenler

İçerik katmanı tüm istemcilerde aynıdır.

  • Claude Code'a hook üzerinden gelen hafıza kaydının aynısı Windsurf'e MCP araçları üzerinden gelir.
  • Bir kural Windsurf'e yardımcı dosya ve MCP üzerinden ulaşır. Windsurf'te hook olmadığından orada bir kural bir düzenlemeyi engelleyemez; yazma öncesi engelleme yalnızca araç hook'ları olan istemcilerde mevcuttur: Claude Code, Codex, Cursor ve GitHub Copilot.
  • Bir beceri adıyla çağrılabilir.
  • MCP araçları aynı şekilde davranır.

Ekibiniz içeriği bir asistan için yazarsa, tüm asistanlar onu alır.

Sırada ne okumalı