SETH

Terminalde çalışan otonom yapay zeka kodlama ve siber güvenlik ajanı.
Türkçe arayüz · 12 AI sağlayıcı · 60+ araç · CTF motoru · Kalıcı bellek

Web Sitesi · Kurulum · Komutlar · Sağlayıcılar

SETH Nedir?

SETH, terminalde çalışan Türkçe arayüzlü bir yapay zeka ajanıdır. Kod yazar, test çalıştırır, güvenlik taraması yapar, CTF çözer ve raporlar. Siz yönlendirin, SETH uygulasın.

Temel döngü: Araştır → Planla → Uygula → Raporla

flowchart TD
    A([Kullanıcı İsteği]) --> B[Araştır\ngrep · glob · git · web]
    B --> C[Planla\nRisk analizi · adım sırası]
    C --> D{Plan Modu\nAçık?}
    D -- Evet --> E[/Kullanıcı Onayı/]
    D -- Hayır --> F
    E -- Onaylandı --> F[Uygula\nfile_edit · shell · araçlar]
    E -- Reddedildi --> C
    F --> G{Görev\nTamamlandı?}
    G -- Hayır, devam --> F
    G -- Evet --> H[Raporla\nözetle · dışa aktar]
    H --> I[(Hafızaya Kaydet\nauto-memory)]
    I --> J{Yeni\nGörev?}
    J -- Evet --> B
    J -- Hayır --> K([Bitti])

    style A fill:#b91c1c,color:#fff,stroke:none
    style K fill:#18181b,color:#a1a1aa,stroke:#3f3f46
    style I fill:#1a1a2e,color:#a1a1aa,stroke:#3f3f46
    style D fill:#18181b,color:#fafafa,stroke:#3f3f46
    style G fill:#18181b,color:#fafafa,stroke:#3f3f46
    style J fill:#18181b,color:#fafafa,stroke:#3f3f46
    style E fill:#1a0a0a,color:#fca5a5,stroke:#b91c1c

sen: "auth middleware'ini JWT'ye geçir ve testleri yaz"

SETH: src/ taranıyor... middleware.ts bulundu
      Değişiklik planı hazırlandı (3 dosya)
      [Onaylıyor musunuz? e/h]
      file_edit: middleware.ts ✓
      file_write: middleware.test.ts ✓
      shell: npm test → 12/12 geçti ✓

Neden SETH?

Kurulum

npm install -g github:MustafaKemal0146/seth

seth                                    # Etkileşimli mod
seth --provider groq                    # Belirli sağlayıcı ile başlat
seth -p "bu projeyi özetle"            # Tek seferlik (headless) mod
seth --auto -p "testleri çalıştır"     # Onaysız otonom mod

Hızlı Başlangıç

# 1. API anahtarınızı ayarlayın (ya da Ollama ile ücretsiz başlayın)
export ANTHROPIC_API_KEY=sk-ant-...

# 2. Projenize gidin
cd benim-projem/

# 3. Başlatın
seth

# Ortam sağlığını kontrol edin
/doktor

Desteklenen AI Sağlayıcıları

Başlatırken: seth --provider groq · Çalışırken: /sağlayıcı groq

Komutlar

Bilgi & Analiz

Bellek & Oturum

Ayarlar

Ajan & Skill

Araçlar & Sistem

CTF & Siber Güvenlik

Kısayollar

Yapılandırma

Ortam Değişkenleri

export ANTHROPIC_API_KEY=sk-ant-xxxxx
export OPENAI_API_KEY=sk-xxxxx
export GEMINI_API_KEY=AIzaxxxxx
export GROQ_API_KEY=gsk_xxxxx
export DEEPSEEK_API_KEY=sk-xxxxx
export MISTRAL_API_KEY=xxxxx
export XAI_API_KEY=xai-xxxxx
export OPENROUTER_API_KEY=sk-or-xxxxx
# Ollama ve LM Studio için API anahtarı gerekmez

~/.seth/settings.json

{
  "defaultProvider": "ollama",
  "defaultModel": "qwen2.5-coder:7b",
  "providers": {
    "ollama":   { "baseUrl": "http://localhost:11434", "model": "qwen2.5-coder:7b" },
    "groq":     { "apiKey": "gsk_xxx", "model": "llama-3.3-70b-versatile" },
    "deepseek": { "apiKey": "sk-xxx",  "model": "deepseek-v4-flash" },
    "claude":   { "apiKey": "sk-ant-xxx", "model": "claude-sonnet-4-20250514" }
  }
}

