eyaltoledano/claude-task-master

Taskmaster: Yapay zeka odaklı geliştirme için bir görev yönetim sistemi, herhangi bir AI sohbet aracıyla sorunsuzca çalışacak şekilde tasarlanmıştır.

| Belgeler

Yapımcılar: @eyaltoledano & @RalphEcom

Claude ile yapay zeka odaklı geliştirme için bir görev yönetim sistemi, Cursor AI ile sorunsuzca çalışacak şekilde tasarlanmıştır.

Belgeler

📚 Tam Belgeleri Görüntüle

Hızlı Bağlantılar

• Hızlı Başlangıç Kılavuzu
• Kurulum
• API Anahtarları & Sağlayıcılar
• Desteklenen Editörler
• MCP Araçları Referansı
• CLI Komutları Referansı
• Görev Yapısı
• Görev Bağımlılıkları
• Etiketler & İş Akışları
• Araştırma Komutu
• Loop Komutu
• AI Sağlayıcıları Özeti
• Takım İşbirliği
• En İyi Uygulamalar
• SSS
• Değişim Günlüğü

Hamster'dan Daha Fazlası

• Hamster Studio
• Ürün & Mühendislik Yöntemleri
• Ürün & Mühendislik Becerileri
• Hamster Fiyatlandırması

Cursor 1.0+ için Hızlı Kurulum (Tek Tıkla)

Not: Bağlantıya tıkladıktan sonra, API anahtarlarınızı yapılandırmaya eklemeniz gerekecektir. Bağlantı, MCP sunucusunu yer tutucu anahtarlarla kurar ve bunları gerçek API anahtarlarınızla değiştirmeniz gerekir.

Claude Code Hızlı Kurulu

Claude Code kullanıcıları için:

claude mcp add taskmaster-ai -- npx -y task-master-ai

API anahtarlarınızı yapılandırmaya eklemeyi unutmayın:

• Projenizin kök .env dosyasında
• Taskmaster-ai için mcp yapılandırmasının "env" bölümünde

Gereksinimler

Taskmaster, çeşitli komutlar arasında AI kullanır ve bunlar ayrı bir API anahtarı gerektirir. Sağlanan API anahtarlarını eklemek kaydıyla, farklı AI sağlayıcılarından çeşitli modelleri kullanabilirsiniz. Örneğin, Claude 3.7 kullanmak istiyorsanız, bir Anthropic API anahtarına ihtiyacınız olacak.

Kullanılacak 3 tür model tanımlayabilirsiniz: ana model, araştırma modeli ve fallback modeli (ana veya araştırma modeli başarısız olursa). Hangi modeli kullanırsanız kullanın, sağlayıcısının API anahtarı mcp.json veya .env dosyasında bulunmalıdır.

Aşağıdakilerden en az birinin (1) olması gereklidir:

• Anthropic API anahtarı (Claude API)
• OpenAI API anahtarı
• Google Gemini API anahtarı
• Perplexity API anahtarı (araştırma modeli için)
• xAI API anahtarı (araştırma veya ana model için)
• OpenRouter API anahtarı (araştırma veya ana model için)
• Claude Code (API anahtarı gerekmez - Claude Code CLI gereklidir)
• Codex CLI (ChatGPT aboneliği aracılığıyla OAuth - Codex CLI gereklidir)

Araştırma modelini kullanmak isteğe bağlıdır ancak son derece önerilir. En az BİR API anahtarına ihtiyacınız olacak (Claude Code veya Codex CLI ile OAuth kullanmadıkça). Tüm API anahtarlarını eklemek, model sağlayıcıları arasında sorunsuzca geçiş yapmanızı sağlar.

Hızlı Başlangıç

Seçenek 1: MCP (Önerilir)

MCP (Model Control Protocol), Görev Ustasını doğrudan editörünüzden çalıştırmanıza olanak sağlar.

1. Editörünüze bağlı olarak aşağıdaki yolda MCP yapılandırmanızı ekleyin

Editör	Kapsam	Linux/macOS Yolu	Windows Yolu	Anahtar
Cursor	Genel	~/.cursor/mcp.json	%USERPROFILE%\.cursor\mcp.json	mcpServers
	Proje	<project_folder>/.cursor/mcp.json	<project_folder>\.cursor\mcp.json	mcpServers
Windsurf	Genel	~/.codeium/windsurf/mcp_config.json	%USERPROFILE%\.codeium\windsurf\mcp_config.json	mcpServers
VS Code	Proje	<project_folder>/.vscode/mcp.json	<project_folder>\.vscode\mcp.json	servers
Q CLI	Genel	~/.aws/amazonq/mcp.json		mcpServers

Manuel Yapılandırma

Cursor & Windsurf & Q Developer CLI (mcpServers)

{
  "mcpServers": {
    "task-master-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        // "TASK_MASTER_TOOLS": "all", // Seçenekler: "all", "standard", "core", veya araçların virgülle ayrılmış listesi
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
        "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE",
        "GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE",
        "MISTRAL_API_KEY": "YOUR_MISTRAL_KEY_HERE",
        "GROQ_API_KEY": "YOUR_GROQ_KEY_HERE",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE",
        "XAI_API_KEY": "YOUR_XAI_KEY_HERE",
        "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE",
        "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY_HERE"
      }
    }
  }
}

