Gorev is a powerful Model Context Protocol (MCP) server written in Go that provides task management capabilities to AI assistants (Claude, VS Code, Windsurf, Cursor). It features unlimited subtask hierarchy, dependency management, tagging system, and templates for structured task creation.

Key Features: Natural language task creation, project organization, due date tracking, AI context management, enhanced NLP processing, advanced search & filtering with FTS5, 24 optimized MCP tools (unified from 45), and optional VS Code extension with rich visual interface.

Quick Start: Installation Guide | VS Code Extension

Gorev, Model Context Protocol (MCP) standardını kullanarak MCP uyumlu tüm AI editörler (Claude Desktop, VS Code, Windsurf, Cursor, Zed vb.) ile doğal dilde iletişim kurabilen, Go dilinde yazılmış güçlü bir görev yönetim sunucusudur. Proje yönetimi, görev takibi ve organizasyon ihtiyaçlarınızı AI asistanlarının yetenekleriyle birleştirerek verimliliğinizi artırır.

1. gorev-mcpserver - Go dilinde yazılmış MCP server (ana bileşen)
   • Embedded Web UI 🌐 - React arayüzü binary'ye gömülü (YENİ! v0.16.0)
   • REST API server (Fiber framework)
   • MCP protokol desteği
2. gorev-vscode - VS Code extension'ı (opsiyonel görsel arayüz)
3. gorev-web - React + TypeScript kaynak kodu (development)

MCP protokolü sayesinde server'a herhangi bir MCP uyumlu editörden bağlanabilirsiniz. Web arayüzü npx @mehmetsenol/gorev-mcp-server serve komutuyla otomatik olarak http://localhost:5082 adresinde hazır olur. VS Code extension'ı ise IDE içinde zengin görsel deneyim sunar.

Gorev, arka plan daemon process olarak çalışır ve şu avantajları sağlar:

Temel Özellikler:

• Tek Instance Yönetimi: Lock dosyası (~/.gorev-daemon/.lock) port çakışmalarını önler
• Çoklu İstemci Desteği: Birden fazla MCP istemcisi (Claude, VS Code, Windsurf, Cursor) aynı anda bağlanabilir
• Otomatik Başlatma: VS Code extension daemon'u otomatik tespit eder ve başlatır (v0.16.2+)
• Sağlık İzleme: /api/health endpoint'i ile gerçek zamanlı durum kontrolü
• WebSocket Desteği: Gerçek zamanlı görev güncelleme olayları (deneysel)

Hızlı Başlangıç:

# Daemon'u arka planda başlat
gorev daemon --detach

# Daemon durumunu kontrol et
curl http://localhost:5082/api/health

# Web arayüzü otomatik olarak hazır
open http://localhost:5082

Mimari Bileşenler:

• Lock Dosyası: ~/.gorev-daemon/.lock PID, port, versiyon ve daemon URL içerir
• REST API Server: VS Code extension için 23 endpoint (Fiber framework)
• MCP Proxy: stdio MCP protokol isteklerini internal handler'lara yönlendirir
• WebSocket Server: Görev güncellemeleri için gerçek zamanlı olay yayını
• Workspace Manager: SHA256 tabanlı ID'lerle çoklu workspace desteği

VS Code Entegrasyonu: Extension daemon yaşam döngüsünü otomatik yönetir:

1. Aktivasyonda daemon'un çalışıp çalışmadığını kontrol eder (lock dosyasını okur)
2. Çalışmıyorsa daemon'u başlatır
3. Tüm işlemler için REST API'ye bağlanır
4. Deaktivasyonda daemon'u kapatır (eğer extension başlattıysa)

Detaylı teknik özellikler için Daemon Mimari Dokümantasyonu'na bakın.

gorev_bulk - Tüm 3 operasyon artık tamamen çalışıyor:

