Komut satırı aracı

Oleafly, uygulamayla aynı projeler üzerinde çalışan bir komut satırı aracı olan oleafly ile gelir. Bir makaleyi bir terminalden, bir betikten ya da CI’dan derleyin veya denetleyin. Bir kodlama ajanına projenize güvenilir bir giriş yolu verin. Çevrimiçi bir LaTeX hizmetiyle ya da bir Oleafly sunucusuyla eşitleyin veya Oleafly ajanını uygulamayı açmadan çalıştırın.

Her platformda uygulamanın içinde gelir. Bu sayfa Oleafly 0.4.8 ve sonrasındaki komutları kapsar. Önceki sürümlerde daha azı vardı; bu yüzden ona bağlı betiklerde Oleafly sürümünüzü sabitleyin.

Kurulum

Sistem	Uygulamanın onu tuttuğu yer	oleafly komutunu PATH’inize koyun
Windows	oleafly-cli.exe uygulamanın yanında: kurulum programı için %LOCALAPPDATA%\Oleafly, MSI paketi için C:\Program Files\Oleafly içinde	Ayarlar → Genel içindeki Terminal komutu satırında Kur, onu %LOCALAPPDATA%\Oleafly\bin\oleafly.exe konumuna kopyalar ve o klasörü PATH’inize ekler
macOS	Oleafly.app/Contents/MacOS/oleafly-cli	Terminal komutu satırında Kur, yazabiliyorsanız oleafly komutunu /usr/local/bin içine, yazamıyorsanız ~/.local/bin içine bağlar
Linux paketleri (.deb, .rpm)	/usr/bin/oleafly-cli	Yapılacak bir şey yok: paket /usr/bin/oleafly dosyasını kurar
Linux AppImage	AppImage’ın içinde	Kur, onu ~/.local/bin/oleafly konumuna kopyalar

Oleafly’nin başlattığı programlar, örneğin kendi terminali ve CLI ajanları, siz kurmadan önce bile oleafly komutunu her zaman PATH’lerinde bulur. OLEAFLY_CLI değişkeni onun tam yolunu tutar.

Windows

1. Ayarlar → Genel bölümünü açın ve Terminal komutu satırında Kur’u seçin.
2. Yeni bir PowerShell ya da Komut İstemi penceresi açın. Zaten açık olan pencereler eski PATH’i korur.
3. Çalıştığını denetleyin:

Get-Command oleafly
oleafly version

Aynı satırdaki Kaldır, kopyayı siler ve klasörü PATH’inizden yeniden çıkarır. Oleafly güncellendiğinde, kopyayı bir sonraki başlayışında yeniler.

macOS

Önce Oleafly’yi Uygulamalar klasörüne taşıyın. Disk görüntüsünden çalışan bir kopya, Kur yerine “Önce Oleafly’yi Uygulamalar klasörüne taşıyın” iletisini gösterir.

Komut uygulamaya bir bağlantıdır; bu yüzden Oleafly’yi güncellemek komutu da günceller. Klasör PATH’inizde değilse satır, kabuk profilinize eklemeniz gereken satırı gösterir. command -v oleafly ile denetleyin.

Linux

.deb ve .rpm paketleri, kurduğunuzda oleafly komutunu PATH’inize koyar. Arkasında hiçbir şey olmayan oleafly, uygulamayı açar.

AppImage bir kopya gerektirir; çünkü bir AppImage’ın içindeki dosyalar o kapanınca kaybolur. AppImage’ı daha yenisiyle değiştirdikten sonra satır Güncelle önerir. ~/.local/bin PATH’inizde değilse satır, eklemeniz gereken satırı gösterir.

Çalıştığını denetleyin

oleafly version, uygulama sürümünü ve komutun kullanacağı motorları yazdırır. oleafly doctor motorları, uygulamayı, Git’i, terminal komutunu ve MCP istemcilerinizi denetler ve eksik olan her şey için bir çözüm yazdırır. Proje dışında da çalışır.

Bir proje derleyin

oleafly . geçerli klasörü uygulamada açar. Diğer her komut içinde bulunduğunuz klasörde çalışır; -C ve ardından bir yol, onu başka bir yere yöneltir.

cd ~/papers/thesis
oleafly init --engine typst
oleafly build
oleafly log --diagnostics
oleafly -C ~/papers/review --json build

