# Komut satırı aracı

oleafly komutunu Windows, macOS veya Linux'ta kurun, projeleri bir terminalden ya da CI'dan derleyin ve denetleyin, çevrimiçi bir LaTeX hizmetiyle eşitleyin ve kodlama ajanlarını onun MCP sunucusu ve becerisi üzerinden bağlayın.

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:

```powershell
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.

```sh
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](/docs/typst/#build-from-the-command-line).

## 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](/docs/mcp/) 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

```sh
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.

```json title="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

```toml title="~/.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.

```json title="~/.cursor/mcp.json"
{
  "mcpServers": {
    "oleafly": {
      "command": "oleafly",
      "args": ["mcp"]
    }
  }
}
```

#### Gemini CLI

```json title="~/.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](/docs/preflight/) ç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.

:::caution[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

```sh
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](/docs/collaboration/).

## 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.

```sh
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](/docs/research-tasks/) **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](https://github.com/Oleafly/Oleafly/blob/main/docs/cli.md).

### 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.

```json
{
  "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](/docs/typst/#build-from-the-command-line)
- [MCP ile bağlanın](/docs/mcp/)
- [CLI ajanları](/docs/cli-agents/)
- [Preflight denetimleri](/docs/preflight/)
- [Araştırma görevleri](/docs/research-tasks/)