PathruleKomut referansı
Girişten çalışma alanı kurulumuna, bilgiden tanılamaya ve hesapsız yerel kullanıma kadar her Pathrule CLI komutu, ne işe yaradığı ve önemli seçenekleri.
Bu sayfada
- Genel seçenekler
- Komutun tanımadığı seçenekler
- JSON çıktısı
- Çıkış kodları
- Başlayın
- Hesap ve bağlam
- Çalışma alanı kurulumu
- Bilgi
- Çalışma tercihleriniz ve yerel model
- Local Console ve ajan entegrasyonları
- Proje entegrasyonunu kaldırma
- Tanılama ve bakım
- Ekip ve faturalandırma
- Yardım ve sürüm
- Hesap olmadan çalışma
- Sırada ne okumalı
Pathrule CLI'daki tüm komutlar, pathrule help çıktısındaki gruplamayla burada. Her girdi komutun ne yaptığını ve hangi seçeneklerin önemli olduğunu anlatır. İlk kurulum için Kurulum sayfasından başlayın.
pathrule <command> [subcommand] [arguments] [options]
pathrule help
Genel seçenekler
| Seçenek | Ne yapar |
|---|---|
--json | İnsan okumasına yönelik çıktı yerine makinenin okuyabileceği tek bir JSON nesnesi yazdırır. Renkleri, soruları ve tarayıcı pencerelerini de kapatır. |
--yes | setup ve cache prune komutlarının herhangi bir değişiklik yapmadan önce istediği onayı verir. |
--no-open | Hiçbir zaman tarayıcı açmaz. Tarayıcı açacak bir komut bunun yerine URL'yi yazdırır. |
--no-color | Renksiz, düz çıktı verir. NO_COLOR ortam değişkenini 1 yapmak da aynı etkiyi yaratır. |
--local | init, setup, sync, search komutlarını ve memory, rule ile skill komutlarını hesap gerektirmeyen yerel bir depoya karşı çalıştırır. Bkz. Hesap olmadan çalışma. |
--help, -h | Komut listesini yazdırır. |
--version, -v | CLI sürümünü yazdırır. |
CI ortam değişkeni true olduğunda CLI soruları ve tarayıcı pencerelerini de atlar; böylece bir komut, runner üzerinde hiçbir zaman girdi beklemez.
Komutun tanımadığı seçenekler
CLI, tanımadığı bir seçeneği reddetmez. Çoğu komut onu düz bir argüman olarak okur ve bu da komutun hata vermesine ya da yanlış hedef üzerinde işlem yapmasına yol açar. pathrule workspace attach --path ~/repos/app adı --path olan bir çalışma alanı arar, pathrule install --client cursor ise --client bir istemci adı olmadığı için durur. setup, invite, team ile memory add, rule add ve skill add kendi seçeneklerini denetler ve tanımadıkları bir seçenekte hata vererek durur. Bu sayfadaki ya da pathrule help çıktısındaki seçenekleri kullanın.
JSON çıktısı
--json ile her yanıt; ok, command ve cwd alanlarını içeren tek bir JSON nesnesidir. Komut başarılı olduysa buna data, başarısız olduysa code ve message içeren bir error eklenir. Bazı yanıtlar, sırada çalıştırılacak komutları içeren next_steps alanını da ekler. --json, --help çıktısında bunu belirten komutlarda kullanılabilir. snapshot ve eject bunu desteklemez, bu yüzden bu komutları onsuz çalıştırın. Giriş akışının size bir kod göstermesi gerektiği için girişi düz pathrule login ile yapın.
Çıkış kodları
0, komutun istediğiniz işi yaptığı anlamına gelir. Eksik argüman ya da bilinmeyen istemci adı gibi kullanım hatalarının çoğu 64 ile çıkar. Diğer tüm hatalar 1 ile çıkar; pathrule doctor da bir denetim başarısız olduğunda 1 ile çıkar. 20.11.1'den eski bir Node.js sürümünde her komut, hiçbir şey yapmadan 78 ile durur.
Başlayın
| Komut | Ne yapar |
|---|---|
pathrule setup | Geçerli klasörü tek bir rehberli adımda bağlar. Gerekirse giriş yaptırır, organizasyonunuzda bu klasörle eşleşen çalışma alanlarını önerir (örneğin aynı git remote'una sahip olanları), seçtiğinizi bağlar ya da klasörün adını taşıyan yeni bir tane oluşturur, hangi yapay zekâ istemcilerinin bağlanacağını sorar, onları kurar, okudukları dosyaları yazar ve bunlardan birinde ilk proje taramasını başlatmayı önerir. Apple Silicon bir Mac'te son olarak isteğe bağlı cihaz üzerinde çalışan modeli önerir. |
pathrule init [name] | Geçerli organizasyonunuzda, siz bir ad vermediğiniz sürece klasörün adını taşıyan bir çalışma alanı oluşturur ve geçerli klasörü ona bağlar. |
Soru sorabileceği bir terminal yoksa pathrule setup yalnızca bir plan yazdırır: organizasyon, eşleşen çalışma alanları ve en uygun olanı bağlayacak komut. Aşağıdaki seçenekler komutun işlem yapmasını sağlar; işlem yapması için de --yes gerekir:
--workspace <name-or-id>mevcut bir çalışma alanını bağlar.--workspace-idda aynı seçenektir.--create-workspaceklasörün adını taşıyan bir çalışma alanı oluşturur. Adı kendiniz vermek için--workspace-name <name>ekleyin.--select-workspace <name-or-id>bu klasörü bağlamadan bir çalışma alanını geçerli yapar.--org <slug-or-id>önce organizasyonu değiştirir.--target <client>, MCP kaydınıclaude,cursor,codex,windsurf,copilotya daalliçin kurar.
pathrule setup --workspace my-project --target all --yes
pathrule setup bootstrap --rerun, deponun dokümanlarını ve commit geçmişini yeniden tarar ve geçerli çalışma alanının ilk proje taraması için yeni hafıza kaydı ve kural adayları hazırlar.
Hesap ve bağlam
| Komut | Ne yapar |
|---|---|
pathrule login | Tek kullanımlık bir kodla giriş yapar. CLI kodu yazdırır ve onay sayfasını kod doldurulmuş olarak tarayıcınızda açar; tarayıcı yoksa herhangi bir cihazda açabileceğiniz URL'yi yazdırır. --no-open hiçbir zaman tarayıcı açmaz. --browser-callback, bu makinedeki bir tarayıcıda GitHub ile giriş yapıp yerel bir callback üzerinden geri döner; bu mümkün değilse kod akışına geri döner. --device-code kabul edilir ve varsayılan kod akışını çalıştırır. |
pathrule logout | Bu makinede Pathrule CLI oturumunu kapatır. --all, bu makinedeki VS Code eklentisi gibi diğer Pathrule yüzeylerinin oturumunu da kapatır. |
pathrule whoami | Giriş yapılmış hesabı ve oturumun ne zaman sona ereceğini gösterir. |
pathrule org list | Organizasyonlarınızı rolünüzle birlikte listeler ve geçerli olanı * ile işaretler. Düz pathrule org de aynısını yapar. |
pathrule org current | Geçerli organizasyonu ve oradaki rolünüzü gösterir. |
pathrule org use <slug-or-id> | Geçerli organizasyonu değiştirir. |
pathrule workspace list | Geçerli organizasyondaki çalışma alanlarını listeler ve geçerli olanı * ile işaretler. Düz pathrule workspace de aynısını yapar. |
pathrule workspace current | Geçerli çalışma alanını gösterir. |
pathrule workspace use <name-or-id> | Bir klasör bağlamadan bir çalışma alanını geçerli yapar. |
pathrule workspace create <name> | Bir çalışma alanı oluşturur ve geçerli klasörü ona bağlar. |
pathrule workspace attach [name-or-id] | Geçerli klasörü, tam adı ya da id'siyle eşleşen mevcut bir çalışma alanına bağlar. Argüman verilmezse geçerli çalışma alanını bağlar. Yol seçeneği yoktur: komutu klasörün içinde çalıştırın. |
pathrule workspace detach [name-or-id] | Çalışma alanının bu makinedeki klasör bağlantısını kaldırır. Çalışma alanı ve içeriği Pathrule'da kalır. |
pathrule workspace inspect | Geçerli çalışma alanını ayrıntılı olarak gösterir: organizasyonu ve planı, nereye bağlı olduğu, git remote'u, kaç hafıza kaydı, kural ve beceri içerdiği, plan kullanımı, hangi yapay zekâ istemcilerinin kurulu olduğu ve son etkinlikler. |
Bağlama, oluşturma, init ve workspace use o çalışma alanını aynı zamanda geçerli yapar. memory, rule, skill, search ve sync gibi komutlar geçerli çalışma alanı üzerinde çalışır.
Çalışma alanı kurulumu
| Komut | Ne yapar |
|---|---|
pathrule attach [name-or-id] | workspace attach ile aynıdır. |
pathrule detach [name-or-id] | workspace detach ile aynıdır. |
pathrule install [client] | Pathrule'un MCP sunucu kaydını bir yapay zekâ istemcisinin kendi kullanıcı düzeyindeki yapılandırmasına yazar ve oradaki diğer sunuculara dokunmaz. İstemci claude (ya da claude-code), cursor, codex, windsurf, copilot (ya da github-copilot) veya varsayılan olan all olabilir. GitHub Copilot için iki kayıt yazılır: biri Copilot CLI, biri VS Code için. |
pathrule uninstall [client] | Pathrule'un MCP kaydını o istemcinin yapılandırmasından ya da beşinin birden yapılandırmasından kaldırır. |
pathrule sync | Yapay zekâ istemcilerinizin okuduğu dosyaları depoya yazar: talimat dosyaları, hook yapılandırması ve yerel hook dizini. Komutu, çalışma alanının bağlı olduğu klasörde çalıştırın. --skills yalnızca çalışma alanının becerilerini istemcilerinizin beceri klasörlerine eşitler. --local hesapsız bir çalışma alanını eşitler. |
pathrule mcp run | Pathrule'un yerel MCP sunucusunu standart girdi ve çıktı üzerinden başlatır. pathrule install tarafından yazılan MCP kaydının başlattığı komut budur; yani onu yapay zekâ istemciniz çalıştırır, sizin çalıştırmanız gerekmez. |
pathrule sync, bu çalışma alanı için pathrule setup sırasında seçilen yapay zekâ istemcilerinin dosyalarını yazar. Hiçbiri seçilmemişse Pathrule dosyaları depoda zaten bulunan istemciler için, hiçbiri yoksa Claude Code için yazar. Claude Code'un CLAUDE.md dosyası ve hook kaydı her eşitlemede yenilenir. Her dosyanın listesi Kurulum sayfasında. Pathrule'u bir depodan tamamen çıkarmak için Pathrule'u bir projeden kaldırma bölümüne bakın.
Bilgi
| Komut | Ne yapar |
|---|---|
pathrule search <query> | Geçerli çalışma alanındaki hafıza kayıtlarında, kurallarda ve becerilerde arama yapar. --type memory,rule türleri daraltır, --path /apps/api bir yolla sınırlar ve --limit <n> sonuç sayısına üst sınır koyar. |
pathrule memory list | Hafıza kayıtlarını listeler. --path ya da başa yazılan bir yol listeyi daraltır; yani pathrule memory list /apps/api ile pathrule /apps/api memory list aynıdır. --limit <n> üst sınır koyar. |
pathrule memory read <id-or-title> | Bir hafıza kaydını yazdırır. Uzun içeriği terminalde tam olarak yazdırmak için --print verin. |
pathrule memory add | --path </node/path> --title <title> ile bir hafıza kaydı yazar. Gövde --body seçeneğinden, standart girdiden ya da ikisi de verilmezse editörünüzden (VISUAL veya EDITOR) gelir. --allow-duplicate yinelenme denetimini atlar. |
pathrule rule list, read, add | Kurallar için aynısı. rule add, --title yerine --name alır; ayrıca --priority (high, medium ya da low, varsayılan medium) ve --scope (project, folder ya da file_type, varsayılan project) alır. |
pathrule skill list, read, add | Beceriler için aynısı. skill add, --name ve isteğe bağlı bir --description alır. |
pathrule refresh list | Açık yenileme görevlerini, yani eskimiş bilgiyi güncelleme isteklerini listeler. --include-in-progress üstlenilmiş olanları da ekler, --limit <n> listeye üst sınır koyar. |
pathrule refresh claim [id] | Bir yenileme görevini üstlenir (id vermezseniz sıradaki açık görevi) ve özetini yazdırır. |
pathrule refresh resolve <id> --status applied | Bir yenileme görevini applied ya da rejected olarak kapatır. --note "<text>" gerekçeyi kaydeder. |
pathrule snapshot | Geçerli klasörün envanterini çıkarır (dosya ağacı, manifest dosyaları ve kısa doküman örnekleri, git dalı ve son geçmiş) ve çalışma alanına yükler. Başka hiçbir dosyanın içeriğini okumaz. --dry-run yüklemeden yazdırır, --notes "<text>" bir not ekler. |
pathrule snapshot list [n] | Çalışma alanının en son snapshot'larını listeler. |
Çalışma tercihleriniz ve yerel model
| Komut | Ne yapar |
|---|---|
pathrule me list | User Intelligence içinde nasıl çalıştığınıza dair tutulanları listeler; hem kullanımda olanları hem de henüz kullanılmayanları. Düz pathrule me de aynısını yapar. |
pathrule me teach "<sentence>" | Bir tercihi kendi cümlelerinizle öğretir. İsteğe bağlı cihaz üzerinde çalışan modeli gerektirir. |
pathrule me explain <id> | Tek bir tercihi, dayandığı kanıtlarla birlikte gösterir. Id, me list komutunun yazdırdığı kısa id'dir. |
pathrule me scope <id> | Bir tercihi, komutu çalıştırdığınız çalışma alanıyla sınırlar. --everywhere tercihin tüm çalışma alanlarında geçerli olmasını sağlar. |
pathrule me forget <id> | Bir tercihi kullanmayı bırakır ve onu reddedilmiş olarak tutar; böylece aynı kanıtlar onu geri getirmez. --delete tercihi tamamen siler. |
pathrule me context "<task>" | O görev için bir ajana neyin iletileceğini, hangi tercihlerin dışarıda tutulduğunu ve nedenini yazdırır. |
pathrule intelligence status | Cihaz üzerinde çalışan modelin kurulu olup olmadığını, sürümünü ve güncelleme olup olmadığını gösterir. Düz pathrule intelligence de aynısını yapar. |
pathrule intelligence install | Modelin ihtiyaç duyduğu yerel çalışma ortamını kurar, ardından modeli indirir ve etkinleşmeden önce checksum'ını doğrular. Apple Silicon bir Mac gerektirir. |
pathrule intelligence update | Daha yeni bir model varsa onu kurar. Güncelleme başarısız olursa mevcut modeliniz yerinde kalır. |
pathrule intelligence remove | Modeli kaldırır. Modele ihtiyaç duymayan her şey eskisi gibi çalışmaya devam eder. |
Local Console ve ajan entegrasyonları
| Komut | Ne yapar |
|---|---|
pathrule ui | Bilgi, etkinlik ve Local Signals için hesap gerektirmeyen Local Console'u açar. --port, --no-open ve --json nasıl açılacağını belirler. |
pathrule integrations | Claude Code ve Codex için etkileşimli kurulum. Etkileşimli bir terminal dışında kurulumu listeler. |
pathrule integrations add claude codex --local --dry-run | Yerel bir entegrasyonu hiçbir şey yazmadan önizler. Cloud modu için --cloud seçin. |
pathrule integrations list | Algılanan ajanları ve kayıtlı entegrasyonları listeler. |
pathrule integrations doctor | Kurulu entegrasyon üzerinde salt okunur denetimler yapar. |
pathrule integrations repair | Kayıtlı Pathrule entegrasyonlarını yeniden uygular. |
pathrule integrations remove <agent> | Kayıtlı entegrasyonu kaldırır. |
pathrule telemetry | Telemetri tercihini ve bu CLI'ın gönderim yapıp yapamayacağını gösterir. |
pathrule telemetry enable | Giriş yapılmış yönetilen bir CLI'da anonim kullanım olaylarını açar. |
pathrule telemetry disable | Bunları kapatır. |
Bkz. Local Console ve Yerleşik ajan entegrasyonları.
Proje entegrasyonunu kaldırma
pathrule eject, geçerli depoda Pathrule'a ait dosyaları ve yönetilen bölümleri kaldırmak için salt okunur bir plan gösterir. pathrule eject --apply, siz planı inceledikten sonra onu uygular. Eject'in --json biçimi yoktur. Yerel eklentiler pathrule integrations remove <agent> ile kaldırılır.
Tanılama ve bakım
| Komut | Ne yapar |
|---|---|
pathrule status | Giriş yapılmış hesabı, geçerli organizasyonu ve planı, geçerli çalışma alanını ve bu klasörün bağlı olup olmadığını gösterir. |
pathrule doctor | Salt okunur denetimler yapar: giriş, organizasyon, çalışma alanı, bu klasörün bağlı olup olmadığı, her yapay zekâ istemcisinde Pathrule'un MCP kaydının bulunup bulunmadığı ve Pathrule'un bu klasörde yönettiği dosyalar ile her birini yazan yüzey ve sürüm. Bir şeyin ilgilenilmesi gerektiğinde sıradaki komutu söyler. --json ile rapor Node.js sürümünü de kapsar ve başlatma komutu güncel olmayan MCP kayıtlarını işaretler. --bundle, kimlik bilgileri ve yerel yollar gizlenmiş bir destek dosyası yazar. |
pathrule repair | Yapay zekâ istemcisi yapılandırmalarınızdaki güncel olmayan Pathrule MCP kayıtlarını diğer sunuculara dokunmadan yeniden yazar, depo dosyalarını tekrar yazar ve neyin değiştiğini bildirir. |
pathrule preflight <action> | Bir işlemi denemeden önce planınızın ona izin verip vermediğini denetler. İşlem create_workspace, write_memory, write_rule, write_skill, sync_agents ya da materialize_skills olabilir. |
pathrule cache prune | Eskimiş yerel önbellek klasörlerini silmeden listeler. --yes onları siler. |
pathrule config get <key> | Bir tercihi okur: update.policy, telemetry.enabled ya da telemetry.id. |
pathrule config set <key> <value> | update.policy manual günlük güncelleme denetimini durdurur; notify ve auto ise denetimi sürdürür. telemetry.enabled false anonim kullanım telemetrisini kapatır. NO_TELEMETRY ortam değişkenini 1 yapmak, tek bir çalıştırma ya da kabuk oturumu için aynı etkiyi yaratır. |
pathrule config reset telemetry-id | Telemetri id'sini yenisiyle değiştirir. |
pathrule update | Daha yeni bir CLI olup olmadığını denetler ve onu kuracak komutu yazdırır. Kendisi hiçbir zaman bir şey kurmaz. |
Etkileşimli bir çalıştırma, günde bir kez daha yeni bir CLI olup olmadığını da denetler ve yükseltme komutunu içeren tek satırlık bir bildirim yazdırır. Yalnızca sizinkinden daha yeni bir sürümü bildirir.
Bağımsız yerel CLI hiç telemetri göndermez. Giriş yapılmış yönetilen bir CLI, anonim kullanım olaylarını yalnızca siz pathrule telemetry enable ile onay verdikten sonra gönderir. Olaylar kod, yol, prompt, bilgi, e-posta ya da hesap ve çalışma alanı id'leri içermez. Bunları pathrule telemetry disable ile kapatın; NO_TELEMETRY=1, DO_NOT_TRACK=1 ve CI ortamı onları kapalı tutar.
Ekip ve faturalandırma
| Komut | Ne yapar |
|---|---|
pathrule team | Geçerli organizasyonun ya da --org <slug-or-id> ile belirtilen organizasyonun üyelerini ve bekleyen davetlerini listeler. pathrule team open, üyelerin yönetildiği Pathrule Web'i açar. |
pathrule invite <email> | Bir ekip arkadaşını geçerli organizasyona editör olarak davet eder. --role, admin, editor ya da viewer rolünü belirler; --org ve --workspace organizasyonu ve çalışma alanını belirler. Davet e-postasının gönderilip gönderilmediğini ve davetin koltuk sayınızı nasıl etkilediğini bildirir. |
pathrule billing | Organizasyonun faturalandırma sayfasını Pathrule Web'de açar. |
pathrule upgrade | Plan seçmek için faturalandırma sayfasını açar. |
Yardım ve sürüm
| Komut | Ne yapar |
|---|---|
pathrule help | Komut listesini yazdırır. |
pathrule version | CLI sürümünü yazdırır, --version ile aynıdır. |
Hesap olmadan çalışma
Pathrule CLI, hesap ve bulut olmadan yerel bir depo üzerinde çalışır. Şu komutları projenin içinde çalıştırın:
cd ~/repos/my-project
pathrule init --local
pathrule setup --local
pathrule init --local [name], geçerli klasör için bu makinede tutulan yerel bir çalışma alanı oluşturur; klasörü zaten kapsayan bir çalışma alanı varsa onu yeniden kullanır. pathrule setup --local da aynısını yapar, ardından yerel MCP kaydını tüm yapay zekâ istemcileri için ya da --target <client> ile tek bir istemci için kurar, hook'ları kurar ve depo dosyalarını yazar; bunların hepsini giriş yapmadan yapar. --workspace-name <name> yeni çalışma alanına ad verir. --org ya da --workspace gibi hesap gerektiren seçenekler hata vererek durur.
Yerel bir çalışma alanında yapay zekâ ajanınız hafıza kayıtlarını, kuralları ve becerileri Pathrule'un MCP araçlarıyla yazar. Terminalden ise bunları --local ile okur ve ararsınız:
pathrule memory list --local
pathrule rule read "No service key in browser code" --local
pathrule search "migrations" --local
pathrule sync --local
memory add, rule add ve skill add hesap gerektirir. --local ile çalıştırıldıklarında bunu belirtir ve hiçbir şeyi değiştirmezler. Yerel sürümün neleri içerdiğini görmek için Açık kaynak çekirdek sayfasına bakın.
Sırada ne okumalı
- İlk kurulum, Pathrule'un bir depoya neler yazdığı ve nasıl kaldırılacağı için Kurulum.
- CLI'ın neyi üstlendiği ve ne zaman kullanılacağı için Pathrule CLI.
pathrule mekomutunun neyi yönettiği için User Intelligence.