Dokümantasyon / Referans

CLI referansı

ivralo'nun bütün komutları, argümanları ve seçenekleriyle; main'deki kod onları nasıl tanımlıyorsa öyle. Zorunlu diye işaretlenen seçenekler verilmek zorundadır; tire, varsayılan değer olmadığını gösterir.

Aynı metni kendi makinenizde görmek için ivralo --help ya da ivralo <command> --help çalıştırın. Çıkış kodları Çıkış kodları sayfasında.

Oturum ve genel seçenekler

ivralo'yu komut vermeden çalıştırırsanız tam ekran oturum açılır; bunun için bir terminal gerekir. Aşağıdaki seçenekler her komuttan önce yazılır: --model ve --profile arkasından gelen komuta, --session ise açılan oturuma uygulanır.

ivralo: oturumu açar ya da arkasından gelen komutu çalıştırır.

Seçenek	Varsayılan	Ne yapar
`--session`, `-s`	-	Ortak oturum yerine belirli bir oturum kimliğine bağlanır. İki terminalde ayrı konuşmalar yürütmek için kullanılır.
`--model`, `-m`	-	Bu run'ın ana modeli: çekilmiş bir etiket ya da `provider:model` (`anthropic:claude-sonnet-5`, `openai:gpt-5.5`, ...). Anahtarlar `.env`'den okunur.
`--profile`	-	`normal` (varsayılan) ya da `strict`: shell, web, gönderim, Google'a ya da GitHub'a yazma ve MCP sunucusu kapalıdır. Yalnızca kısıtlar, hiçbir şeyi açmaz.
`--version`, `-V`	-	Sürümü gösterir ve çıkar.

Kurulum

Ana dizini, veritabanını ve modeli hazırlayan ve kontrol eden komutlar. Adım adım anlatım kurulum sayfalarında: Sunucuya kurulum, Checkout'tan kurulum, Doctor.

ivralo init: Temiz bir checkout'tan tek komutla çalışan bir oturuma.

Seçenek	Varsayılan	Ne yapar
`--yes`, `-y`	-	Hiçbir şey sormadan bütün varsayılanları kabul eder.
`--model`, `-m`	-	Ana model: çekilmiş bir etiket ya da `provider:model`.
`--docker`, `--no-docker`	-	PostgreSQL'i docker compose ile başlatır.
`--pull`, `--no-pull`	-	Eksik Ollama etiketlerini çeker.
`--browser`, `--no-browser`	-	Web araçlarının kullandığı tarayıcıyı kurar.
`--hooks`, `--no-hooks`	-	Checkout'ta git hook'larını kurar.
`--home`	-	Önce bu klasörü ana dizin yapar: gelen skill'ler, `brand.json`, `workspace/`.
`--server`	-	Sunucu kurulumu: soru sorulmaz (`--yes`), tarayıcı kurulmaz, Ollama'dan model çekilmez, hook kurulmaz. Projenin kendi kurulum adımı yalnızca elle yazılmış bir `--yes` ile çalışır; terminalde bir kez sorulur. İkisi de yoksa, `IVRALO.md` bir dil sunucusu tanımlıyorsa kırmızı görünür, tanımlamıyorsa yalnızca bir ipucudur.
`--model-url`	-	OpenAI uyumlu bir endpoint'in temel URL'si; bu durumda `--model` orada sunulan modelin adıdır.
`--embed-model`	-	Embedding modeli: `provider:model` ya da `--model-url`'de sunulan bir ad. Embedding modeli olmayan bir sunucu bilgi dizini kapalı olarak çalışır.
`--postgres`	-	Var olan bir PostgreSQL'in URL'si (`postgresql://user:password@host:5432/db`); `.env`'e yazılır, ekrana hiç basılmaz. Ya da `auto`: önce docker, yoksa yerel bir PostgreSQL, o da yoksa `ivralo[pg]` extra'sının kümesi; ivralo ana dizinin altında bir tane kurar (`--server` ile varsayılan budur). Ya da `managed`: aynı küme, ama servis yöneticiniz başlatıp durdurur.
`--token`	-	Yerel API'nin token dosyasını oluşturur (`ivralo serve` bu dosyayı okur).
`--workspace`	-	Ana dizini var olan bir repo'ya yönlendirir.
`--trust`	-	init'in çalıştığı klasörü güvenilir sayar (ve bunu hatırlar).
`--git-name`	-	`--server` ile: ivralo'nun commit'lerde kullandığı ad.
`--git-email`	-	`--server` ile: ivralo'nun kendi git e-postası; asla sizinki değil.