• oleafly init geçerli klasörü bir proje yapar. --engine, tectonic, latexmk, typst veya markdown değerini alır.
• oleafly new ve ardından bir klasör, --template ile bir şablon kimliği, bir şablondan proje oluşturur. oleafly templates list --all şablonları listeler.
• oleafly build, projenin motorunu ve ayarlarını uygulamayla aynı şekilde kullanır: Oleafly ile gelen Tectonic, Typst ve Pandoc ya da kurduğunuz LaTeX. --main projenin başka bir belgesini derler, --compiler latexmk projeleri için LaTeX derleyicisini seçer, -o PDF’i başka bir yere kopyalar ve --timeout sınırı saniye olarak belirler.
• Uygulamada yerinde açtığınız bir klasör, orada seçtiğiniz motor ve ana belgeyle, uygulamanın kendi derleme klasörüne derlenir.
• Uygulama ve komut aynı projeyi asla aynı anda derlemez: ikincisi birincisini bekler. Başarısız bir derleme son iyi PDF’i korur.
• oleafly watch her kaydettiğinizde yeniden derler. oleafly log --diagnostics hataları ve uyarıları dosya ve satırla listeler, oleafly clean ise derleme çıktısını kaldırır.

Typst’e özgü ayrıntılar için bkz. Typst projeleri.

Bir kodlama ajanından kullanın

Kodlama ajanları, komutun onlara verdiği üç şeyle en iyi çalışır: projenin haritası için oleafly context, okuyabilecekleri sonuçlar için --json ve neyin ters gittiğini söyleyen çıkış kodları. Bir ajanı bağlamanın üç yolu vardır.

oleafly-cli becerisi

Oleafly, oleafly-cli adlı bir beceriyle gelir. Ajana komutları, JSON çıktısını, çıkış kodlarını ve en iyi çalışan döngüyü öğretir: bağlamı okuyun, düzenleyin, derleyin, tanılamaları okuyun, ilk hatayı düzeltin.

Oleafly’nin terminalinde ve başlattığı CLI ajanlarında beceriyi diğerleri gibi seçin. Kendi başınıza çalıştırdığınız bir ajan için Ayarlar → Yapay Zeka Asistanı → Beceriler → Becerileri bu bilgisayardaki diğer ajanlarla paylaş seçeneğini açın. Oleafly o zaman becerilerini, oleafly-cli dahil, diğer kodlama ajanlarının okuduğu klasörlere bağlar; örneğin ~/.claude/skills, ~/.codex/skills ve ~/.agents/skills. oleafly skills path, başka bir klasörü okuyan ajanlar için becerilerin nerede olduğunu yazdırır.

Bir ajanı MCP üzerinden bağlayın

oleafly mcp, standart girdi ve çıktı üzerinden konuşan bir MCP sunucusudur. Uygulama projenizi açıkken çağrıları uygulamanın kendi MCP sunucusuna iletir; böylece ajan uygulamanın her aracını ve onay istemlerinizi alır. Aksi hâlde tek başına çalışır; okuma araçları (proje durumu, proje haritası, dosyalar, arama, günlükler, doctor raporu, atıf arama) ve compile ile. Kopyalanacak bir URL ya da belirteç ve kurulacak bir Node.js yoktur.

En hızlı kurulum, oleafly mcp config --client ve ardından claude-code, claude-desktop, codex, cursor ya da gemini’dir. O istemci için girdiyi yazdırır; sizin için eklenmesini istiyorsanız istemcinin dosyasının yedeğiyle birlikte --write ekleyin. Sonrasında istemciyi yeniden başlatın ya da yeniden bağlayın. Bir projenin içinde projenin ayarlarına yazar; başka yerde kullanıcı ayarlarınıza yazar ve komutun tam yolunu kullanır; çünkü masaüstünden başlattığınız uygulamalar PATH’inizi görmeyebilir.

Claude Code

claude mcp add --scope user oleafly -- oleafly mcp

Bir projenin içinde oleafly mcp config --client claude-code --write, sunucuyu bunun yerine projenin .mcp.json dosyasına ekler.

Claude Desktop

