Pathrule CLI

Pathrule CLI, Pathrule'un kurulum ve terminal arayüzüdür. npm'de Apache-2.0 lisansıyla @pathrule/cli adıyla yayımlanır; macOS, Linux ve Windows'ta çalışır ve yerel MCP sunucusunu, yerel önbelleği ve hook yöneticisini kabuğunuzda barındırır. Claude Code, Codex, Cursor, Windsurf ve GitHub Copilot'ı bağlar; SSH, headless ve bağımsız terminal iş akışlarına uyum sağlar.

İçerik ve MCP sözleşmesi tüm istemcilerde ortaktır; iletim ise her istemcinin sunduğu kanala göre yapılır. Claude Code ve Codex, prompt hook'u da içeren hook'lar alır; böylece bağlam, ajan işe başlamadan önce gelir. Cursor ve GitHub Copilot oturum ve araç hook'ları alır, prompt hook'u almaz. Windsurf'te hook yoktur: oluşturulan bir kurallar dosyasını okur ve daha derin bağlama MCP üzerinden ulaşır.

Pathrule CLI'ın üstlendikleri

• Giriş. Varsayılan olarak tek kullanımlık bir cihaz kodu kullanılır; bu yöntem kendi bilgisayarınızda, SSH üzerinden ve herhangi bir headless makinede aynı şekilde çalışır. İsterseniz --browser-callback ile bu makinede tarayıcı geri çağrısı üzerinden GitHub ile giriş yapabilirsiniz.
• Çalışma alanına bağlama. Komutu çalıştırdığınız klasörü bir çalışma alanına bağlar; böylece çalışma ortamı, yapay zekâ oturumunuzun çalışma dizinini çözümleyebilir. pathrule setup bunu rehberli bir akışla yapar, pathrule init ise tek adımda bir çalışma alanı oluşturup bağlar.
• Yapay zekâ istemcisi kurulumu ve senkronizasyonu. Pathrule'un MCP kaydını Claude Code, Codex, Cursor, Windsurf ve GitHub Copilot'a yazar. pathrule sync, her istemcinin okuduğu talimat dosyalarını ve hook yapılandırmasını depoya yazar.
• Kaldırma. pathrule eject proje temizliğinin önizlemesini gösterir, pathrule eject --apply ise temizliği uygular. Yerel entegrasyonları pathrule integrations remove <agent> ile, ayarlara dayalı MCP kayıtlarını ise pathrule uninstall <client> ile kaldırın. Ayrıntılar için Pathrule'u bir projeden kaldırma sayfasına bakın.
• Hesap gerekmez. pathrule init --local ve pathrule setup --local, Pathrule'u giriş yapmadan ve Cloud'a bağlanmadan yerel bir depolamayla çalıştırır. Ayrıntılar için Hesap olmadan çalışma bölümüne bakın.
• Cihaz üzerindeki model. pathrule intelligence, Apple Silicon bir Mac'te isteğe bağlı cihaz üzerindeki modeli kurar, günceller ve kaldırır. Başka hiçbir şey bu modele bağlı değildir. Ayrıntılar için yerel model sayfasına bakın.
• MCP sunucusu. Yerelde çalışır ve asistanınızın konuştuğu arayüzdür.
• Hook yöneticisi. Hook destekleyen her istemcinin desteklediği hook'ları kaydeder ve ajanın çalıştığı klasöre ait yola bağlı bağlamı iletir.
• Çalışma tercihleriniz. pathrule me, User Intelligence içinde sizinle ilgili tutulan ve makinenizde saklanan bilgileri listeler, öğretir, açıklar, kapsamını yeniden belirler ve unutturur. pathrule me context ise bir ajanın belirli bir görev için alacağı bağlamı gösterir.
• Terminalde bilgi. pathrule search, list ve read hem Local hem Cloud modunda çalışır. CLI add komutu Cloud çalışma alanları içindir; yerelde içerik oluşturmak için Local Console, VS Code veya MCP kullanılır.
• Doctor. Girişinizi, çalışma alanını ve klasör bağlantısını, her yapay zekâ istemcisinin MCP kaydını ve Pathrule'un klasörde yönettiği dosyaları kontrol eden, yalnızca okuma yapan tek bir komuttur. pathrule repair güncel olmayan kayıtları düzeltir.
• Betik yazma. Neredeyse her komut, kararlı ve makine tarafından okunabilir çıktı için --json alır.

