Kurulum

Pathrule CLI, Pathrule'un terminal öncelikli arayüzüdür. npm'de Apache-2.0 lisansıyla @pathrule/cli adıyla yayımlanır ve kabuktan yönettiğiniz ajanlar için yerel MCP sunucusunu, hook yöneticisini ve yerel önbelleği çalıştırır. Bu sayfa kurulumu, giriş yapmayı, bir depoyu ve yapay zekâ istemcilerinizi bağlamayı, hesap olmadan kullanmayı ve CLI'ı bir projeden yeniden çıkarmayı anlatır. Tüm komutlar komut referansında listelenir.

Gereksinimler

• macOS, Linux veya Windows.
• Node.js 20.11.1 ya da daha yeni bir sürüm. CLI her çalıştığında sürümü denetler ve daha eski bir sürümde açık bir mesajla durur.
• Güncel bir kabuk: zsh, bash ya da fish, Windows'ta ise PowerShell.
• MCP destekleyen bir yapay zekâ kodlama asistanı. Pathrule CLI; Claude Code, Codex, Cursor, Windsurf ve GitHub Copilot'ı bağlar. Kurulum için zorunlu değildir, ama hook akışını doğrulamak için bir tane olmasını isteyeceksiniz.

Kurulum

npm (macOS, Linux, Windows)

Üç işletim sisteminde de kurulum yolu npm üzerindendir. Node.js 20.11.1 ya da daha yeni bir sürüm gerekir.

npm install -g @pathrule/cli

Windows'ta bu komutu PowerShell'den çalıştırın. Pathrule, Windows uyumlu bir hook komutunu otomatik olarak kaydeder; böylece aynı pathrule komutları orada da bir Unix kabuğundakiyle tamamen aynı şekilde çalışır.

Güncellemek için aynı kurulumu @latest ekleyerek çalıştırın:

npm install -g @pathrule/cli@latest

Etkileşimli bir çalıştırma, günde bir kez yeni bir sürüm olup olmadığını denetler ve bu komutu içeren tek satırlık bir bildirim yazdırır. Bildirimde yalnızca sizinkinden yeni bir sürüm adı geçer. pathrule update aynı denetimi istediğiniz anda yapar, pathrule config set update.policy manual ise günlük denetimi kapatır.

Doğrudan indirme

Bağımsız bir yükleyici ya da paket yöneticisi formülü yoktur. Pathrule CLI'ı her işletim sisteminde npm üzerinden kurun.

Doğrulama

pathrule --version

CLI sürümünü yazdırır ve sıfır çıkış koduyla sonlanır. Komut bulunamazsa npm'in global kurulum konumunun PATH üzerinde olduğundan emin olun ve kabuğu yeniden açın.

Giriş yapma

Cloud kullanımı bir hesap gerektirir. Yerel kurulum giriş adımını atlar; bkz. Hesap olmadan kullanma. pathrule login varsayılan olarak tek kullanımlık bir kodla giriş yapar. Aynı komut kendi bilgisayarınızda, SSH üzerinden ve ekransız bir makinede ya da CI runner'ında çalışır.

Cihaz kodu akışı

pathrule login

CLI tek kullanımlık bir kod yazdırır. Tarayıcısı olan bir makinede onay sayfasını kod önceden doldurulmuş olarak açar: orada Pathrule hesabınıza giriş yapın ve onaylayın. Ekransız bir makinede ya da SSH üzerinden, yazdırılan URL'yi herhangi bir cihazda açın, kodu girin ve onaylayın. Terminal girişi kendiliğinden tamamlar ve parolanız hiçbir zaman terminalden geçmez.

CLI'ın hiç tarayıcı açmamasını istiyorsanız --no-open seçeneğini verin. Bu durumda URL'yi yazdırır. Eski rehberlerde geçen pathrule login --device-code hâlâ kabul edilir ve aynı akışı çalıştırır.

Tarayıcı PKCE akışı

pathrule login --browser-callback

Bu komut aynı makinedeki bir tarayıcıda GitHub ile giriş yapar ve oturumu, PKCE ile korunan, kendi makinenizdeki bir callback üzerinden terminale geri getirir. Hesabınız iki adımlı doğrulama kullanıyorsa CLI kodu sorar. Bu akış etkileşimli bir terminal ve bir tarayıcı gerektirir. Callback kullanılamadığında CLI bunu bildirir ve cihaz kodu akışıyla devam eder; --no-open ile ya da bir betik içinde ise en baştan cihaz kodu akışını kullanır.

pathrule whoami hangi hesapla giriş yaptığınızı gösterir. pathrule logout CLI'dan çıkış yapar, pathrule logout --all ise bu makinedeki VS Code eklentisi gibi diğer Pathrule arayüzlerinden de çıkış yapar.

Çalışma alanı bağlama

Çalışma alanı, Pathrule'un içeriği kapsamlandırdığı birimdir. CLI her zaman içinde çalıştırıldığı klasörü bağlar, bu yüzden önce depoya geçin. Yol alan bir seçenek yoktur.