Claude Desktop sunucuları bir proje klasörü olmadan başlatır; bu yüzden girdisi her zaman uygulama üzerinden çalışır: Oleafly’yi projenizle açık tutun. oleafly için tam yolu kullanın. Windows’ta yoldaki her ters eğik çizgiyi ikiye katlayın.

claude_desktop_config.json

{
  "mcpServers": {
    "oleafly": {
      "command": "/usr/local/bin/oleafly",
      "args": ["mcp", "--bridge", "always"]
    }
  }
}

Dosya macOS’ta ~/Library/Application Support/Claude içinde, Windows’ta %APPDATA%\Claude içindedir.

Codex

~/.codex/config.toml

[mcp_servers.oleafly]
command = "oleafly"
args = ["mcp"]
tool_timeout_sec = 300

Cursor

Her proje için ~/.cursor/mcp.json dosyasını, tek bir projenin içinde ise .cursor/mcp.json dosyasını kullanın.

~/.cursor/mcp.json

{
  "mcpServers": {
    "oleafly": {
      "command": "oleafly",
      "args": ["mcp"]
    }
  }
}

Gemini CLI

~/.gemini/settings.json

{
  "mcpServers": {
    "oleafly": {
      "command": "oleafly",
      "args": ["mcp"],
      "timeout": 300000
    }
  }
}

Ajana projenin tamamını verin

oleafly context projeyi haritalar: dosyalarını, yapısını, etiketlerini, atıflarını, eksik dosyalarını, çözülmemiş başvurularını ve son derlemenin sorunlarını. --format md bir isteme yapıştırılacak metin verir; --format json aynı haritayı bir program için verir.

Göndermeden önce bir makaleyi denetleyin

oleafly check, projede Preflight denetimlerini çalıştırır ve Preflight paneliyle aynı sonuçları verir: başvurular, atıflar, etiketler, eksik dosyalar, kaynakça alanları, şekiller ve kör hakemlik için anonimlik. Derlenmiş PDF’e ihtiyaç duyan denetimler son derlemeyi kullanır.

oleafly lint, LaTeX ve BibTeX denetimlerini ve, onu içeren derlemelerde, yazım ve dilbilgisi denetimini çalıştırır. --fix, uygulanması güvenli olan düzeltmeleri uygular.

İkisi de --format human, json veya sarif değerlerini alır; --exit-code ise sorun buldukları zaman 9 koduyla çıkmalarını sağlar. SARIF, GitHub’ınki gibi kod tarama hizmetleriyle çalışır: raporu oleafly check --format sarif -o preflight.sarif ile yazın, upload-sarif eylemiyle yükleyin; her bulgu pull request içinde kendi satırında görünür.

Çevrimiçi bir LaTeX hizmetiyle eşitleyin

oleafly remote, çevrimiçi LaTeX hizmeti hesabınızdaki projeleri indirir ve bir klasörü onlardan biriyle, uygulamanın kullandığı aynı birleştirmeyle eşitler tutar.

Oturum açın

Oturum açma bilgileri uygulamanın şifreli deposunda durur; bu yüzden uygulamada yapılan bir oturum açma komut satırında da, komut satırında yapılan uygulamada da çalışır.

• oleafly auth login online --with-token, hizmetin hesap ayarlarından aldığınız bir Git belirtecini kaydeder. Bağlamak ve eşitlemek için bir belirteç gerekir.
• oleafly auth login online --from-browser firefox, projeleri listelemek ve indirmek için oturum açma bilginizi bu bilgisayardaki bir tarayıcıdan kopyalar. Firefox her sistemde çalışır; Chrome, Edge ve Brave macOS’ta çalışır. --cookie-stdin bunun yerine bir oturum çerezini okur.
• oleafly auth login git --host https://gitlab.com, bir Git barındırıcısı için belirteç kaydeder.
• oleafly auth status, her oturum açma bilgisini ve nereden geldiğini, hiçbir gizli bilgiyi göstermeden listeler.
• oleafly auth logout bir oturum açma bilgisini kaldırır.

Belirteçleri kabuk geçmişinizin dışında tutun

Belirteçler standart girdiden verilir, örneğin oleafly auth login online --with-token < token.txt; asla bağımsız değişken olarak verilmez. Bir terminalde komut, yazdığınızı göstermeden onları ister. oleafly auth token betikler için kayıtlı bir belirteci yazdırır; bu yüzden çıktısına bir parola gibi davranın.