🔑 YOUR_…_KEY_HERE kısımlarını gerçek API anahtarlarınızla değiştirin. Kullanmadığınız anahtarları kaldırabilirsiniz.

Not: MCP ayarlarında 0 tools enabled görüyorsanız, editörünüzü yeniden başlatın ve API anahtarlarınızın doğru şekilde yapılandırıldığını kontrol edin.

VS Code (servers + type)

{
  "servers": {
    "task-master-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        // "TASK_MASTER_TOOLS": "all", // Seçenekler: "all", "standard", "core", veya araçların virgülle ayrılmış listesi
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
        "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE",
        "GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE",
        "MISTRAL_API_KEY": "YOUR_MISTRAL_KEY_HERE",
        "GROQ_API_KEY": "YOUR_GROQ_KEY_HERE",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE",
        "XAI_API_KEY": "YOUR_XAI_KEY_HERE",
        "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE",
        "OLLAMA_API_KEY": "YOUR_OLLAMA_API_KEY_HERE"
      },
      "type": "stdio"
    }
  }
}

🔑 YOUR_…_KEY_HERE kısımlarını gerçek API anahtarlarınızla değiştirin. Kullanmadığınız anahtarları kaldırabilirsiniz.

2. (Yalnızca Cursor) Taskmaster MCP'yi Etkinleştirin

Cursor Ayarlarını açın (Ctrl+Shift+J) ➡ Sol tarafta MCP sekmesine tıklayın ➡ task-master-ai'ı toggle ile etkinleştirin

3. (İsteğe Bağlı) Kullanmak istediğiniz modelleri yapılandırın

Editörünüzün AI sohbet bölmesinde şunu söyleyin:

Sırasıyla ana, araştırma ve fallback modellerini <model_name>, <model_name> ve <model_name> olarak değiştir.

Örneğin, Claude Code kullanmak için (API anahtarı gerekmez):

Ana modeli claude-code/sonnet olarak değiştir

Kullanılabilir modellerin tablosu | Claude Code kurulumu

4. Görev Ustasını İnitleyin

Editörünüzün AI sohbet bölmesinde şunu söyleyin:

Projemdeki taskmaster-ai'ı başlat

5. PRD'ye Sahip Olduğunuzdan Emin Olun (Önerilir)

Yeni projeler için: PRD'nizi .taskmaster/docs/prd.txt konumunda oluşturun. Mevcut projeler için: scripts/prd.txt kullanabilir veya task-master migrate ile taşıyabilirsiniz

Başlatma sonrasında .taskmaster/templates/example_prd.txt konumunda örnek bir PRD şablonu mevcuttur.

[!NOTE] Karmaşık projeler için bir PRD önerilse de, her zaman chat'te "Şunu uygulamama yardım edebilir misin [yapmak istediğin şeyin açıklaması]?" diyerek ayrı görevler oluşturabilirsiniz.

Her zaman detaylı bir PRD ile başlayın.

PRD'niz ne kadar detaylı olursa, oluşturulan görevler de o kadar iyi olur.

6. Yaygın Komutlar

AI asistanınızı şu şekilde kullanın:

• Gereksinimleri çözümle: scripts/prd.txt'deki PRD'mi çözümleyebilir misin?
• Sonraki adımı planla: Çalışmam gereken sonraki görev ne?
• Bir görevi uygula: Görev 3'ü uygulamama yardım edebilir misin?
• Birden fazla görevi görüntüle: Bana görev 1, 3 ve 5'i gösterebilir misin?
• Bir görevi genişlet: Görev 4'ü genişletmeme yardım edebilir misin?
• Taze bilgi araştır: Node.js ile JWT kimlik doğrulamasını uygulamak için en son en iyi uygulamaları araştır
• İçeriğe dayalı araştır: Mevcut API uygulamamız için src/api.js'deki React Query v5 geçiş stratejilerini araştır

Görev Ustasını sohbette nasıl kullanacağınız hakkında daha fazla örnek

Seçenek 2: Komut Satırını Kullanma

Kurulum

# Genel olarak yükle
npm install -g task-master-ai

# VEYA projeniz içinde yerel olarak yükle
npm install task-master-ai

Yeni bir projeyi başlat

# Genel olarak yüklüyse
task-master init

# Yerel olarak yüklüyse
npx task-master init

# Belirli kurallarla projeyi başlat
task-master init --rules cursor,windsurf,vscode

Bu sizi proje ayrıntıları hakkında soracak ve gerekli dosya ve yapıyı içeren yeni bir projeyi kuracaktır.

Yaygın Komutlar

# Yeni bir projeyi başlat
task-master init

# PRD'yi çözümle ve görevler oluştur
task-master parse-prd your-prd.txt

# Tüm görevleri listele
task-master list

# Çalışılacak sonraki görevi göster
task-master next

# Belirli görev(leri) göster - virgülle ayrılmış ID'leri destekler
task-master show 1,3,5

