> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitflare.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

> Kabuk betiklerinde, CI/CD boru hatlarında ve ajana dayalı otomasyonda OrbitFlare CLI kullanın. Her komut makine tarafından okunabilir çıktı için --json destekler.

[OrbitFlare CLI](/tr/cli), RPC sorgularını, YAML yapılandırmalı gRPC ve Jetstream akışını, proje iskeletini ve hesap yönetimini saran tek ikilidir. Ajan ve otomasyon iş akışları için kritik özellik `--json`dır: her komut `jq`, kabuk boruları, GitHub Actions ve cron işleriyle düzgün birleşen yapılandırılmış çıktı üretir.

<Tip>
  Claude Code, Cursor veya diğer MCP ana bilgisayarlarında etkileşimli yapay zekâ iş akışları için [MCP sunucusunu](/tr/agents/mcp) tercih edin. CLI, belirleyici çıkış kodları ve ayrıştırılabilir çıktı istediğiniz kabuk tabanlı otomasyon için daha uygundur.
</Tip>

## Kurulum

```bash theme={null}
cargo install orbitflare           # Rust 1.85+ gerekir
orbitflare --version
```

Kurulum alternatifleri, kimlik doğrulama yöntemleri ve tam komut yüzeyi için [tam CLI referansına](/tr/cli) bakın.

## Başsız kurulum

Etkileşimsiz ortamlar (CI, konteynerler, betikler) için doğrudan API anahtarıyla kimlik doğrulayın; tarayıcı akışı gerekmez:

```bash theme={null}
orbitflare auth login --x-orbit-key "$ORBITFLARE_API_KEY"
orbitflare config set rpc.url "$ORBITFLARE_RPC_URL"
orbitflare config set grpc.url "$ORBITFLARE_GRPC_URL"
orbitflare config set jetstream.url "$ORBITFLARE_JETSTREAM_URL"
orbitflare ping --json
```

Kimlik bilgileri varsayılan olarak işletim sistemi anahtarlığında saklanır. Anahtarlığı olmayan konteynerlerde `ORBITFLARE_CONFIG_DIR` yazılabilir bir yola ayarlayın; CLI dosya tabanlı yapılandırmaya düşer.

## JSON çıktısı

Her komut `--json` destekler:

```bash theme={null}
$ orbitflare rpc slot --json
{"slot": 312456789}

$ orbitflare rpc balance Gh9ZwEm... --json
{"address": "Gh9ZwEm...", "lamports": 12500000000, "sol": 12.5}
```

`jq` ile tek satırlıklar oluşturun:

```bash theme={null}
# Yalnızca slotu yazdır
orbitflare rpc slot --json | jq -r '.slot'

# Bakiye 1 SOL’un altına düşerse uyar
SOL=$(orbitflare rpc balance "$WALLET" --json | jq -r '.sol')
if (( $(echo "$SOL < 1" | bc -l) )); then
  echo "Balance low: $SOL SOL"
  exit 1
fi
```

## YAML yapılandırmaları ile akış

CLI, Jetstream ve Yellowstone gRPC için bildirimsel bir YAML yapılandırması ile kod gerektirmeden akış yapar:

```yaml theme={null}
# pump-trades.yaml
transactions:
  pump_trades:
    account_include:
      - "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P"

reconnect:
  initial_delay_ms: 100
  max_delay_ms: 30000
  multiplier: 2.0
  max_retries: 0
```

Çalıştırma (Jetstream veya Yellowstone gRPC):

```bash theme={null}
orbitflare jet --config pump-trades.yaml | your-indexer
orbitflare grpc --config pump-trades.yaml | your-indexer
```

<Tip>
  YAML’ı MCP destekli bir ajandan oluşturun. [MCP sunucusu](/tr/agents/mcp) `subscribeTransactions` aracı, doğal dil açıklamasından CLI’ye hazır bir yapılandırma üretir.
</Tip>

## Betikleme desenleri

### Son imzaları kuyruklayıp işleme

```bash theme={null}
orbitflare rpc history "$WALLET" --limit 50 --json \
  | jq -r '.[].signature' \
  | while read sig; do
      orbitflare rpc tx "$sig" --json > "txs/$sig.json"
    done
```

### CI sağlık kontrolü

```yaml theme={null}
# .github/workflows/rpc-health.yml
name: OrbitFlare RPC health
on:
  schedule:
    - cron: '*/15 * * * *'
jobs:
  ping:
    runs-on: ubuntu-latest
    steps:
      - uses: actions-rs/toolchain@v1
        with: { toolchain: stable }
      - run: cargo install orbitflare
      - run: orbitflare auth login --x-orbit-key ${{ secrets.ORBITFLARE_API_KEY }}
      - run: orbitflare config set rpc.url ${{ secrets.ORBITFLARE_RPC_URL }}
      - run: orbitflare ping --json
```

### Ajanla projeyi iskeletleme

CLI yaygın Solana projeleri için şablonlar içerir. Bir ajan bunları listeleyip tek seferde kurabilir:

```bash theme={null}
orbitflare template --list --json
orbitflare template --install solana-copy-trader --dir ./bot
```

## Profiller

Her seferinde yeniden kimlik doğrulamadan hesaplar veya ortamlar arasında geçin:

```bash theme={null}
orbitflare auth login --profile prod --x-orbit-key "$PROD_KEY"
orbitflare auth login --profile dev  --x-orbit-key "$DEV_KEY"

orbitflare auth switch --profile prod
orbitflare auth status --json
```

## Kaynak

* CLI deposu: [github.com/orbitflare/orbit-cli](https://github.com/orbitflare/orbit-cli)
* Tam referans: [CLI dokümantasyonu](/tr/cli)