Projeleri içe aktarın ve eşitleyin

oleafly remote list
oleafly remote import 64a1f0c2e5b7 --into ~/papers
cd ~/papers/thesis
oleafly remote link
oleafly remote sync

• oleafly remote import projeleri yeni klasörlere indirir. Her hesapla çalışır.
• oleafly remote link, bir klasörü çevrimiçi projesine hizmetin Git tümleştirmesi üzerinden bağlar; bunun için bir Git belirteci gerekir.
• oleafly remote sync, çevrimiçi değişiklikleri klasöre birleştirir ve sizinkileri gönderir. --dry-run nelerin değişeceğini gösterir, --no-push ise göndermeden birleştirir.
• Bir dosya iki tarafta da değiştiyse eşitleme hiçbir şey yazmaz ve 8 koduyla çıkar. Onu her dosya için --resolve ve dosyanın yolunu izleyen =local ya da =remote ile yeniden çalıştırın.
• oleafly remote diff nelerin farklı olduğunu gösterir; --exit-code ile dosyalar farklıysa 9, çakışıyorsa 8 koduyla çıkar. --latexdiff --pdf, TeX dağıtımınızdaki latexdiff’i kullanarak değişikliklerinizin işaretli bir PDF’ini derler.
• oleafly remote status, oleafly remote unlink ve oleafly remote open bağlantıyı gösterir, kaldırır ve projeyi tarayıcınızda açar.

Bir Oleafly sunucusuyla çalışın

oleafly server sign-in ve ardından sunucunun adresi, komut satırında tarayıcınızda onayladığınız bir kodla oturum açar. Komut satırı, sunucuda uygulamadan ayrı, kendi başına bir cihazdır.

• oleafly server status ve oleafly server projects, sunucularınızı ve paylaşılan projeleri gösterir.
• oleafly server share, bir projenin bağlantısını gösterir ve bağlantı paylaşımını ile yorumları açar ya da kapatır.
• oleafly server members, bir projedeki kişileri listeler ve onları ekler, kaldırır ya da değiştirir. Paylaşımı ve üyeleri yalnızca sahibi değiştirebilir.
• oleafly server comments, yorumları listeler, ekler, yanıtlar ve çözümler. Hemen gönderilemeyen bir yorum saklanır ve bir sonraki sefer gönderilir.

Bir projeyi ilk kez paylaşmak uygulamada yapılır. Bkz. Canlı iş birliği.

Oleafly ajanını bir terminalden çalıştırın

oleafly ask, hiçbir şeyi değiştirmeden proje hakkındaki bir soruyu yanıtlar. oleafly agent run bir görevi yapar.

oleafly ask "Which sections cite Smith 2021?"
oleafly agent run --allow write "Fix the overfull boxes in chapter 3"

• Ajan projeyi her zaman okuyabilir. --allow, write, commands veya network ekler ve izin vermediğiniz her şeyi reddeder. Hiçbir zaman durup bir soru sormaz.
• Değişiklikler önce .oleafly/agent-runs/ içindeki bir inceleme klasörüne gider. oleafly agent apply ve ardından o klasör, onları projeye yazar; çalıştırmadaki --apply ise onları hemen yazar.
• Sağlayıcı, model ve çaba uygulamanın ayarlarından ya da --provider, --model ve --effort seçeneklerinden gelir. Anahtar, sağlayıcının kendi ortam değişkeninden, örneğin ANTHROPIC_API_KEY, ya da uygulamanın şifreli deposundan gelir.
• --json, çalıştırma bittiğinde tek bir sonuç yazdırır; --events ise çalışırken her olay için bir JSON satırı ekler.

Çıktıktan sonra araştırma görevlerini çalışır tutun

Bir araştırma görevini Oleafly kapalıyken çalışmaya devam et olarak işaretleyin. Çıktığınızda küçük bir arka plan yardımcısı bu görevleri devralır ve deney çalıştırmaları sürer. Onayınızı gerektiren bir adım görevi duraklatır ve bir bildirim gönderir. Oleafly’yi yeniden açtığınızda görevleri geri alır ve neler olduğunu gösterir. Bunu kapatın ya da yardımcıyı oturum açtığınızda başlatın; Ayarlar → Araştırma → Arka plan görevleri altında. oleafly daemon status yardımcının ne yaptığını gösterir.

