Cursor

Cursor, Pathrule çalışma alanınıza Pathrule CLI ya da VS Code eklentisi üzerinden bağlanır. Pathrule, yola bağlı çalışma alanı bilgisini iletmek için Cursor'ın yerleşik hook'larını ve yerel MCP sunucusunu kullanır. Cursor'da oturum ve araç hook'ları vardır, ancak prompt gönderimi için bir hook yoktur; bu yüzden bağlam her prompt ile değil, oturum başında ve araç çağrıları etrafında gelir. Cursor yerel MCP sunucusunu kullanır; Cursor için Remote MCP kurulumu dokümante edilmemiştir.

Bu sayfada Pathrule'un Cursor için projenize neler yazdığını, hook olaylarının istemciler arasında nasıl eşleştiğini ve entegrasyonu nasıl doğrulayacağınızı bulabilirsiniz.

Pathrule'un yazdıkları

Pathrule'u Cursor'a kurduğunuzda şunlar oluşur:

• .cursor/hooks.json. Cursor'ın yerleşik hook yapılandırması. Pathrule ilgilendiği olayları buraya kaydeder ve sizin eklediğiniz hook'lara dokunmaz.
• ~/.cursor/mcp.json içinde bir MCP sunucu girdisi. Kullanıcı düzeyindeki Cursor MCP yapılandırmanız, yerel Pathrule MCP sunucusunu gösterecek şekilde ayarlanır. Diğer sunucularınız olduğu gibi kalır.
• .cursor/rules/pathrule-protocol.mdc, eski Cursor sürümleri için de .cursorrules. Hook kuruluyken bu dosyalar yalnızca Pathrule'un etkin olduğunu ve bağlamın hook ile iletildiğini belirten kısa bir not içerir.
• Dosya olarak yazılmış beceriler, .cursor/skills/<name>/SKILL.md altında; böylece Cursor bunları adıyla çağırabilir.

Cursor hook'u kuruluyken protokol kural dosyası yerine sessionStart ile taşınır ve yol bilgisi hook'lar üzerinden gelir; bu nedenle dosya ağacınıza hiçbir bilgi dosyası yazılmaz. Hook yoksa kural dosyası protokolün ve çalışma alanı özetinin tamamını taşır, Pathrule da bilgi bağlı her dizin için glob ile kapsamlanmış bir .cursor/rules/pathrule-k-*.mdc kuralı ekler.

Üçüncü taraf bir Skills ayarını açmanız gerekmez. Cursor, CLI'ın yönettiği Pathrule hook sağlayıcısını doğrudan görür.

Hook olaylarının kapsamı

Cursor'ın olayları Pathrule'un bağlam ekleme noktalarına şöyle karşılık gelir:

• sessionStart. Yeni bir oturum başladığında. Pathrule çalışma alanı meta verisini, protokolü ve ekip bağlamınızı döndürür; bu, Claude Code'un kendi oturum başında aldığı başlangıç bağlamının aynısıdır.
• preToolUse. Cursor bir aracı çalıştırmadan önce. Onaylı bir engelleme kalıbı olan kural, eşleşen bir düzenlemeyi ya da yazmayı burada reddeder ve gerekçe olarak kuralı ve onaylı çözümü gösterir. Cursor'da bu olay yalnızca kararı taşır; yola bağlı bağlam bunun yerine sessionStart ve postToolUse üzerinden iletilir.
• postToolUse. Bir araç işini bitirdikten sonra. Pathrule bu olayı hem etkinliği kaydetmek için hem de Cursor'ın araç öncesi olayının taşıyamadığı yola bağlı bağlamı telafi etmek için kullanır.
• stop, subagentStop ve sessionEnd. Turu ve oturumu kapatır.

Cursor'ın prompt başına olayı bilinçli olarak kaydedilmez: bu olayın çıktısı bağlam taşıyamaz, aynı işi sessionStart ile postToolUse birlikte görür.

Cursor ile Claude Code arasındaki olay biçimi farklarını tek bir ortak hook betiği karşılar. Bunu düşünmenize gerek yok: Cursor'ı Pathrule üzerinden kurduğunuzda doğru biçim kendiliğinden yerleşir.

İstemci bazında yalıtım

Pathrule, tek bir makinede yapay zekâ istemcilerinin her türlü kombinasyonunu destekler.

• Yalnızca Cursor. Pathrule yalnızca Cursor yapılandırmalarını yazar.
• Yalnızca Claude Code. Pathrule yalnızca Claude Code yapılandırmalarını yazar.
• İkisi birden. Pathrule her ikisini de yazar. Hook'lar birbirinden bağımsız kaydedilir, MCP sunucusu ortaktır, içerik ağacı aynıdır.

Hangisinin geçerli olacağı, Pathrule kurulumu hangi yapay zekâ araçlarını kullandığınızı sorduğunda, pathrule setup içinde ya da 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 Cursor'ı seçin. Kurulum gerektiğinde sizi Pathrule Cloud'a giriş yaptırır, klasörü bir çalışma alanına bağlar, MCP girdisini kurar, bu klasör için seçiminizi hatırlar ve Cursor dosyalarını yazar. Pathrule'u hesap olmadan kullanmak için bunun yerine pathrule setup --local çalıştırın.

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

pathrule install cursor
pathrule sync
pathrule doctor

pathrule install cursor komutu Pathrule sunucusunu ~/.cursor/mcp.json dosyasına ekler ve diğer sunucularınıza dokunmaz. pathrule sync komutu, proje dosyalarını bu klasör için seçilen yapay zekâ araçlarına göre, seçim yapılmadıysa klasörde algıladığı araçlara göre yazar.

Cursor içinde de çalışan VS Code eklentisi üzerinden kurmak için Connect AI Clients bölümünde Cursor'ı seçin. Eklenti, aynı MCP girdisini ve hook yapılandırmasını içinde gelen CLI ile yazar.

Doğrulama

Cursor'ı bir çalışma alanına bağladığınız bir dizinde açın. Pathrule'un kayıtlı bir sağlayıcı olarak göründüğünü doğrulamak için Hooks Settings sekmesini açın. Yeni bir sohbet başlatın. Yola bağlı bağlam ilk araç çağrısından önce görünmelidir.

Entegrasyon hiçbir şey göstermiyorsa:

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 girdisinin Cursor ve diğer her istemci için kurulu olup olmadığını, klasörde hangi Pathrule yönetimli 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 ortamını gösteren MCP girdilerini de işaretler. pathrule repair eskimiş bir girdiyi yeniden yazar, .cursor/hooks.json dahil proje dosyalarını yeniden eşitler ve doctor'ı tekrar çalıştırır.

Değişmeyenler

Pathrule'a yazdığınız her şey Cursor'a, Claude Code'a ulaştığı biçimin aynısıyla ulaşır.

• CLI, VS Code eklentisi ya da MCP ile yazılan bir hafıza kaydı ikisinde de görünür.
• Onaylı bir engelleme kalıbı olan kural, eşleşen bir düzenlemeyi ikisinde de engeller.
• Bir beceri ikisinde de adıyla çağrılabilir.
• MCP araçları (pathrule_get_context, pathrule_write_memory vb.) ikisinde de aynı şekilde davranır.

Bir asistan için çıkardığınız özellik, diğerinde de çalışır.

Sırada ne okumalı

• Kardeş entegrasyon için Claude Code.
• Temeldeki model için Hook'lar nasıl çalışır.
• Asistanın çağırabileceği tüm araçlar için MCP araçları referansı.