Rehberli yol her şeyi tek seferde yapar:

cd ~/repos/my-team
pathrule setup

pathrule setup işe Pathrule Cloud ile Local arasında seçim yaptırarak başlar. Cloud; hesapları, organizasyonları ve paylaşılan zekâsıyla önerilen, yönetilen başlangıç noktasıdır. Local bu makinede çalışır ve hesap gerektirmez. Kurulum, çalışma alanını ve seçtiğiniz yapay zekâ istemcilerini bağlar. Apple Silicon bir Mac'te isteğe bağlı cihaz üzerindeki modeli de önerir; bu adımı atlayabilirsiniz.

Cloud kurulumu var olan bir çalışma alanını bağlayabilir ya da bu klasör için yeni bir çalışma alanı oluşturabilir. Ardından yerel çalışma zamanı, desteklenen istemci yapılandırması ve hook'lar üzerinden içeriği iletir.

Adım adım yapmak için:

cd ~/repos/my-team
pathrule workspace list
pathrule workspace attach my-team

pathrule workspace attach, çalışma alanının tam adını ya da kimliğini alır. Argümansız çalıştırıldığında geçerli çalışma alanınızı bağlar. Bunun yerine yeni bir çalışma alanıyla başlamak için pathrule init klasörün adını taşıyan bir çalışma alanı oluşturur ve tek adımda bağlar; pathrule init my-team ya da pathrule workspace create my-team aynı işi verdiğiniz adla yapar. Çalışma alanları geçerli organizasyonunuzdan gelir: pathrule org list organizasyonlarınızı gösterir, pathrule org use <slug> ise organizasyon değiştirir.

Bağlamadan sonra bu klasörde ya da altındaki herhangi bir klasörde bir yapay zekâ istemcisi çalıştırdığınızda çalışma zamanı hangi çalışma alanının içeriğini sunacağını bilir.

Bir betik içinde pathrule setup yanıtlarını seçenek olarak alır ve işlem yapması için --yes gerekir:

pathrule setup --workspace my-team --target all --yes

Yapay zekâ istemcilerinizi bağlayın

pathrule setup hangi yapay zekâ istemcilerini kullandığınızı sorar, onları kurar ve bu seçimi bu çalışma alanı için hatırlar. Bir istemciyi elle bağlamak için:

pathrule install cursor
pathrule sync

pathrule install; claude, cursor, codex, windsurf ya da copilot değerlerinden birini alır, istemci belirtilmezse beşini de kurar. Pathrule'un MCP sunucu kaydını o istemcinin kendi kullanıcı düzeyindeki yapılandırmasına yazar ve oradaki diğer sunuculara dokunmaz. GitHub Copilot için biri Copilot CLI, biri VS Code için olmak üzere iki kayıt yazılır. pathrule uninstall <client> kaydı yeniden kaldırır.

pathrule sync, istemcilerinizin okuduğu dosyaları depoya yazar ve yerel hook dizinini yeniler. Bu komutu çalışma alanının bağlı olduğu klasörde, bağlamadan sonra ve bu dosyaların çalışma alanıyla güncellenmesini istediğiniz her zaman çalıştırın. Komut, bu çalışma alanı için pathrule setup içinde seçilen yapay zekâ istemcileri için yazar. Hiçbiri seçilmemişse Pathrule dosyaları depoda zaten bulunan istemciler için, böyle bir istemci de yoksa Claude Code için yazar. pathrule sync --skills çalışma alanının becerilerini istemcilerinizin beceri klasörlerine kopyalar.

Pathrule'un deponuza yazdıkları

Pathrule her istemcinin zaten okuduğu yerlere yazar; bu nedenle istemcide yeni bir şey yapılandırmanız gerekmez.

Pathrule yazdıklarını işaretler: talimat dosyaları bir Pathrule başlığı taşır, sizin dosyalarınızdan birine eklediği her şey de işaretli bir bloğun içinde durur. CLAUDE.md ya da AGENTS.md gibi bir talimat dosyası zaten sizin içeriğinizi barındırıyorsa Pathrule yazmadan önce sizin sürümünüzü yedek olarak kaydeder ya da yalnızca kendi işaretli bloğunun içine yazar ve dosyanın geri kalanına dokunmaz. Depo kökündeki .pathrule klasörü, Pathrule'un yönettiği dosyaların kaydını bu yedeklerle birlikte tutar. pathrule sync --skills ile eşitlenen beceriler her istemcinin .claude/skills/ gibi beceri klasörüne gider; depoda bir .gitignore varsa Pathrule, siz silene kadar bu klasörleri git dışında tutan, yorum satırlarıyla açıklanmış bir bölüm ekler.