ivralo doctor: ivralo'nun ihtiyaç duyduğu her şeyin gerçekten yerinde olup olmadığını kontrol eder.

ivralo agents: Uzmanları ve her birine ait skill'leri listeler.

İstek göndermek

Bir script'ten ya da pipe'tan tek bir istek göndermek ve terminal olmayan istemciler için yerel API. Ayrıntılar Yerel API sayfasında.

ivralo ask PROMPT...: Tek bir isteği çalıştırır ve çıkar.

Seçenek	Varsayılan	Ne yapar
`PROMPT...`	zorunlu	Ne yapılmasını istediğiniz.
`--image`, `-i`	-	Görsel ekler (birden çok kez verilebilir): yanınızdaki bir dosya ya da çalışma alanındaki bir dosya.
`--session`, `-s`	-	Ortak oturum yerine belirli bir oturum kimliğine bağlanır. İki terminalde ayrı konuşmalar yürütmek için kullanılır.
`--verbose`	-	Kısa iz yerine her aracın argümanlarını tam olarak gösterir.
`--no-stream`	-	Cevabı akış halinde değil, tamamlanınca bir kerede gösterir.
`--plan`	-	Önce adım adım bir plan çıkarır, gösterir, sonra uygular.
`--yes`, `-y`	-	`--plan` ile: sormadan uygular (pipe'lar için).
`--format`	`text`	`text` (varsayılan) ya da `json`: stdout'a tek bir JSON nesnesi, iz stderr'e yazılır.
`--quiet`, `-q`	-	Yalnızca düz cevabı yazar, başka hiçbir şey yazmaz.
`--stdin-name`	`stdin.txt`	Pipe ile gelen metnin çalışma alanında kaydedileceği yer.
`--no-stdin`	-	stdin terminal olmasa bile onu yok sayar.
`--model`, `-m`	-	Bu run'ın ana modeli: çekilmiş bir etiket ya da `provider:model` (`anthropic:claude-sonnet-5`, `openai:gpt-5.5`, ...). Anahtarlar `.env`'den okunur.
`--profile`	-	`normal` (varsayılan) ya da `strict`: shell, web, gönderim, Google'a ya da GitHub'a yazma ve MCP sunucusu kapalıdır. Yalnızca kısıtlar, hiçbir şeyi açmaz.
`--job`	-	İsteği bir job olarak çalıştırır: kaydı bu terminal kapansa da kalır, bir çökmeden sonra `ivralo resume <id>` ile devam ettirilir.
`--via-api`	-	İsteği çalışan `ivralo serve`'e gönderir; onay sorularını burada cevaplarsınız.
`--trust`	-	Bu klasörü güvenilir sayar (ve bunu hatırlar): böylece `IVRALO.md`'de tanımlananlar çalışabilir.
`--changeset`, `--no-changeset`	-	Düzenlemeleri tek bir changeset olarak hazırlar: yalnızca tanımlı kontroller geçerse uygulanır.
`--keep-changeset`	-	Düzenlemeleri hazırlar ve öyle bırakır, hiçbir zaman uygulamaz.

ivralo serve: Bu çalışma alanı için yerel API'yi Ctrl+C'ye basılana kadar çalıştırır: yalnızca loopback, bir token, hiçbir şey saklanmaz.

Seçenek	Varsayılan	Ne yapar
`--port`	-	Loopback portu; varsayılan olarak `IVRALO_API_PORT` (61017).
`--new-token`	-	Token'ı yeniler; bütün istemcilerin yeni token'ı alması gerekir.

Bir repo'da çalışmak

Planlar, kontroller, güven ve her turun neyi değiştirdiği. Ayrıntılar Geliştirici modu sayfasında.

ivralo plan PROMPT...: Bir istek için plan taslağı çıkarır, Markdown olarak kaydeder ve yazdırır, ama çalıştırmaz. --job verilirse planı, bu terminal kapansa da süren bir job olarak çalıştırır.

Seçenek	Varsayılan	Ne yapar
`PROMPT...`	zorunlu	Ne yapılmasını istediğiniz.
`--session`, `-s`	-	Ortak oturum yerine belirli bir oturum kimliğine bağlanır. İki terminalde ayrı konuşmalar yürütmek için kullanılır.
`--json`	-	Script'ler için JSON çıktı.
`--profile`	-	`normal` (varsayılan) ya da `strict`: shell, web, gönderim, Google'a ya da GitHub'a yazma ve MCP sunucusu kapalıdır. Yalnızca kısıtlar, hiçbir şeyi açmaz.
`--job`	-	Çıkan planı inceleme adımı olmadan hemen bir job olarak çalıştırır; `ask --plan --job` ise önce planı gösterir. Kaydı bu terminal kapansa da kalır (`ivralo resume <id>`).

ivralo verify [PATHS...]: Projenin IVRALO.md'de tanımlı format, lint, tip ve test komutlarını en ucuzundan başlayarak çalıştırır.

Seçenek	Varsayılan	Ne yapar
`PATHS...`	-	Değişen dosyalar; verilmezse git'e göre `HEAD`'den bu yana değişen dosyalar alınır.
`--scope`	`targeted`	`targeted`: değişikliğin ilgilendirdiği testler, ardından bir halka daha geniş; `full`: test komutunun tamamı.
`--yes`, `-y`	-	Onay isteyecek komutları onaylar.
`--trust`	-	Çalıştırmadan önce bu klasörü güvenilir sayar (ve bunu hatırlar).

ivralo trust [PATH]: Bir klasörü güvenilir sayar: böylece IVRALO.md'sindeki komutlar, dil sunucuları ve izinler geçerli olur.

Seçenek	Varsayılan	Ne yapar
`PATH`	-	Klasör; verilmezse içinde bulunduğunuz klasör.
`--revoke`	-	Klasöre güvenildiğini (ya da güvenilmediğini) unutur.
`--list`	-	Güvenilen bütün klasörleri listeler, başka bir şey yazmaz.
`--yes`, `-y`	-	Soru soracak bir terminal olmadan güvenir (script'ler için).

ivralo changes: Her turun bu repo'da neyi değiştirdiğini en yeniden başlayarak gösterir; oturumdaki değişiklik panelinin karşılığıdır.

Seçenek	Varsayılan	Ne yapar
`--limit`, `-n`	`20`	Kaç turun gösterileceği.
`--json`	-	stdout'a tek bir JSON nesnesi yazar.
`--hunks`	-	Her dosyanın hunk'larını, diff görüntüleyicideki gibi ait oldukları sembolün altında gösterir.

ivralo history [FILE]: Çalışma alanındaki bir dosyanın, üzerine yazılmadan önce saklanan sürümleri.

Seçenek	Varsayılan	Ne yapar
`FILE`	-	Çalışma alanındaki bir dosya; verilmezse geçmişi olan bütün dosyalar.

ivralo restore FILE: Bir dosyanın saklanan bir sürümünü geri getirir. Dosyanın şimdiki hali önce geçmişe kaydedilir.

Seçenek	Varsayılan	Ne yapar
`FILE`	zorunlu	Geri getirilecek çalışma alanı dosyası.
`--at`	-	Bir zaman damgası (ya da başı); verilmezse en yeni sürüm.

ivralo changeset

ivralo changeset alt komut verilmeden çalıştırılırsa bu çalışma alanında bekleyen changeset'leri listeler. Ayrıntılar Changeset'ler sayfasında.

ivralo changeset list: Bekleyen changeset'ler: kimlik, dosya sayısı, ne istendiği.

Seçenek	Varsayılan	Ne yapar
`--json`	-	stdout'a tek bir JSON nesnesi yazar.

ivralo changeset show [CHANGESET_ID]: Bir changeset'in dosyaları ve hunk'ları, diff görüntüleyicide göründüğü gibi.

Seçenek	Varsayılan	Ne yapar
`CHANGESET_ID`	-	Changeset'in kimliği ya da kimliğin başı; verilmezse bekleyen changeset.
`--json`	-	stdout'a tek bir JSON nesnesi yazar.

ivralo changeset land [CHANGESET_ID]: Changeset'i geçmiş üzerinden çalışma ağacınıza uygular. Sizin kendi düzenlemelerinizin üzerine yazacaksa reddedilir ve hiçbir şey yazılmaz.

Seçenek	Varsayılan	Ne yapar
`CHANGESET_ID`	-	Changeset'in kimliği ya da kimliğin başı; verilmezse bekleyen changeset.

ivralo changeset drop [CHANGESET_ID]: Hazırlanan düzenlemeleri atar; çalışma ağacınız olduğu gibi kalır.

Seçenek	Varsayılan	Ne yapar
`CHANGESET_ID`	-	Changeset'in kimliği ya da kimliğin başı; verilmezse bekleyen changeset.
`--yes`, `-y`	-	Sormadan atar.

ivralo changeset release CHANGESET_ID: Artık çalışmayan bir turun bıraktığı işareti kaldırır; böylece changeset uygulanabilir ya da atılabilir.

Seçenek	Varsayılan	Ne yapar
`CHANGESET_ID`	zorunlu	Changeset'in kimliği ya da kimliğin başı.

Oturumlar ve run'lar

Bir run, tek bir istek ve ekibin o istek için yaptığı her şeydir. Bu komutlar run'ları listeler, açar ve dışa aktarır. Ayrıntılar Gözlemlenebilirlik ve Why sayfalarında.

ivralo sessions: Son konuşmaları en yeniden başlayarak listeler.

Seçenek	Varsayılan	Ne yapar
`--limit`, `-n`	`20`	Kaç tanesinin gösterileceği.

ivralo new: Yeni bir oturum başlatır. Eski oturum veritabanında kalır.

ivralo compact: Oturumu özetler ve eski turları modelin bağlamından gizler.

Seçenek	Varsayılan	Ne yapar
`--session`, `-s`	-	Ortak oturum yerine belirli bir oturum kimliğine bağlanır. İki terminalde ayrı konuşmalar yürütmek için kullanılır.
`--focus`	-	Özette özellikle üzerinde durulacak konu.
`--keep`	`2`	Süreklilik için en yeni kaç run'ın görünür kalacağı.

ivralo runs: Oturumun run'larını en yeniden başlayarak listeler: ne istendi, kim yaptı, maliyeti ne oldu.

Seçenek	Varsayılan	Ne yapar
`--session`, `-s`	-	Ortak oturum yerine belirli bir oturum kimliğine bağlanır. İki terminalde ayrı konuşmalar yürütmek için kullanılır.
`--limit`, `-n`	`20`	Kaç tanesinin gösterileceği.

ivralo trace [RUN]: Bir run'ı açar: her araç çağrısı, argümanları ve ne döndürdüğü.

Seçenek	Varsayılan	Ne yapar
`RUN`	`last`	Run kimliğinin başı (en az 8 karakter) ya da `last`.
`--session`, `-s`	-	Ortak oturum yerine belirli bir oturum kimliğine bağlanır. İki terminalde ayrı konuşmalar yürütmek için kullanılır.
`--json`	-	Araç çağrılarının düz listesini JSON olarak verir.
`--tail`	`12`	Her çıktıdan kaç satır gösterileceği.
`--html`	-	Run'ı ekrana basmak yerine tek başına açılabilen bir HTML dosyasına yazar: zaman çizelgesi, bütün çağrılar, çıktıların tamamı.
`--out`	-	`--html` çıktısının yazılacağı yer; varsayılan: `workspace/.ivralo/traces/`.

ivralo why RUN CLAIM: Bir iddianın nereden geldiğini, yani arkasındaki kayıtlı olgu zincirini gösterir.

Seçenek	Varsayılan	Ne yapar
`RUN`	zorunlu	Run kimliğinin başı (en az 8 karakter) ya da `last`.
`CLAIM`	zorunlu	İzi sürülecek şey: bir sayı ("18%") ya da bir ifade.
`--session`, `-s`	-	Ortak oturum yerine belirli bir oturum kimliğine bağlanır. İki terminalde ayrı konuşmalar yürütmek için kullanılır.
`--json`	-	Zinciri stdout'a tek bir JSON nesnesi olarak yazar.

ivralo export [SESSION]: Bütün bir konuşmayı tek bir dosyaya yazar: her tur, araç çağrıları ve cevaplar.

Seçenek	Varsayılan	Ne yapar
`SESSION`	`last`	Oturum kimliği (en az 8 karakter) ya da etkin oturum için `last`.
`--format`	`html`	`html` (tek başına açılabilen bir sayfa) ya da `md`.
`--out`	-	Dosyanın yazılacağı yer; varsayılan: `workspace/.ivralo/exports/`.

Kayıt ve tekrar

Kaset, kayıtlı bir run'daki araç cevaplarının maskelenmiş halidir ve .ivralo/cassettes/ altında tutulur. Ayrıntılar Kayıt ve tekrar sayfasında.

ivralo record [RUN]: Kayıtlı bir run'ı .ivralo/cassettes/ içine kaset olarak yazar ve dosyanın yolunu gösterir.

Seçenek	Varsayılan	Ne yapar
`RUN`	`last`	Run kimliğinin başı (en az 8 karakter) ya da `last`.
`--session`, `-s`	-	Ortak oturum yerine belirli bir oturum kimliğine bağlanır. İki terminalde ayrı konuşmalar yürütmek için kullanılır.

ivralo replay [RUN]: Kayıtlı bir run'ın isteğini yeniden çalıştırır; her araç çağrısının cevabı kasetten gelir.

Seçenek	Varsayılan	Ne yapar
`RUN`	`last`	Run kimliğinin başı (en az 8 karakter) ya da `last`.
`--tools`	`mocked`	Araçların davranışı: `mocked` her çağrıyı kasetten cevaplar.
`--session`, `-s`	-	Ortak oturum yerine belirli bir oturum kimliğine bağlanır. İki terminalde ayrı konuşmalar yürütmek için kullanılır.
`--json`	-	Raporu stdout'a tek bir JSON nesnesi olarak yazar.

Job'lar

Job, kaydı onu başlatan terminal kapandıktan sonra da kalan iştir. Ayrıntılar Job'lar sayfasında.

ivralo jobs alt komut verilmeden çalıştırılırsa bu çalışma alanının job'larını listeler.

ivralo jobs list: Bu çalışma alanının job'larını listeler: kimlik, durum, yaş, o an yürüyen adım ve bekleyen bir job'un neyi beklediği.

ivralo jobs run: Bu çalışma alanının sıradaki job'unu çalıştırır ve çıkar; işletim sisteminin zamanlayıcısı bu komutu çağırır.

ivralo job JOB_ID: Tek bir job'un bütün ayrıntıları: durumu, lease'i, beklediği soru ve log'u.

Seçenek	Varsayılan	Ne yapar
`JOB_ID`	zorunlu	`ivralo jobs` çıktısındaki job kimliği.

ivralo cancel JOB_ID: Çalışan, beklemede ya da kuyrukta olan bir job'u durdurur ve iptal edildi olarak kaydeder.

Seçenek	Varsayılan	Ne yapar
`JOB_ID`	zorunlu	`ivralo jobs` çıktısındaki job kimliği.

ivralo resume JOB_ID: Bir job'u devam ettirir. Çökmeden sonra son teslim edilen adımdan devam eder; hangi adımın yeniden başladığını ve önceki denemenin ne bıraktığını söyler. Kuyruktaki bir job başlar. Beklemedeki bir job, burada verilen cevapla devam eder; cevap verilmezse sorusunu gösterir ve hiçbir şeyi değiştirmeden 1 ile çıkar.

Seçenek	Varsayılan	Ne yapar
`JOB_ID`	zorunlu	`ivralo jobs` çıktısındaki job kimliği.
`--approve`	-	Beklemedeki job için: evet, yalnızca bu çağrı.
`--approve-job`	-	Beklemedeki job için: evet, bu job'un geri kalanındaki bütün düzenlemeler de.
`--reject`	-	Beklemedeki job için: hayır; eklenen not, modele bunun yerine ne yapacağını söyler.

ivralo bisect: Bir komutu bozan commit'i bulur. --good ile --bad arasındaki commit'leri kendi worktree'sinde deneyen bir job'dur; sizin checkout'unuza hiç dokunmaz. Bittiğinde 0, başarısız olursa 1 ile çıkar.

Seçenek	Varsayılan	Ne yapar
`--good`	zorunlu	Komutun geçtiği bir commit.
`--bad`	`HEAD`	Komutun başarısız olduğu bir commit.
`--command`	-	Her commit'te çalıştırılacak komut; boşsa tanımlı test komutu.
`--steps`	`0`	En fazla kaç komut çalıştırılacağı; 0 ise `IVRALO_BISECT_STEPS`.

Zamanlamalar

ivralo schedule alt komut verilmeden çalıştırılırsa zamanlamaları listeler. Zamanlama, Linux ve macOS'ta bir cron girdisi, Windows'ta bir schtasks görevidir. Ayrıntılar Zamanlamalar sayfasında.

ivralo schedule list: Zamanlamaları, işletim sisteminde hâlâ kayıtlı olup olmadıklarını ve son çalışmalarını listeler.

ivralo schedule add NAME [REQUEST...]: Bir isteği işletim sisteminin zamanlayıcısına kaydeder ve schedules.json'a yazar.

Seçenek	Varsayılan	Ne yapar
`NAME`	zorunlu	Bir ad: harf, rakam ve tire.
`--every`	zorunlu	`daily HH:MM`, `weekdays HH:MM`, `weekly <mon..sun> HH:MM`, `monthly <1-31> HH:MM`, `hourly`.
`REQUEST...`	-	Ne yapılacağı, normalde nasıl soruyorsanız öyle.
`--mail-to`	-	Bu zamanlamanın e-posta gönderebileceği alıcılar (birden çok kez verilebilir). Verilmezse e-posta gönderemez.
`--notify`	-	Zamanlamanın yapılandırılmış Telegram ya da Slack sohbetine mesaj atmasına izin verir.
`--yes`	-	Aynı adda bir zamanlama varsa sormadan değiştirir.
`--jobs`	-	Bir istek yerine bu çalışma alanı için `ivralo jobs run` çalıştırır: her seferinde kuyruktaki sıradaki job başlar.

ivralo schedule remove NAME: İşletim sistemindeki görevi kaldırır ve zamanlamayı unutur; çalışma log'ları silinmez.

Seçenek	Varsayılan	Ne yapar
`NAME`	zorunlu	Silinecek zamanlama.
`--yes`	-	Onay sorusunu atlar.

ivralo schedule run NAME: Bir zamanlamanın isteğini şimdi, başında kimse olmadan çalıştırır; işletim sistemindeki görev bu komutu çağırır.

Seçenek	Varsayılan	Ne yapar
`NAME`	zorunlu	Şimdi çalıştırılacak zamanlama.

ivralo schedule log NAME: Son çalışmalar: ne zaman çalıştı, başarılı mı başarısız mı, kaç saniye sürdü, hangi dosyalar çıktı ve cevabın ilk satırı.

Seçenek	Varsayılan	Ne yapar
`NAME`	zorunlu	Çalışmaları gösterilecek zamanlama.
`--limit`	`10`	Kaç run gösterileceği, en yeniden başlayarak.

Incident'lar

Ayrıntılar Incident incelemek ve Kendi incident'larınızda pilot sayfalarında.

ivralo incident [BUNDLE]: Bir incident'ı kanıt paketinden inceler ve bir rapor yazar.

Seçenek	Varsayılan	Ne yapar
`BUNDLE`	`incident/`	Kanıt paketi: çalışma alanında bir klasör.
`--format`	`text`	`text` (varsayılan) ya da `json`: rapor nesnesi stdout'a, iz stderr'e yazılır.
`--hosted`	-	Bu run için makine dışında çalışan bir modelin kanıtı okumasına izin verir; `IVRALO_INCIDENT_MASK=true` gerekir, böylece model gerçek değerler yerine yer tutucuları görür.
`--session`, `-s`	-	Hangi oturumda çalışılacağı: varsayılan olarak incident'ın adını taşıyan yeni bir oturum açılır; `shared` ortak oturuma katılır, başka bir kimlik verilirse o oturumdan devam edilir.

ivralo pilot run PACK: Paketteki her incident'ı inceler ve her raporu bilinen kök nedene göre puanlar.

Seçenek	Varsayılan	Ne yapar
`PACK`	zorunlu	Paket: çözülmüş incident'lardan oluşan bir klasör.
`--repository`	-	Revizyonların bulunduğu repo (varsayılan: çalışma alanı).
`--out`	-	Raporun yazılacağı yer, repo'nun dışında (varsayılan: `<pack>/.pilot/<stamp>/`).
`--format`	`text`	`text` (varsayılan) ya da `json`: rapor stdout'a yazılır.
`--hosted`	-	Makine dışında çalışan bir modelin kanıtı okumasına izin verir.
`--fail-under`	-	Eşik: eşleşen incident'ların oranı bu yüzdenin altındaysa 1 ile çıkar.

Bilgi, skill'ler ve hafıza

Ayrıntılar Bilgi dizini ve Skill'ler sayfalarında.

ivralo index: Çalışma alanındaki belgeleri embed ederek bilgi dizinine ekler.

Seçenek	Varsayılan	Ne yapar
`--rebuild`	-	Yalnızca değişenleri güncellemek yerine bu çalışma alanının dizinini sıfırdan kurar.
`--all`	-	`--rebuild` ile: veritabanındaki bütün çalışma alanlarını ve vektör tablosunun kendisini kapsar (embedding boyutu değiştiyse ya da taşınan bir çalışma alanının eski satırları varsa).
`--code`	-	Bunun yerine kod dizinini kurar: semboller ve git geçmişi, veritabanı olmadan.
`--semantic`	-	`--code` ile: ardından kodu sembollere göre parçalayıp `semantic_code_search` için embed eder.

ivralo search QUERY...: Bilgi dizininde elle arama yapar; Librarian'ın alacağı sonuçları gösterir.

Seçenek	Varsayılan	Ne yapar
`QUERY...`	zorunlu	Ne arandığı, normalde nasıl soruyorsanız öyle.
`--limit`, `-n`	`0`	Gösterilecek sonuç sayısı; 0 ise `IVRALO_KNOWLEDGE_RESULTS`.
`--json`	-	Sonuçları script'ler için JSON olarak verir.

ivralo skills

ivralo skills alt komut verilmeden çalıştırılırsa kurulu skill'leri ve doğrulamadan geçip geçmediklerini listeler.

ivralo skills assign NAME: Yerel overlay üzerinden bir skill'i bir ya da birkaç uzmana verir.

Seçenek	Varsayılan	Ne yapar
`NAME`	zorunlu	Verilecek skill.
`--agent`, `-a`	zorunlu	Skill'in verileceği uzmanın anahtarı (birden çok kez verilebilir).

ivralo skills unassign NAME: Bir skill'in overlay atamasını kaldırır.

Seçenek	Varsayılan	Ne yapar
`NAME`	zorunlu	Overlay ataması kaldırılacak skill.

ivralo skills create NAME: Yazıldığı haliyle doğrulamadan geçen yeni bir skill paketinin iskeletini oluşturur.

Seçenek	Varsayılan	Ne yapar
`NAME`	zorunlu	Yeni skill'in adı (küçük harf, kelimeler tireyle ayrılır).
`--agent`, `-a`	-	Skill'in verileceği uzmanın anahtarı (birden çok kez verilebilir; yalnızca yerel raf).
`--shipped`	-	İskeleti `skills.local/` yerine commit'lenen `skills/` rafına kurar.
`--scripts`	-	Bir `scripts/` klasörü ekler.
`--references`	-	Bir `references/` klasörü ekler.

ivralo skills lint [NAME...]: Skill'leri, yanlış cevaplara yol açtığı bilinen tuzaklara karşı denetler.

Seçenek	Varsayılan	Ne yapar
`NAME...`	-	Denetlenecek skill'ler; verilmezse hepsi.
`--strict`	-	Hata seviyesinde bir bulgu varsa 1 ile çıkar.
`--shelf`	-	`shipped` ya da `local`; verilmezse ikisi de.
`--fix`	-	Yerel raftaki okunamayan bir name/description değerini tırnak içine alır.

ivralo skills install SOURCE: GitHub'dan bir skill'i yerel rafa kurar.

Seçenek	Varsayılan	Ne yapar
`SOURCE`	zorunlu	`owner/repo[/sub/path][@ref]` ya da yapıştırılmış bir GitHub URL'si.
`--agent`, `-a`	-	Skill'in verileceği uzmanın anahtarı (birden çok kez verilebilir).
`--yes`	-	Yeni kurulumda onay sorusunu atlar. Güncellemelerde her zaman sorulur.

ivralo skills update NAME: Kurulu bir skill'i kayıtlı kaynağından yeniden çeker. Her zaman onay ister.

Seçenek	Varsayılan	Ne yapar
`NAME`	zorunlu	Kaynağından yeniden çekilecek kurulu skill.

ivralo skills remove NAME: Yerel bir skill'i ve overlay atamasını siler.

Seçenek	Varsayılan	Ne yapar
`NAME`	zorunlu	Atamasıyla birlikte silinecek yerel skill.
`--yes`	-	Onay sorusunu atlar.

ivralo memory

ivralo memory alt komut verilmeden çalıştırılırsa hafızadaki kayıtları listeler.

ivralo memory list: Hafızadaki kayıtları listeler.

ivralo memory forget MEMORY: Tek bir kaydı unutur.

Seçenek	Varsayılan	Ne yapar
`MEMORY`	zorunlu	Kaydın kimliği ya da onu ayırt etmeye yetecek kadar başı.

ivralo memory clear: Sizinle ilgili hatırlanan her şeyi unutur.

Seçenek	Varsayılan	Ne yapar
`--yes`, `-y`	-	Onay sormaz.

Entegrasyonlar

ivralo mcp

ivralo mcp alt komut verilmeden çalıştırılırsa yapılandırılmış sunucuları listeler. Ayrıntılar MCP sunucuları sayfasında.

ivralo mcp list: Yapılandırılmış MCP sunucularını listeler.

ivralo mcp recipes: Bilinen sunucular: her biri ne sağlar, neye ihtiyaç duyar, hangi uzman taşır.

ivralo mcp add [NAME]: Bir MCP sunucusu tanımlar; tanım ekip listesine göre doğrulanır.

Seçenek	Varsayılan	Ne yapar
`NAME`	-	Sunucunun adı (aynı zamanda toolkit etiketi); varsayılan olarak tarifin adı.
`--recipe`	-	Bilinen bir sunucudan başlar: bkz. `ivralo mcp recipes`.
`--command`	-	Bir stdio sunucusunun çalıştırılabilir dosyası. Windows'ta npx sunucuları için şu biçim gerekir: `--command cmd --arg /c --arg npx --arg -y --arg "<package>"`
`--arg`	-	Komuta verilecek bir argüman (birden çok kez verilebilir, bölünmeden aktarılır).
`--url`	-	Uzak bir sunucunun endpoint'i (varsayılan olarak streamable-http).
`--transport`	-	`stdio`, `sse` ya da `streamable-http` (`http` bunun takma adıdır).
`--env`	-	Sunucuya verilecek `KEY=VALUE` (birden çok kez verilebilir; `${VAR}` açılır).
`--header`	-	`KEY=VALUE` biçiminde HTTP başlığı (birden çok kez verilebilir; `${VAR}` açılır).
`--agent`, `-a`	-	Sunucunun araçlarını taşıyacak uzmanın anahtarı (birden çok kez verilebilir).
`--timeout`	`30`	Saniye cinsinden okuma zaman aşımı.
`--include-tool`	-	Yalnızca bu araçları açar (birden çok kez verilebilir).
`--exclude-tool`	-	Bu araçları gizler (birden çok kez verilebilir).
`--prefix`	-	Ad çakışmalarına karşı araç adlarına eklenecek önek.
`--disabled`	-	Sunucuyu dosyada tutar ama hiçbir uzmana bağlamaz.
`--yes`	-	Var olan bir girdinin üzerine sormadan yazar.

ivralo mcp remove NAME: Bir sunucuyu dosyadan siler.

Seçenek	Varsayılan	Ne yapar
`NAME`	zorunlu	Silinecek sunucu girdisi.
`--yes`	-	Onay sorusunu atlar.

ivralo mcp test NAME: Sunucuya gerçekten bağlanır ve araçlarını listeler.

Seçenek	Varsayılan	Ne yapar
`NAME`	zorunlu	Bağlanılacak sunucu.

ivralo google

Ayrıntılar Google Workspace sayfasında.

ivralo google login: Tarayıcıda bir kez onay verirsiniz; token ana dizine yazılır ve bundan sonra kendiliğinden yenilenir.

Seçenek	Varsayılan	Ne yapar
`--yes`, `-y`	-	Tarayıcıyı önce sormadan açar.

ivralo google status: Nelerin hazır olduğunu ve ilk düzeltilmesi gereken şeyi gösterir.

ivralo google logout: Token'ı unutur. Bir sonraki girişte yeniden onay istenir.

Eval'ler

ivralo eval, ivralo'nun davranış eval'lerini gerçek bir modele karşı çalıştırır. Katkıda bulunanlar için bir araçtır; seçenekleriyle birlikte Eval'ler sayfasında anlatılıyor.