Komut başvurusu

Her komut seçeneklerini --help ile açıklar. Tam başvuru depodadır: docs/cli.md (yeni sekmede açılır).

Projeler ve derlemeler

Komut	Ne yapar
oleafly open	Bir klasörü uygulamada açar (geçerli klasör için oleafly .)
oleafly init	Geçerli klasörü bir proje yapar
oleafly new	Bir proje oluşturur; bir şablon adlandırırsanız şablondan
oleafly templates	Şablonları listeler ve birini gösterir
oleafly build	Projeyi derler
oleafly watch	Her kaydedişte yeniden derler
oleafly clean	Derleme çıktısını kaldırır
oleafly log	Son derlemenin günlüğünü ya da sorunlarını gösterir
oleafly doctor	Motorları, uygulamayı ve kurulumunuzu denetler
oleafly version	Sürümü ve kullanılan motorları gösterir
oleafly project info	Projenin ayarlarını gösterir
oleafly projects list	Uygulamanın projelerini listeler
oleafly config	Proje ve uygulama ayarlarını okur ve ayarlar

Yazım ve kaynaklar

Komut	Ne yapar
oleafly cite	Bir DOI, arXiv kimliği, ISBN ya da PubMed kimliği için BibTeX yazdırır; --add onu kaynakçaya ekler
oleafly literature	OpenAlex, Semantic Scholar, Crossref, arXiv ve PubMed’de arar
oleafly bib check	Hiçbir gerçek kayıtla eşleşmeyen girdileri bulur
oleafly bib clean	Atıf anahtarlarını düzeltir ve yinelenenleri kaldırır; --apply değişiklikleri yazar
oleafly stats	Sözcükleri, başlıkları, şekilleri ve denklemleri sayar
oleafly synctex	Bir kaynak satırını PDF’e ve geri eşler
oleafly export	Belgeyi Word, HTML, Markdown, EPUB ve daha fazlasına dışa aktarır
oleafly convert	Bir dosyayı başka bir biçime dönüştürür
oleafly typst	Typst sürümlerini listeler, kurar ve kaldırır
oleafly checkpoint	Uygulamanın kontrol noktalarını listeler, karşılaştırır ve kopyalar

Ajanlar ve otomasyon

Komut	Ne yapar
oleafly context	Projeyi bir kişi ya da bir ajan için haritalar
oleafly mcp	MCP sunucusunu çalıştırır; mcp config bir istemciyi kurar
oleafly skills	Becerileri listeler ve nerede olduklarını yazdırır
oleafly ask	Proje hakkındaki bir soruyu yanıtlar
oleafly agent	Oleafly ajanını bir görev üzerinde çalıştırır
oleafly daemon	Görevleri sürdüren yardımcıyı çalıştırır ve denetler

Denetimler

Komut	Ne yapar
oleafly check	Preflight denetimlerini çalıştırır
oleafly lint	LaTeX, BibTeX, yazım ve dilbilgisi denetimlerini çalıştırır

Hesaplar ve eşitleme

Komut	Ne yapar
oleafly auth	Çevrimiçi LaTeX hizmetlerinde, Oleafly sunucularında ve Git barındırıcılarında oturum açar
oleafly remote	Çevrimiçi projeleri içe aktarır, bağlar ve eşitler
oleafly server	Oleafly sunucularıyla çalışır: projeler, paylaşım, üyeler, yorumlar

Kabuk ve yardım

Komut	Ne yapar
oleafly completions	bash, zsh, fish, PowerShell veya elvish için kabuk tamamlamalarını yazdırır
oleafly man	Kılavuz sayfasını yazdırır
oleafly help exit-codes	Çıkış kodlarını açıklar

Her komutun seçenekleri

Seçenek	Ne yapar
-C ve ardından bir yol	Komutu başka bir proje klasöründe çalıştırır
--json	Tek bir JSON sonucu yazdırır
--events	Sonuçtan önce ilerlemeyi JSON satırları olarak yazdırır
--quiet	Yalnızca sonucu yazdırır
--log	Derleyici günlüğünü none, tail ya da full olarak gösterir
--no-input	Hiçbir zaman soru sormaz
--color	Rengi auto, always ya da never olarak kullanır

Betikler için çıktı