Depo dışında pathrule install, MCP kayıtlarını her istemcinin kullanıcı düzeyindeki yapılandırmasına yazar. CLI ise oturumunu, önbelleğini ve hook betiğini Pathrule ana dizininizde (varsayılan olarak ~/.pathrule) tutar.

Bir klasörde Pathrule'un neleri yönettiğini hiçbir şeyi değiştirmeden görmek için pathrule doctor komutunu çalıştırın; yönetilen her dosyayı, onu yazan arayüz ve sürümle birlikte listeler. İstemci sayfaları daha fazla ayrıntı verir: Claude Code, Codex, Cursor, Windsurf ve GitHub Copilot.

Hesap olmadan kullanma

Pathrule CLI, hesap ve bulut olmadan tamamen kendi makinenizde de çalışır. Projenin içinde:

cd ~/repos/my-project
pathrule setup --local

pathrule init --local geçerli klasör için yerel bir çalışma alanı oluşturur. pathrule setup --local aynısını yapar, ardından yerel MCP kaydını her yapay zekâ istemcisi için (ya da --target <client> ile tek bir istemci için) kurar, hook'ları kurar ve depo dosyalarını yazar; bunların hiçbiri giriş yapmayı gerektirmez. Ajanınız hafıza kayıtlarını, kuralları ve becerileri Pathrule'un MCP araçlarıyla yazar; siz de bunları terminalden --local ile okur ve ararsınız, örneğin pathrule memory list --local. Tüm yerel komutlar için Hesap olmadan çalışma sayfasına, yerel sürümün neleri kapsadığı için Açık kaynak çekirdek sayfasına bakın.

Yalnızca açık kaynakla kurulum

Pathrule CLI'ın kendisi Apache-2.0 lisanslı açık kaynaktır ve yerel mod onu hesap ya da bulut hizmeti olmadan çalıştırır. Kurulumun Apple Silicon bir Mac'te önerdiği cihaz üzerindeki model isteğe bağlıdır: kurulum sorduğunda reddedin ya da daha sonra pathrule intelligence remove ile kaldırın. Modele ihtiyaç duymayan her şey onsuz da çalışmaya devam eder. Açık kaynak çekirdek bugün nelerin açık kaynak, nelerin tescilli olduğunu listeler.

Bağlantıyı doğrulama

Kurulumu uçtan uca doğrulayan tek komut doctor'dır. Yalnızca okur, hiçbir şeyi değiştirmez.

pathrule doctor

Şunları denetler:

• Giriş yapmış olmanız, bir organizasyonun ve bir çalışma alanının seçili olması.
• Geçerli klasörün, çalışma alanının bağlı olduğu klasör olması.
• Her yapay zekâ istemcisinde Pathrule'un MCP kaydının kurulu olması.
• Pathrule'un bu klasörde yönettiği dosyalar ve her birini yazan arayüz ile sürüm. Başka bir arayüzün ya da daha yeni bir sürümün yazdığı dosyalar işaretlenir.

İlgilenilmesi gereken bir şey olduğunda doctor, pathrule login ya da pathrule attach <workspace> gibi bir sonraki komutu söyler. pathrule doctor --json, betikler için tam raporu döndürür; bu rapor Node.js sürümünü de kapsar ve başlatma komutu güncelliğini yitirmiş MCP kayıtlarını işaretler. Bir denetim başarısız olduğunda komut sıfırdan farklı bir kodla çıkar. Güncelliğini yitirmiş bir kayıt pathrule repair ile düzeltilir: bu komut istemci yapılandırmalarınızdaki Pathrule kayıtlarını yeniden yazar, diğer sunuculara dokunmaz ve depo dosyalarını da yeniden yazar.

Pathrule'u bir projeden kaldırma

Depoda önce salt okunur planla başlayın:

pathrule eject

Bu komut, önceki içeriğinizin geri getirilmesi de dahil olmak üzere Pathrule'a ait dosyaları ve yönetilen bölgeleri listeler. Planı gözden geçirin, ardından açıkça uygulayın:

pathrule eject --apply

Cloud'a bağlı bir klasör için pathrule detach, Cloud çalışma alanını silmeden yerel klasörün bağlantısını keser. VS Code eklentisi de kendi klasörünün bağını kaldırabilir.

Yerel entegrasyonların kendi kayıtlı kurulumları vardır. Birini kaldırmak için pathrule integrations remove <agent> komutunu kullanın. pathrule install ile kurulan, ayarlara dayalı MCP kayıtları pathrule uninstall <client> ile kaldırılabilir. Bu işlemler ilgisiz istemci ayarlarını ve sunucuları korur.

Sırada ne okumalı

• Tüm komutlar ve seçenekler için Komut referansı.
• İlk hafıza kaydınızı yazmak ve hook'un tetiklendiğini görmek için Hızlı başlangıç.
• Doctor'ın neyi doğruladığını açıklayan model için Hook'lar nasıl çalışır.
• Çalışma zamanı ayağa kalktıktan sonra asistanın çağırdığı araçlar için MCP'ye genel bakış.