Proje Talimatları (Otomatik Yükleme)

Çalışma dizininde aşağıdaki dosyalar varsa sistem istemine otomatik eklenir:

Özellikler

Kalıcı Bellek

SETH iki katmanlı bellek sistemi kullanır:

Manuel Bellek (~/.seth/memory/):

/hafıza ekle user    "Kıdemli TypeScript geliştiricisiyim"
/hafıza ekle project "Bu proje Next.js + Prisma + PostgreSQL kullanıyor"
/hafıza ekle feedback "Commit mesajları Conventional Commits formatında olsun"

Otomatik Bellek (~/.seth/auto-memory/):
Konuşma sonunda AI önemli bilgileri otomatik kaydeder. Bir sonraki oturumda proje tercihleri, teknik kararlar ve bulgular hazır olur.

Skill Sistemi

~/.seth/skills/ klasörüne Markdown dosyaları ekleyerek özel iş akışları oluştur:

---
name: güvenlik-tarama
description: Projeyi güvenlik açıkları için tara
---

Aşağıdaki projeyi güvenlik açıkları için analiz et:
{{params}}

Kontrol listesi:
- SQL injection noktaları
- Kimlik doğrulama zafiyetleri
- Hassas veri ifşası

/skill güvenlik-tarama src/api/

Yerleşik skill'ler: review · refactor · explain

Multi-Agent Koordinatör

Büyük görevleri paralel alt ajanlara böl:

/koordinator "projenin tüm API endpoint'lerini test et, güvenlik açıklarını bul ve rapor oluştur"

Koordinatör görevi 2-5 bağımsız alt göreve böler, hepsini eş zamanlı çalıştırır ve sonuçları birleştirir.

Güvenlik Profilleri

/güvenlik safe       # Sadece okuma işlemleri
/güvenlik standard   # Varsayılan — kritik işlemler onay ister
/güvenlik pentest    # Tam araç seti: nmap, sqlmap, nuclei, ffuf...

İzin seviyeleri:

/yetki full    # Onaysız çalışır
/yetki normal  # Kritik işlemler onay ister (varsayılan)
/yetki dar     # Her işlem onay ister

Vim Modu

/vim  # INSERT/NORMAL mod geçişi

NORMAL modda: h/j/k/l · w/b/e · 0/$ · dd/dw · cc/cw · . (dot-repeat)

Hook Sistemi

~/.seth/hooks.json:

[
  { "event": "PreToolUse",  "tool": "file_write", "command": "git add -A" },
  { "event": "PostToolUse", "tool": "shell",       "command": "notify-send 'Tamamlandı'", "async": true },
  { "event": "OnResponse",                         "command": "espeak 'hazır'", "async": true }
]

Cron / Periyodik Görevler

/cron ekle günlük-özet  1d  "bugünkü değişiklikleri özetle ve commit öner"
/cron ekle saatlik-test 1h  "testleri çalıştır, hataları raporla"
/cron liste
/cron sil <id>

Web Arayüzü

Seth'i tarayıcıdan da yönetebilirsin. WebSocket tabanlı gerçek zamanlı akış, araç görünürlüğü, plan onayı ve diff görselleştirme.

Araçlar

Dosya & Kod

file_read · file_write · file_edit · batch_read · glob · list_directory · search

Git

git_status · git_diff · git_log · git_worktree · repo_ozet

Web & Ağ

web_fetch · web_search · browser_automation (Puppeteer)

Ajan & Bellek

agent_spawn · ask_user · memory_read · memory_write · mcp_arac · lsp_diagnostics

Siber Güvenlik

nmap · sqlmap · nikto · gobuster · ffuf · nuclei · masscan · subfinder · wpscan · whois · dig · whatweb · shodan · john · hashcat

CTF

ctf_auto · ctf_solver · ctf_web_analyzer · ctf_network_analyzer · ctf_stego · ctf_file_analyzer

Model Benchmark

/maliyet ve /provider-test komutlarıyla gerçek zamanlı ölçüm yapabilirsin.

Hız değerleri tipik koşullar altında ölçülmüştür, ağ gecikmesi ve yük durumuna göre değişebilir.

Kullanım Senaryoları

CTF Çözümü

seth --provider groq          # Hızlı model seç

/güvenlik pentest             # Pentest profilini aç
/ctf --dosya challenge.jpg    # Dosyayı analiz et — kategori otomatik tespit edilir