JSON çıktısı

--json ile her komut tek bir JSON nesnesi yazdırır: schema_version, ok, command, komutun kendi alanları ve warnings. Bir komut başarısız olduğunda error, bir kind, kararlı bir code ve bir message tutar. İşe yaradıklarında ayrıca bir hint, details ve yeniden denemek işe yarayabilecekse "retryable": true içerir. Bir alana güvenmeden önce schema_version değerini denetleyin.

{
  "schema_version": 1,
  "type": "result",
  "ok": false,
  "command": "remote sync",
  "error": {
    "kind": "conflict",
    "code": "remote.conflicts",
    "message": "2 files changed both here and online.",
    "hint": "Pick a side with --resolve PATH=local or --resolve PATH=remote, then sync again.",
    "details": { "conflicts": ["main.tex", "refs.bib"] }
  },
  "warnings": []
}

--events, sonuçtan önce her ilerleme olayı için bir JSON satırı ekler.

Çıkış kodları

oleafly help exit-codes aynı tabloyu yazdırır.

Kod	Anlamı
0	Çalıştı
1	Oleafly’nin içinde bir şeyler ters gitti
2	Komut yanlış kullanıldı ya da devam etmek için --yes gerekiyor
3	Proje eksik ya da geçersiz, ya da bir yol projenin dışını gösteriyor
4	Gereken bir araç ya da Oleafly uygulaması kurulu değil
5	Derleme başarısız oldu
6	Oturum açmanız gerekiyor
7	Ağ başarısız oldu
8	Başka bir şey projeyi tutuyor ya da bir eşitlemede çakışmalar var
9	Bir denetim sorun buldu
130	Ctrl+C’ye bastınız

Sorular, renk ve günlükler

Komut, terminal yoksa hiçbir zaman soru sormaz. --no-input soruları kapatır, bir CI değişkeni de öyle; evet gerektiren bir komut bu durumda 2 çıkış koduyla başarısız olur ve --yes ister. NO_COLOR ya da --color never rengi kapatır. Projenin dışına çıkacak yollar reddedilir.

Ortam değişkenleri

Değişken	Kullanım
OLEAFLY_DATA_DIR	Oleafly’nin veri klasörü, ~/.oleafly olmadığında
OLEAFLY_TECTONIC, OLEAFLY_LATEXMK, OLEAFLY_TYPST, OLEAFLY_PANDOC	Oleafly’nin bulduğu yerine kullanılacak bir derleyici
OLEAFLY_APP	oleafly open komutunun başlattığı Oleafly uygulaması
OLEAFLY_ONLINE_GIT_TOKEN	Çevrimiçi LaTeX hizmeti için, kayıtlı olanın yerine kullanılan bir Git belirteci
OLEAFLY_CLI	Oleafly’nin başlattığı programlar için ayarlanır: komutun tam yolu
CI	Ayarlandığında komut hiçbir zaman soru sormaz
NO_COLOR	Ayarlandığında çıktıda renk olmaz

Sorun giderme

Gördüğünüz	Deneyebileceğiniz
oleafly bulunamıyor	Yeni bir terminal açın. Sonra Windows’ta Get-Command oleafly ile, macOS ve Linux’ta command -v oleafly ile denetleyin ve Ayarlar’ın gösterdiği satırı kabuk profilinize ekleyin
oleafly doctor eksik bir motor bildiriyor	doctor’ın yazdırdığı komutla kurun ya da projeyi uygulamada bir kez açın
Bir MCP istemcisi sunucuyu başlatamıyor	Yapılandırılmış komutu bir terminalde çalıştırın, oleafly mcp config çıktısındaki tam yolu kullanın ve oleafly doctor çalıştırın
6 çıkış kodu	oleafly auth status çalıştırın, sonra yeniden oturum açın
Bir eşitleme sırasında 8 çıkış kodu	Eşitlemeyi, listelediği her dosya için --resolve ile yeniden çalıştırın
macOS’ta Ayarlar “Önce Oleafly’yi Uygulamalar klasörüne taşıyın” diyor	Uygulamayı taşıyın, Uygulamalar’dan açın, sonra Kur’u seçin

İlgili sayfalar

• Typst projeleri
• MCP ile bağlanın
• CLI ajanları
• Preflight denetimleri
• Araştırma görevleri