Tüm komutlar ve seçenekler komut referansında yer alır.

Önerilen akış

pathrule login
pathrule org use my-team
cd ~/repos/my-project
pathrule setup
pathrule doctor

pathrule setup, klasörü eşleşen bir çalışma alanına bağlar ya da yeni bir tane oluşturur, hangi yapay zekâ istemcilerinin bağlanacağını sorar, bunları kurar ve okudukları dosyaları yazar. Çalışma alanını kendiniz oluşturmak için klasörde pathrule init my-project komutunu, var olan bir çalışma alanı için ise pathrule workspace attach my-project komutunu çalıştırın. İki komut da geçerli klasör üzerinde işlem yapar ve hiçbiri yol seçeneği almaz.

Bundan sonra ~/repos/my-project içinde açılan Claude Code veya Codex, Pathrule bağlamını ilk prompt'ta alır. Cursor ve GitHub Copilot bağlamı oturum başlangıcında ve araç çağrıları sırasında alır; Windsurf ise bağlamı kurallar dosyasından ve MCP üzerinden okur.

Çıktı modları

CLI'ın --json ile aralarında geçiş yapabileceğiniz iki çıktı modu vardır.

• İnsan modu (varsayılan): ok, warn, error veya info olarak işaretlenmiş durum satırları gösterilir; uygun olduğunda çalıştırılacak sonraki komut da belirtilir. Sorular ve tarayıcı pencereleri yalnızca etkileşimli bir terminalde görünür.
• JSON modu: Betikler, CI çalıştırıcıları ve otomasyon için her komut başına tek bir JSON nesnesi döner. Bu nesne her zaman ok, command ve cwd alanlarını içerir; başarılı olduğunda data, başarısız olduğunda ise code ve message içeren bir error alanı eklenir. --json, --help çıktısında bunu belirten komutlarda kullanılabilir. snapshot ve eject bu modu desteklemez; bu mod hiçbir zaman soru sormaz ve tarayıcı açmaz.

pathrule workspace list           # human
pathrule workspace list --json    # machine readable

Bir komut, istediğiniz işlemi yapmadığında sıfırdan farklı bir çıkış koduyla sonlanır; böylece ilgili CI adımı başarısız olur.

Tarayıcıyı açan komutlar

Bazı akışlar yalnızca Cloud'da çalışır ve konsolu terminalde yeniden uygulamak yerine Pathrule Web'i varsayılan tarayıcınızda açar.

pathrule billing
pathrule upgrade
pathrule team open

Her biri açtığı URL'yi yazdırır. --no-open ile hiçbir şey açmadan yalnızca URL'yi yazdırır; böylece URL'yi uzak bir kabuktan kopyalayabilirsiniz. Tek başına pathrule team ise organizasyonun üyelerini ve bekleyen davetleri terminalde listeler.

Pathrule CLI ne zaman kullanılır

SSH üzerinden çalışıyorsanız, Pathrule'u bir CI çalıştırıcısına betikle eklemek istiyorsanız, Pathrule'u hesap açmadan denemek istiyorsanız ya da zamanınızın çoğunu terminalde geçiriyorsanız Pathrule CLI'ı kullanın. Bilgilere editörünüzün içinden göz atmak ve onları düzenlemek için aynı girişi ve hook'ları paylaşan VS Code için Pathrule'u da ekleyin.

Sırada ne okumalı

• Kurulum yolları, giriş akışları, Pathrule'un bir depoya neler yazdığı ve nasıl kaldırılacağı için Kurulum.
• Tüm komutlar ve seçenekler için Komut referansı.
• Aynı kimliği ve hook'ları paylaşan editör arayüzü için VS Code için Pathrule.
• Çalışma ortamının asistanınıza neler ilettiği için Hook'lar nasıl çalışır.