GitHub

kodine'u GitHub sorunlarında ve çekme isteklerinde çalıştırın.

kodine, GitHub iş akışınıza entegre olur. Bir yorumda /kodine ya da /oc yazmanız yeterli; kodine görevi GitHub Actions çalıştırıcınızın içinde yerine getirir.

Özellikler

Sorunları sınıflandırın: kodine’dan bir sorunu incelemesini ve size özetlemesini isteyebilirsiniz.
Düzeltme ve geliştirme: kodine’a bir hatayı gidertebilir ya da yeni bir özellik yazdırabilirsiniz. Yeni bir dal oluşturur ve tüm değişiklikleri içeren bir PR açar.
Güvenli çalışma: kodine tamamen sizin GitHub çalıştırıcılarınızın içinde yürütülür.

Kurulum

GitHub deposu içindeki bir projede şu komutu çalıştırın:

kodine github install

Komut; GitHub uygulamasını kurma, iş akışını oluşturma ve gizli değerleri tanımlama adımlarında size rehberlik eder.

Manuel Kurulum

İsterseniz kurulumu elinizle de yapabilirsiniz.

GitHub uygulamasını kurun

github.com/apps/kodine-agent adresini açın ve uygulamanın hedef depoya kurulu olduğunu doğrulayın.

İş akışını ekleyin

Aşağıdaki iş akışı dosyasını deponuzda .github/workflows/kodine.yml konumuna kaydedin. Kullandığınız model için uygun env değerlerini ve gerekli API anahtarlarını tanımlamayı unutmayın.

name: kodine

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  kodine:
    if: |
      contains(github.event.comment.body, '/oc') ||
      contains(github.event.comment.body, '/kodine')
    runs-on: ubuntu-latest
    permissions:
      id-token: write
    steps:
       - name: Checkout repository
         uses: actions/checkout@v6
         with:
           fetch-depth: 1
           persist-credentials: false

       - name: Run Kodine
        uses: kodine-ai/kodine/github@latest
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        with:
          model: anthropic/claude-sonnet-4-20250514
          # share: true
          # github_token: xxxx

API anahtarlarını gizli değer olarak ekleyin

Kuruluşunuzun ya da projenizin ayarlarında sol menüden Secrets and variables bölümünü açıp Actions öğesini seçin ve gereken API anahtarlarını buraya ekleyin.

Yapılandırma

model: kodine’un kullanacağı model. provider/model biçiminde yazılır. Bu alan zorunludur.
agent: Kullanılacak agent. Birincil agent’lardan biri olmalıdır. Yapılandırmadaki default_agent değerine, o da yoksa "build" değerine döner.
share: Oturumun paylaşıma açılıp açılmayacağı. Herkese açık depolarda varsayılan olarak true değerini alır.
prompt: Varsayılan istemin yerine geçen özel istem. kodine’un görevleri nasıl ele alacağını kişiselleştirmek için kullanın.
token: Yorum yazma, commit oluşturma ve çekme isteği açma gibi işlemler için isteğe bağlı bir GitHub erişim belirteci. Belirtmezseniz kodine, kodine GitHub Uygulaması’nın kurulum erişim belirtecini kullanır; bu durumda commit’ler, yorumlar ve çekme istekleri uygulama tarafından yapılmış gibi görünür.

Dilerseniz kodine GitHub Uygulaması’nı kurmadan, GitHub Actions çalıştırıcısının yerleşik GITHUB_TOKEN mekanizmasını da kullanabilirsiniz. Bu durumda işinizde gerekli izinlerin tanımlı olduğundan emin olun:
```
permissions:
  id-token: write
  contents: write
  pull-requests: write
  issues: write
```
İsterseniz kişisel erişim belirteci (PAT) de kullanabilirsiniz.

Desteklenen Olaylar

kodine şu GitHub olaylarıyla tetiklenebilir:

Olay Tipi	Tetikleyici	Detaylar
`issue_comment`	Bir soruna ya da PR’a yorum yazılması	Yorumda `/kodine` ya da `/oc` geçirin. kodine bağlamı okur; dal oluşturabilir, PR açabilir ya da yanıt yazabilir.
`pull_request_review_comment`	Bir PR’da belirli kod satırlarına yorum yazılması	Kod incelerken `/kodine` ya da `/oc` geçirin. kodine dosya yolunu, satır numaralarını ve diff içeriğini otomatik olarak alır.
`issues`	Sorun açılması ya da düzenlenmesi	Sorunlar oluşturulduğunda ya da güncellendiğinde kodine’u kendiliğinden tetikleyin. `prompt` girdisi zorunludur.
`pull_request`	PR açılması ya da güncellenmesi	PR’lar açıldığında, senkronize edildiğinde ya da yeniden açıldığında kodine’u otomatik çalıştırın. Otomatik kod incelemeleri için idealdir.
`schedule`	Cron tabanlı zamanlama	kodine’u belirli bir programa göre çalıştırın. `prompt` girdisi zorunludur. Çıktı günlüklere ve PR’lara yazılır (yorum yapılacak bir konu yoktur).
`workflow_dispatch`	GitHub arayüzünden elle tetikleme	Actions sekmesinden kodine’u istediğiniz zaman başlatın. `prompt` girdisi zorunludur. Çıktı günlüklere ve PR’lara yazılır.

Zamanlama Örneği

