FETİH

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

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

FETİH Nedir?

FETİH, 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, FETİH 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"

FETİH: 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 FETİH?

Fetih Engine

FETİH'in içine gömülü gelişmiş siber güvenlik motoru. 54 sınıf, 150 araç ve AI destekli karar mekanizması ile FETİH'i eksiksiz bir pentest platformuna dönüştürür. FETİH başlarken otomatik çalışır, kapanırken temizlenir — hiçbir şey düşünmene gerek yok.

Motorda Neler Var?

Nasıl Çalışır?

Fetih Engine iki katmanlıdır:

1. seth_engine_server.py — Flask tabanlı arka plan sunucusu (8888 portu)
2. seth_engine_mcp.py — MCP protokolü ile 150 tool'u AI'ya sunan arayüz

FETİH açıldığında engine otomatik başlar, tool'lar keşfedilir ve AI'nın kullanımına sunulur. Tek yapman gereken FETİH'e ne yapmasını istediğini söylemek.

Kurulum

Geliştirme Ortamı

# Depoyu klonla
git clone https://github.com/MustafaKemal0146/fetih.git
cd fetih

# Bağımlılıkları yükle
npm install

# Projeyi derle
npm run build

# Geliştirme modunda çalıştır
npm run dev

Global Kurulum

npm install -g github:MustafaKemal0146/fetih

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

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

Konteyner ile Çalıştırma (laction)

Projeyi izole konteyner ortamında çalıştırmak için:

# Varsayılan profil (build)
laction .

# Test profili
laction . test

# Lint profili
laction . lint

# Dev profili
laction . dev

Desteklenen AI Sağlayıcıları

Başlatırken: fetih --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

~/.fetih/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

FETİH iki katmanlı bellek sistemi kullanır:

Manuel Bellek (~/.fetih/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 (~/.fetih/auto-memory/):
Konuşma sonunda AI önemli bilgileri otomatik kaydeder. Bir sonraki oturumda proje tercihleri, teknik kararlar ve bulgular hazır olur.

Skill Sistemi

~/.fetih/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

~/.fetih/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ü

Fetih'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

Fetih Engine (150 Araç)

nmap_scan · nuclei_scan · sqlmap_scan · metasploit_run · hydra_attack · john_crack · hashcat_crack · ghidra_analysis · gdb_analyze · radare2_analyze · volatility_analyze · binwalk_analyze · dalfox_xss_scan · jwt_analyzer · graphql_scanner · api_fuzzer · gobuster_scan · ffuf_scan · wpscan_analyze · nikto_scan · masscan_high_speed · rustscan_fast_scan · subfinder_scan · amass_scan · prowler_scan · trivy_scan · kube_hunter_scan · kube_bench_cis · checkov_iac_scan · autorecon_comprehensive · intelligent_smart_scan · ai_generate_payload · ai_vulnerability_assessment · bugbounty_comprehensive_assessment · browser_agent_inspect · threat_hunting_assistant · vulnerability_intelligence_dashboard · responder_credential_harvest · pacu_exploitation · msfvenom_generate · cloudmapper_analysis · docker_bench_security_scan · steghide_analysis · exiftool_extract · foremost_carving · http_intruder · http_repeater · dnsenum_scan · netexec_scan · one_gadget_search · libc_database_lookup · pwntools_exploit · angr_symbolic_execution · advanced_payload_generation · comprehensive_api_audit · create_attack_chain_ai · monitor_cve_feeds

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ü

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

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

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

Güvenlik Taraması

fetih

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

# FETİH 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

fetih

/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

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

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

# FETİH 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:
fetih --auto -p "src/utils/ klasöründeki tüm fonksiyonlar için vitest unit testleri yaz, çalıştır ve hataları düzelt"

# FETİH 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          # ~/.fetih/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ç
├── fetih-engine/            # Fetih Engine (150 tool, 54 sınıf, MCP server)
│   ├── seth_engine_server.py
│   ├── seth_engine_mcp.py
│   ├── bridge.ts           # FETİH lifecycle entegrasyonu
│   └── registry.ts         # Tool keşfi ve kaydı
├── 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
• Python 3.8+ (Fetih Engine için)
• Python paketleri: pip install flask requests aiohttp beautifulsoup4 selenium mitmproxy psutil mcp
• 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ç