• update operasyonu: {ids: [], data: {}} → {updates: [{id, ...alanlar}]} dönüşümü düzgün çalışıyor
• transition operasyonu: Hem status hem yeni_durum parametrelerini kabul ediyor
• tag operasyonu: Hem operation hem tag_operation parametrelerini kabul ediyor
• Test sonucu: %100 başarı oranı (5/5 operasyon production'da test edildi)

gorev_guncelle - Çoklu alan güncelleme desteği eklendi:

• status (durum), priority (öncelik) veya her ikisini birden güncelleyebilir
• En az bir parametre gerekli (validasyon)
• Mevcut kodla geriye dönük uyumlu

gorev_search (gelişmiş mod) - Akıllı sorgu ayrıştırma eklendi:

• Örnek: "durum:devam_ediyor oncelik:yuksek tags:frontend"
• Doğal dil sorgularından filtreleri otomatik olarak çıkarır
• Boşlukla ayrılmış key:value çiftleri ile çoklu filtre desteği
• Mevcut filtre parametreleriyle sorunsuz çalışır

VS Code Tree View - Bağımlılık göstergeleri artık görünür:

• 🔒 (bloke), 🔓 (bloke değil), 🔗 (bağımlı) ikonları düzgün gösteriliyor
• JSON serileştirme sorunu düzeltildi (bağımlılık sayaçlarından omitempty kaldırıldı)
• Tüm bağımlılık ilişkileri artık tree yapısında görünür

Doğrulama: Kilocode AI kapsamlı test raporu ile %100 başarı oranı onaylandı

• NPM Binary Güncelleme Hatası: NPM paket yükseltmelerinde eski binary'lerin korunması hatası düzeltildi
  • Paket boyutu 78.4 MB'tan 6.9 KB'ye düşürüldü (binary'ler artık GitHub'dan indiriliyor)
• VS Code Otomatik Başlatma: Extension artık server'ı otomatik olarak başlatıyor

• Sıfır Yapılandırma: Modern React arayüzü Go binary'sine gömülü
• Anında Erişim: http://localhost:5082 adresinde otomatik olarak hazır
• Tam Özellikler: Görevler, projeler, şablonlar, alt görevler ve bağımlılıklar
• Dil Senkronizasyonu: Türkçe/İngilizce değiştirici MCP server ile senkronize
• Ayrı Kurulum Yok: Sadece npx @mehmetsenol/gorev-mcp-server serve komutuyla hazır!

• İzole Workspace'ler: Her proje klasörü kendi görev veritabanına sahip
• Workspace Değiştirici: Web UI'da workspace'ler arası sorunsuz geçiş
• Otomatik Tespit: Mevcut klasördeki .gorev/ dizinini otomatik algılar

• Akıllı görev oluşturma - Doğal dil komutlarıyla
• Markdown desteği - Zengin açıklama formatı
• Durum yönetimi - Beklemede → Devam ediyor → Tamamlandı
• Öncelik seviyeleri - Düşük, Orta, Yüksek
• Esnek düzenleme - Tüm görev özelliklerini güncelleme

• Hiyerarşik yapı - Projeler altında görev gruplandırma
• Aktif proje sistemi - Varsayılan proje ile hızlı işlem
• Proje bazlı raporlama - Detaylı istatistikler
• Çoklu proje desteği - Sınırsız proje oluşturma

• 📅 Son tarih takibi - Deadline yönetimi ve acil görev filtreleme
• 🏷️ Etiketleme sistemi - Çoklu etiket ile kategorilendirme
• 🔄 Görev bağımlılıkları - İlişkili görevler arası otomasyon
• 📋 Hazır şablonlar - Bug raporu, feature request ve daha fazlası
• 🔍 Gelişmiş filtreleme - Durum, etiket, tarih bazlı sorgulama
• 🌳 Alt görev hiyerarşisi - Sınırsız derinlikte görev ağacı yapısı
• 📊 İlerleme takibi - Ana görevde alt görev tamamlanma yüzdesi
• 📁 File System Watcher - Dosya değişikliklerini izleme ve otomatik görev durum geçişleri
• 🔔 Otomatik Durum Güncelleme - Dosya değişikliklerinde "beklemede" → "devam_ediyor" otomasyonu
• ⚙️ Konfigürasyon Yönetimi - Ignore patterns ve izleme kuralları özelleştirmesi

• 🔍 Gelişmiş Arama & Filtreleme - FTS5 full-text search ve akıllı filtreleme (v0.15.0)
• 🧠 Gelişmiş NLP İşleme - Akıllı doğal dil anlama ve yorumlama (v0.14.0)
• Doğal dil işleme - AI asistanlarla konuşarak görev yönetimi
• Çoklu editör desteği - Claude, VS Code, Windsurf, Cursor, Zed
• Bağlamsal anlama - Akıllı komut yorumlama ve parametre çıkarımı
• MCP standardı - Tüm MCP uyumlu araçlarla uyumluluk
• 🌐 MCP Registry - Otomatik keşfedilebilirlik ve kolay kurulum (v0.15.24+)
• 🌍 Uluslararası Destek - Türkçe ve İngilizce tam dil desteği (v0.11.0+)
• ⚡ Thread Safety - 100% race condition free operation (v0.14.0)

• Modern React Arayüzü - TypeScript + Vite ile hızlı ve responsive
• Proje Bazlı Görünüm - Proje kartları ve gerçek zamanlı istatistikler
• Görev Yönetimi - CRUD işlemleri template sistemi ile
• Alt Görev Görünümü - Hiyerarşik görev listesi (collapse/expand)
• Bağımlılık Göstergesi - Visual dependency indicators (🔗 count + ⚠️ incomplete)
• Durum Yönetimi - Inline dropdown'larla hızlı güncelleme
• Gelişmiş Filtreleme - Durum, öncelik, proje bazlı filtreleme
• 🌍 Dil Değiştirici - Türkçe/İngilizce arasında geçiş, MCP sunucusu ile senkronize
• Responsive Tasarım - Tailwind CSS ile mobil uyumlu
• Gerçek Zamanlı Sync - React Query ile otomatik veri güncelleme
• 🚀 Kurulum Gerektirmez: npx @mehmetsenol/gorev-mcp-server serve komutuyla otomatik aktif!
• Embedded UI: Go binary'sine gömülü, ayrı kurulum yok
• Erişim: http://localhost:5082 (varsayılan port)

• İki Dil Desteği - Türkçe ve İngilizce arayüz (v0.5.0+) 🌍
• TreeView Panelleri - Görev, proje ve şablon listeleri
• Görsel Arayüz - Tıkla ve kullan deneyimi
• Status Bar - Anlık durum bilgisi
• Komut Paleti - Hızlı erişim (Ctrl+Shift+G)
• Renk Kodlaması - Öncelik bazlı görsel ayırt etme
• Context Menüler - Sağ tık işlemleri
• Otomatik Dil Algılama - VS Code diline göre otomatik arayüz dili
• Marketplace'den İndir 🚀
• Diğer IDE'lere Kurulum (Cursor, Windsurf, VSCodium vb.)

⚠️ Windows Kullanıcıları: NPM kullanımı için Node.js kurulumu gereklidir. Node.js indirin ve yükledikten sonra sistemi yeniden başlatın.

npm install -g @mehmetsenol/gorev-mcp-server

Veya doğrudan NPX ile kullanın (kurulum gerektirmez):

npx @mehmetsenol/gorev-mcp-server serve

Claude Desktop için:

// ~/.config/Claude/claude_desktop_config.json (Linux)
// ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
// %APPDATA%/Claude/claude_desktop_config.json (Windows)
{
  "mcpServers": {
    "gorev": {
      "command": "npx",
      "args": [
        "-y",
        "@mehmetsenol/gorev-mcp-server@latest"
      ],
      "env": {
        "GOREV_LANG": "tr"
      }
    }
  }
}

Kilo Code (VS Code Extension) için:

// .kilocode/mcp.json (workspace root)
{
  "mcpServers": {
    "gorev": {
      "command": "npx",
      "args": [
        "-y",
        "@mehmetsenol/gorev-mcp-server@latest"
      ],
      "env": {
        "GOREV_LANG": "tr"
      }
    }
  }
}

Cursor için:

// .cursor/mcp.json (workspace root)
{
  "mcpServers": {
    "gorev": {
      "command": "npx",
      "args": [
        "-y",
        "@mehmetsenol/gorev-mcp-server@latest"
      ],
      "env": {
        "GOREV_LANG": "en"
      }
    }
  }
}

📚 Daha fazla örnek: MCP Configuration Examples

Eğer ENOENT: spawn npx hatası alıyorsanız:

1. Node.js kurulu mu kontrol edin:

   node --version
   npm --version
   npx --version

2. Node.js kurulumunu yapın:

   • Node.js websitesinden LTS sürümü indirin
   • Installer'ı çalıştırırken "Add to PATH" seçeneğini işaretleyin
   • Kurulum sonrası bilgisayarı yeniden başlatın

3. NPX ayrı kurulumu (gerekirse):

   npm install -g npx

4. PATH kontrolü:

   echo %PATH%

   Node.js paths (C:\Program Files\nodejs\) görünmeli.

# Linux/macOS
curl -fsSL https://raw.githubusercontent.com/msenol/Gorev/main/install.sh | bash

# Specific version
curl -fsSL https://raw.githubusercontent.com/msenol/Gorev/main/install.sh | VERSION=v0.11.0 bash

Not: Kurulum sonrası eğer "unable to open database file" hatası alırsanız, GOREV_ROOT environment variable'ını ayarlayın:

export GOREV_ROOT=/path/to/gorev-mcpserver  # Projenin bulunduğu dizin
echo 'export GOREV_ROOT=/path/to/gorev-mcpserver' >> ~/.bashrc  # Kalıcı yapmak için

# PowerShell'de çalıştırın (Admin yetkisi gerekmez)
irm https://raw.githubusercontent.com/msenol/Gorev/main/install.ps1 | iex

# Veya belirli versiyon için:
$env:VERSION="v0.15.4"; irm https://raw.githubusercontent.com/msenol/Gorev/main/install.ps1 | iex

# PowerShell (Admin olarak çalıştırın)
New-Item -ItemType Directory -Force -Path "C:\Program Files\gorev"
Invoke-WebRequest -Uri "https://github.com/msenol/gorev/releases/latest/download/gorev-windows-amd64.exe" -OutFile "C:\Program Files\gorev\gorev.exe"
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\gorev", [EnvironmentVariableTarget]::Machine)

# GOREV_ROOT ayarla
[Environment]::SetEnvironmentVariable("GOREV_ROOT", "$env:APPDATA\gorev", [EnvironmentVariableTarget]::User)

# Test
gorev version

# Binary indirme (Homebrew desteği yakında)
curl -L https://github.com/msenol/gorev/releases/latest/download/gorev-darwin-amd64 -o gorev
chmod +x gorev
sudo mv gorev /usr/local/bin/

# Binary indirme
curl -L https://github.com/msenol/gorev/releases/latest/download/gorev-linux-amd64 -o gorev
chmod +x gorev
sudo mv gorev /usr/local/bin/

# Test
gorev version

# Docker image yakında gelecek
# docker pull ghcr.io/msenol/gorev:latest
# docker run -v ~/.gorev:/data ghcr.io/msenol/gorev serve

{
  "mcpServers": {
    "gorev": {
      "command": "/path/to/gorev-mcpserver/gorev",
      "args": ["serve"],
      "env": {
        "GOREV_DATA_DIR": "~/.gorev",
        "GOREV_LANG": "tr"
      }
    }
  }
}

{
  "mcp.servers": {
    "gorev": {
      "command": "/path/to/gorev-mcpserver/gorev",
      "args": ["serve"]
    }
  }
}

{
  "mcp.servers": [
    {
      "name": "gorev",
      "command": "gorev",
      "args": ["serve"]
    }
  ]
}

{
  "mcp.gorev": {
    "command": "gorev serve",
    "env": {
      "GOREV_DATA_DIR": "~/.gorev"
    }
  }
}

"Yeni bir görev oluştur: API dokümantasyonu yazılacak yarın deadline ile"
"Bu hafta için yüksek öncelikli görevleri göster"
"Bug etiketli açık görevleri listele"
"Mobil App v2 projesini aktif yap"
"Sprint planlaması için yeni proje oluştur"
"Görev #5'i tamamlandı olarak işaretle"
"Son oluşturduğum görev nasıl gidiyor?"
"Frontend kategorisindeki görevleri göster"
"Bugün deadline olan acil görevler var mı?"
"Feature request şablonundan yeni görev oluştur"
"Proje dosyalarını izlemeye başla"
"Dosya değişikliklerinde otomatik durum geçişi yap"
"Watch listesini göster"

💡 İpucu: Bu komutlar Claude, VS Code Copilot, Windsurf AI, Cursor ve diğer MCP uyumlu AI asistanlarla kullanılabilir.

# Daemon yönetimi (önerilen)
gorev daemon --detach        # Daemon'u arka planda başlat
gorev daemon-status          # Daemon durumunu kontrol et
gorev daemon-stop            # Çalışan daemon'u durdur

# Geliştirme/test (foreground mod)
gorev serve                  # Normal mod
gorev serve --debug          # Debug modunda
gorev serve --port 8080      # Farklı port

# Görev işlemleri
gorev task list              # Görevleri listele
gorev task create            # Yeni görev oluştur
gorev task show <id>         # Görev detayı

# Proje işlemleri
gorev project list           # Projeleri listele
gorev project create         # Yeni proje oluştur

# Diğer
gorev version                # Versiyon bilgisi
gorev help                   # Yardım

Detaylı dokümantasyon için docs/ klasörüne bakın:

• 🚀 Hızlı Başlangıç - 10 dakikada kurulum ve kullanım
• 📦 Kurulum Kılavuzu - Platform-specific installation
• 🆘 Sorun Giderme - Yaygın sorunlar ve çözümleri
• 🔄 Göç Kılavuzu (v0.15→v0.16) - v0.15'ten yükseltme

• 🌐 Web UI Kılavuzu - Gömülü React arayüz dokümantasyonu
• 🗂️ Multi-Workspace Desteği - Çoklu proje yönetimi
• 📋 Template Sistemi - Yapılandırılmış görev oluşturma
• 🤖 AI Context Yönetimi - AI asistan entegrasyonu

• 🛠️ MCP Araçları - 24 optimize MCP aracının komple referansı (45'ten birleştirildi)
• 🔧 MCP Konfigürasyon Örnekleri - IDE kurulum kılavuzları
• 📖 Kullanım Kılavuzu - Detaylı kullanım örnekleri
• 🎨 VS Code Extension - Extension dokümantasyonu

• 🏗️ Sistem Mimarisi - Teknik detaylar
• 💻 Katkı Kılavuzu - Nasıl katkıda bulunulur
• 🗺️ Yol Haritası - Geliştirme planları
• 📚 Geliştirme Geçmişi - Proje geçmişi
• 🚀 VS Code Marketplace - Extension'ı indir

• 🤖 CLAUDE.md - Turkish AI assistant guidance
• 🌍 CLAUDE.en.md - English AI assistant guidance
• 📋 MCP Tools Reference - Detailed MCP tool documentation
• 📚 Development History - Complete project history

gorev/
├── gorev-mcpserver/        # MCP Server (Go)
│   ├── cmd/gorev/         # CLI ve server entry point
│   ├── internal/
│   │   ├── mcp/           # MCP protokol katmanı
│   │   └── gorev/        # Business logic
│   └── test/              # Integration testler
├── gorev-vscode/           # VS Code Extension (TypeScript)
│   ├── src/
│   │   ├── commands/      # VS Code komutları
│   │   ├── providers/     # TreeView sağlayıcıları
│   │   └── mcp/           # MCP client
│   └── package.json       # Extension manifest
└── docs/                   # Proje dokümantasyonu

┌───────────────┐     ┌───────────────┐     ┌────────────────┐
│ Claude/Cursor │     │   VS Code     │     │ VS Code + Gorev│
│               │     │ + MCP Plugin  │     │   Extension    │
└──────┬───────┘     └──────┬───────┘     └───────┬────────┘
       │                      │                      │
       └──────────────────────┴──────────────────────┘
                              │ MCP Protocol
                        ┌─────┴─────┐
                        │ Gorev MCP  │
                        │   Server   │
                        └─────┬─────┘
                              │
                        ┌─────┴─────┐
                        │   SQLite   │
                        └───────────┘

• Go 1.23+
• Make (opsiyonel)
• golangci-lint (kod kalitesi için)

# Bağımlılıkları indir
make deps

# Test çalıştır (84.6% overall coverage)
make test

# Coverage raporu
make test-coverage

# Lint kontrolü
make lint

# Build (tüm platformlar)
make build-all

# Docker image
make docker-build

1. Projeyi fork'layın
2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
3. Değişikliklerinizi commit'leyin (git commit -m 'feat: add amazing feature')
4. Branch'inizi push'layın (git push origin feature/amazing-feature)
5. Pull Request açın

Detaylı bilgi için Geliştirici Rehberi'ne bakın.

• Versiyon: v0.16.2 🚀
• Test Coverage: %75+ (Comprehensive test coverage with ongoing improvements)
• Go Version: 1.23+
• MCP SDK: mark3labs/mcp-go v0.6.0
• Database: SQLite (embedded)
• Security: Production-ready audit compliant
• Thread Safety: 100% race condition free

• 📦 GitHub Releases
• 🐛 Issue Tracker
• 💬 Discussions
• 📖 Wiki

gorev_olustur tool artık kullanılamaz. Tüm görevler template kullanılarak oluşturulmalıdır.

gorev_olustur baslik="Bug fix" aciklama="..." oncelik="yuksek"

# 1. Önce template listesini görün
template_listele

# 2. Template kullanarak görev oluşturun
templateden_gorev_olustur template_id='bug_report_v2' degerler={
  'baslik': 'Login bug',
  'aciklama': 'Kullanıcı giriş yapamıyor',
  'modul': 'auth',
  'severity': 'high',
  ...
}

• bug_report_v2 - Gelişmiş bug raporu (severity, steps, environment)
• spike_research - Time-boxed araştırma görevleri
• performance_issue - Performans sorunları (metrics, targets)
• security_fix - Güvenlik düzeltmeleri (CVSS, components)
• refactoring - Kod iyileştirme (code smell, strategy)

• Tutarlılık: Her görev belirli standartlara uygun
• Kalite: Zorunlu alanlar eksik bilgi girişini engeller
• Otomasyon: Template tipine göre otomatik workflow
• Raporlama: Görev tipine göre detaylı metrikler

Bu proje MIT Lisansı altında lisanslanmıştır.