# SETH şunları yapar:
#  magic bytes analizi → steganografi tespiti → LSB çıkarma → flag arama
#  Sonuç: FLAG{g1zl1_veri_bulundu}

Güvenlik Taraması

seth

/güvenlik pentest
/koordinator "hedef.com alan adını tüm açılardan tara: subdomain, port, web zafiyeti, SSL"

# SETH paralel çalışır:
#  [Ajan 1] subfinder → 47 subdomain bulundu
#  [Ajan 2] nmap → 3 açık port, 1 eski servis
#  [Ajan 3] nuclei → 2 orta, 1 kritik zafiyet
#  Koordinatör sonuçları birleştirir

/rapor pdf                    # Profesyonel PDF raporu oluştur

Kod Review & Refactor

seth

/incele --staged              # Staged değişiklikleri AI ile incele

# ya da belirli bir dosya:
/skill review src/auth/middleware.ts

# PR incelemesi:
/pr-incele 142                # GitHub PR #142'yi çek ve analiz et

Büyük Proje Analizi

seth --provider gemini        # 2M token bağlamla devasa repo analizi

sen: "bu projenin mimarisini anla, teknik borçları listele ve öncelikli iyileştirme önerisi sun"

# SETH sırayla yapar:
#  glob ile tüm dosya yapısını tarar
#  import/export grafiğini çıkarır
#  git log ile değişim sıklığını analiz eder
#  Yapılandırılmış rapor sunar

Otomatik Test Yazımı

# Tek seferlik headless mod:
seth --auto -p "src/utils/ klasöründeki tüm fonksiyonlar için vitest unit testleri yaz, çalıştır ve hataları düzelt"

# SETH durdurmadan çalışır:
#  Fonksiyonları okur → test dosyaları yazar → vitest çalıştırır → hataları düzeltir → tekrar çalıştırır

Günlük Geliştirme Akışı

# Sabah: dünü özetle
/repo_özet

# Yeni özellik:
sen: "kullanıcı profil sayfası ekle, mevcut auth sistemini kullan"

# Değişiklikleri incele:
/incele --staged

# Oturumu kaydet:
/checkpoint oturum-2025-04-23

# Akşam: maliyet kontrolü:
/maliyet

Mimari

src/
├── cli.ts                  # CLI giriş noktası
├── repl.ts                 # Etkileşimli terminal (vim modu, keybindings, context bar)
├── headless.ts             # Headless mod (-p flag)
├── commands.ts             # 90+ slash komutu
├── vim-mode.ts             # INSERT/NORMAL vim state machine
├── keybindings.ts          # ~/.seth/keybindings.json yapılandırması
├── skills.ts               # Skill sistemi (built-in + kullanıcı)
├── rolling-summary.ts      # Otomatik bağlam sıkıştırma
├── permission-classifier.ts# Araç izin sınıflandırıcı
├── agent/
│   ├── loop.ts             # Ajan döngüsü (streaming, araç yürütme, fallback)
│   └── coordinator.ts      # Multi-agent koordinatör
├── providers/              # Claude, Gemini, OpenAI, Ollama, Groq, DeepSeek,
│                           # Mistral, xAI, LM Studio, LiteLLM, OpenRouter, Copilot
├── tools/                  # 60+ yerleşik araç
├── web/                    # WebSocket tabanlı tarayıcı arayüzü
├── auto-memory.ts          # Otomatik bellek çıkarma ve sıkıştırma
├── cron.ts                 # Periyodik görev sistemi
├── model-cost.ts           # Gerçek model fiyat tablosu
└── storage/                # Oturum, geçmiş, bellek, araç metrikleri

Gereksinimler

• Node.js ≥ 20
• En az bir AI sağlayıcısı (Ollama ücretsiz ve yerel)
• İsteğe bağlı: ripgrep — hızlı arama
• İsteğe bağlı: nmap, sqlmap, nikto, nuclei — güvenlik araçları
• İsteğe bağlı: pdflatex — PDF rapor üretimi
• İsteğe bağlı: xclip / wl-paste — pano desteği (Linux)

Lisans

GNU Affero General Public License v3.0 (AGPL-3.0)

• Kişisel ve eğitim amaçlı kullanım serbesttir
• Kaynak kodu inceleyebilir ve değiştirebilirsin
• Değiştirip dağıtırsan kaynak kodunu açık kaynak yapmak zorundasın
• Ağ üzerinden servis olarak sunarsan kaynak kodunu paylaşmak zorundasın
• Ticari kullanım veya özel lisans için iletişime geç