# Proje bağlamı ile taze bilgi araştır
task-master research "JWT kimlik doğrulaması için en son en iyi uygulamalar nelerdir?"

# Görevleri etiketler arasında taşı (çapraz etiket hareketi)
task-master move --from=5 --from-tag=backlog --to-tag=in-progress
task-master move --from=5,6,7 --from-tag=backlog --to-tag=done --with-dependencies
task-master move --from=5 --from-tag=backlog --to-tag=in-progress --ignore-dependencies

# Başlatma sonrasında kurallar ekle
task-master rules add windsurf,roo,vscode

Araç Yükleme Yapılandırması

MCP Araç Yüklemesini Optimize Etme

Görev Ustasının MCP sunucusu, bağlam penceresi kullanımını azaltmak için seçici araç yüklemesini destekler. Varsayılan olarak, mevcut kurulumlarla geriye dönük uyumluluğu sağlamak için tüm 36 araç yüklenir (~21.000 token).

TASK_MASTER_TOOLS ortam değişkenini yapılandırarak performansı optimize edebilirsiniz:

Kullanılabilir Modlar

Mod	Araçlar	Bağlam Kullanımı	Kullanım Durumu
all (varsayılan)	36	~21.000 token	Tam özellik seti - tüm araçlar kullanılabilir
standard	15	~10.000 token	Yaygın görev yönetim işlemleri
core (veya lean)	7	~5.000 token	Temel günlük geliştirme iş akışı
custom	Değişken	Değişken	Belirli araçların virgülle ayrılmış listesi

Yapılandırma Yöntemleri

Yöntem 1: MCP Yapılandırma Dosyasında Ortam Değişkeni

TASK_MASTER_TOOLS'u MCP yapılandırma dosyanızın env bölümüne ekleyin:

{
  "mcpServers": {  // veya VS Code için "servers"
    "task-master-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        "TASK_MASTER_TOOLS": "standard",  // Seçenekler: "all", "standard", "core", "lean", veya virgülle ayrılmış liste
        "ANTHROPIC_API_KEY": "your-key-here",
        // ... diğer API anahtarları
      }
    }
  }
}

Yöntem 2: Claude Code CLI (Bir Defiye Kurulum)

Claude Code kullanıcıları için, kurulum sırasında modu ayarlayabilirsiniz:

# Core mod örneği (~%70 token azaltma)
claude mcp add task-master-ai --scope user \
  --env TASK_MASTER_TOOLS="core" \
  -- npx -y task-master-ai@latest

# Özel araçlar örneği
claude mcp add task-master-ai --scope user \
  --env TASK_MASTER_TOOLS="get_tasks,next_task,set_task_status" \
  -- npx -y task-master-ai@latest

Araç Setleri Detayları

Core Araçlar (7): get_tasks, next_task, get_task, set_task_status, update_subtask, parse_prd, expand_task

Standart Araçlar (15): Tüm core araçlar artı initialize_project, analyze_project_complexity, expand_all, add_subtask, remove_task, generate, add_task, complexity_report

Tüm Araçlar (36): Proje kurulumu, görev yönetimi, analiz, bağımlılıklar, etiketler, araştırma ve daha fazlasını içeren eksiksiz set

Öneriler

• Yeni kullanıcılar: İyi bir denge için "standard" moduyla başlayın
• Büyük projeler: Token kullanımını en aza indirmek için "core" modunu kullanın
• Karmaşık iş akışları: "all" modunu veya özel seçimi kullanın
• Geriye dönük uyumluluk: Belirtilmezse, "all" moduna varsayılan olur

Claude Code Desteği

Görev Ustası artık Claude Code CLI aracılığıyla Claude modellerini destekler ve API anahtarı gerektirmez:

• Modeller: claude-code/opus ve claude-code/sonnet
• Gereksinimler: Claude Code CLI yüklü
• Faydalar: API anahtarı gerekmez, yerel Claude örneğinizi kullanır

Claude Code kurulumu hakkında daha fazla bilgi edinin

Sorun Giderme

Eğer task-master init yanıt vermiyorsa

Node ile doğrudan çalıştırmayı deneyin:

node node_modules/claude-task-master/scripts/init.js

Veya depoyu klonlayın ve çalıştırın:

git clone https://github.com/eyaltoledano/claude-task-master.git
cd claude-task-master
node scripts/init.js

Ekibimize Katılın

Katkıda Bulunanlar

Yıldız Tarihi

Lisanslama

Görev Ustası, MIT Lisansı ve Commons Clause altında lisanslanmıştır. Bu, şunları yapabileceğiniz anlamına gelir:

✅ İzinli:

• Görev Ustasını herhangi bir amaçla (kişisel, ticari, akademik) kullanın
• Kodu değiştirin
• Kopyaları dağıtın
• Görev Ustasını kullanarak ürünler oluşturun ve satın

❌ İzin Verilmeyen:

• Görev Ustasını kendisini satın
• Görev Ustasını barındırılan hizmet olarak sunun
• Görev Ustasına dayalı rakip ürünler oluşturun

Tam lisans metni için LICENSE dosyasına ve daha fazla bilgi için lisanslama detayları sayfasına bakın.