Otomatik görevler için kodine’u bir zamanlamaya bağlayabilirsiniz:

name: Scheduled Kodine Task

on:
  schedule:
    - cron: "0 9 * * 1" # Her Pazartesi saat 09:00 UTC

jobs:
  kodine:
    runs-on: ubuntu-latest
    permissions:
      id-token: write
      contents: write
      pull-requests: write
      issues: write
    steps:
      - name: Checkout repository
        uses: actions/checkout@v6
        with:
          persist-credentials: false

      - name: Run Kodine
        uses: kodine-ai/kodine/github@latest
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        with:
          model: anthropic/claude-sonnet-4-20250514
          prompt: |
            Review the codebase for any TODO comments and create a summary.
            If you find issues worth addressing, open an issue to track them.

Zamanlanmış olaylarda talimatların okunacağı bir yorum bulunmadığından prompt girdisi zorunludur. Zamanlanmış iş akışları, izin denetimi yapılabilecek bir kullanıcı bağlamı olmadan çalışır; bu yüzden kodine’un dal ya da PR oluşturmasını bekliyorsanız iş akışına contents: write ve pull-requests: write izinlerini vermeniz gerekir.

Çekme İsteği Örneği

PR’ları açıldıklarında ya da güncellendiklerinde otomatik olarak inceleyin:

name: kodine-review

on:
  pull_request:
    types: [opened, synchronize, reopened, ready_for_review]

jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      id-token: write
      contents: read
      pull-requests: read
      issues: read
    steps:
      - uses: actions/checkout@v6
        with:
          persist-credentials: false
      - uses: kodine-ai/kodine/github@latest
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          model: anthropic/claude-sonnet-4-20250514
          use_github_token: true
          prompt: |
            Review this pull request:
            - Check for code quality issues
            - Look for potential bugs
            - Suggest improvements

pull_request olaylarında prompt verilmezse kodine varsayılan olarak çekme isteğini inceler.

Sorun Sınıflandırma Örneği

Yeni açılan sorunları otomatik olarak sınıflandırın. Bu örnekte spam’i azaltmak amacıyla 30 günden yeni hesaplar elenir:

name: Issue Triage

on:
  issues:
    types: [opened]

jobs:
  triage:
    runs-on: ubuntu-latest
    permissions:
      id-token: write
      contents: write
      pull-requests: write
      issues: write
    steps:
      - name: Check account age
        id: check
        uses: actions/github-script@v7
        with:
          script: |
            const user = await github.rest.users.getByUsername({
              username: context.payload.issue.user.login
            });
            const created = new Date(user.data.created_at);
            const days = (Date.now() - created) / (1000 * 60 * 60 * 24);
            return days >= 30;
          result-encoding: string

      - uses: actions/checkout@v6
        if: steps.check.outputs.result == 'true'
        with:
          persist-credentials: false

      - uses: kodine-ai/kodine/github@latest
        if: steps.check.outputs.result == 'true'
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        with:
          model: anthropic/claude-sonnet-4-20250514
          prompt: |
            Review this issue. If there's a clear fix or relevant docs:
            - Provide documentation links
            - Add error handling guidance for code examples
            Otherwise, do not comment.

issues olaylarında, talimatların alınacağı bir yorum olmadığı için prompt girdisi zorunludur.

Özel istemler

Varsayılan istemi geçersiz kılarak kodine’un davranışını iş akışınıza göre uyarlayın.

- uses: kodine-ai/kodine/github@latest
  with:
    model: anthropic/claude-sonnet-4-5
    prompt: |
      Review this pull request:
      - Check for code quality issues
      - Look for potential bugs
      - Suggest improvements

Bu yöntem; projenize özgü inceleme ölçütlerini, kod yazım standartlarını ya da odaklanılmasını istediğiniz alanları tanımlamak için kullanışlıdır.

Örnekler

kodine’u GitHub’da nasıl kullanabileceğinize dair birkaç örnek aşağıda.

Bir sorunu açıklatma

GitHub’daki soruna şu yorumu ekleyin.
```
/kodine explain this issue
```
kodine, tüm yorumlar da dahil olmak üzere başlığın tamamını okur ve net bir açıklamayla yanıt verir.
Bir sorunu düzeltme

Bir GitHub sorununa şunu yazın:
```
/kodine fix this
```
kodine yeni bir dal açar, değişiklikleri uygular ve bunları içeren bir PR oluşturur.
PR incelemesi ve değişiklik yapma

Bir GitHub PR’ına şu yorumu bırakın.
```
Delete the attachment from S3 when the note is removed /oc
```
kodine istenen değişikliği gerçekleştirir ve aynı PR’a işler.
Belirli kod satırlarını inceleme

PR’ın “Files” sekmesinde doğrudan kod satırlarına yorum bırakabilirsiniz. kodine; dosyayı, satır numaralarını ve diff bağlamını kendiliğinden algılayarak isabetli yanıtlar üretir.
```
[Files sekmesinde belirli satırlara yorum yapın]
/oc add error handling here
```
Belirli satırlara yorum yapıldığında kodine şunları görür:
- İncelenen dosyanın tamamı
- İlgili kod satırları
- Çevresindeki diff bağlamı
- Satır numarası bilgisi
Böylece dosya yolunu ya da satır numarasını elle yazmadan çok daha hedefli isteklerde bulunabilirsiniz.