claude-task-master

Taskmaster: Un système de gestion des tâches pour le développement piloté par l'IA, conçu pour fonctionner de manière transparente avec n'importe quel chat AI....

Dépôt créer le : 04/03/2025

Release du : 28/02/2026 [email protected]

Forks: 2438 Watcher: 0 25686

Github: https://github.com/eyaltoledano/claude-task-master

Ajouter à une sélection :

Connectez-vous pour gérer vos sélections.

Maître de tâches: Un système de gestion des tâches pour le développement piloté par l'IA, conçu pour fonctionner de manière transparente avec n'importe quel chat AI. .

Autres Docs

Par@eyaltoledano&@RalphEcom

Un système de gestion des tâches pour le développement piloté par l'IA avec Claude, conçu pour travailler en parfaite harmonie avec Cursor AI.

Documentation

*View Full Documentation

Pour des guides détaillés, des références API et des exemples complets, visitez notre site de documentation.

Référence rapide

La documentation suivante est également disponible dans ledocsrépertoire & #160;:

Configuration Guide- Configurer les variables d'environnement et personnaliser le Task Master
Tutorial- Guide étape par étape pour commencer avec Task Master
Command Reference- Liste complète de toutes les commandes disponibles
Task Structure- Comprendre le format et les caractéristiques des tâches
Example Interactions- Exemples d'interactions avec le Curseur commun
Migration Guide- Guide de migration vers la nouvelle structure du projet

Installation rapide pour Cursor 1.0+ (One-Click)

Remarque:Après avoir cliqué sur le lien, vous devrez toujours ajouter vos clés API à la configuration. Le lien installe le serveur MCP avec les touches placeholder que vous devrez remplacer par vos vraies touches API.

Claude Code Installation rapide

Pour les utilisateurs de Claude Code :

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

N'oubliez pas d'ajouter vos touches API à la configuration :

dans le .env racine de votre projet
dans la section "env" de votre configuration mcp pour taskmaster-ai

Exigences

Taskmaster utilise l'IA sur plusieurs commandes, et celles-ci nécessitent une clé API séparée. Vous pouvez utiliser une variété de modèles de différents fournisseurs d'IA à condition d'ajouter vos clés API. Par exemple, si vous voulez utiliser Claude 3.7, vous aurez besoin d'une clé API anthropique.

Vous pouvez définir 3 types de modèles à utiliser : le modèle principal, le modèle de recherche et le modèle de repli (au cas où le modèle principal ou la recherche échouent). Quel que soit le modèle que vous utilisez, sa clé API fournisseur doit être présente dans mcp.json ou .env.

Au moins un (1) des éléments suivants est requis:

Clé API anthropique (API Claude)
Clé API OpenAI
Clé API Google Gemini
Clé API perplexité (pour le modèle de recherche)
xAI API Key (pour la recherche ou le modèle principal)
OpenRouter API Key (pour la recherche ou le modèle principal)
Claude Code (aucune clé API requise - exige Claude Code CLI)
Codex CLI (OAuth via l'abonnement ChatGPT - nécessite Codex CLI)

L'utilisation du modèle de recherche est facultative, mais fortement recommandée. Vous aurez besoin d'au moins une clé API (sauf si vous utilisez Claude Code ou Codex CLI avec OAuth). L'ajout de toutes les clés d'API vous permet de basculer parfaitement entre les fournisseurs de modèles à volonté.

Démarrer rapidement

Option 1: MCP (Recommandé)

MCP (Model Control Protocol) vous permet d'exécuter le Task Master directement depuis votre éditeur.

1. Ajouter votre configuration MCP au chemin suivant en fonction de votre éditeur

Éditeur d'images Portée Linux/macOS Path [En milliers de dollars des États-Unis] AutresCurseurMonde~/.cursor/mcp.jsonAutres%USERPROFILE%\.cursor\mcp.jsonAutresmcpServersAutres Projet<project_folder>/.cursor/mcp.jsonAutres<project_folder>\.cursor\mcp.jsonAutresmcpServersAutres AutresPlanche à voileMonde~/.codeium/windsurf/mcp_config.jsonAutres%USERPROFILE%\.codeium\windsurf\mcp_config.jsonAutresmcpServersAutres AutresCode VSProjet<project_folder>/.vscode/mcp.jsonAutres<project_folder>\.vscode\mcp.jsonAutresserversAutres AutresQ CLIMonde~/.aws/amazonq/mcp.jsonC'est vraimcpServersAutres

Configuration manuelle Curseur & Windsurf & Q Développeur CLI (mcpServers)

{
  "mcpServers": {
    "task-master-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        // "TASK_MASTER_TOOLS": "all", // Options: "all", "standard", "core", or comma-separated list of tools
        "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"
      }
    }
  }
}

RemplacerYOUR_…_KEY_HEREavec vos vraies clés API. Vous pouvez enlever les clés que vous n'utilisez pas.

RemarqueSi vous voyez0 tools enableddans les paramètres MCP, redémarrez votre éditeur et vérifiez que vos clés API sont correctement configurées.

Code VS (servers+type)

{
  "servers": {
    "task-master-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        // "TASK_MASTER_TOOLS": "all", // Options: "all", "standard", "core", or comma-separated list of tools
        "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"
    }
  }
}

RemplacerYOUR_…_KEY_HEREavec vos vraies clés API. Vous pouvez enlever les clés que vous n'utilisez pas.

2. (Curseur seulement) Activer le MCP de Taskmaster

Ouvrir les paramètres du curseur (Ctrl+Shift+J) Cliquez sur l'onglet MCP sur la gauche

3. (Facultatif) Configurez les modèles que vous souhaitez utiliser

Dans le volet de chat AI de votre éditeur, dites:

Change the main, research and fallback models to <model_name>, <model_name> and <model_name> respectively.

Par exemple, pour utiliser Claude Code (aucune clé API requise) :

Change the main model to claude-code/sonnet

Table of available modelsAutresClaude Code setup

4. Initialiser le maître de tâche

Dans le volet de chat AI de votre éditeur, dites:

Initialize taskmaster-ai in my project

5. Assurez-vous d'avoir un PRD (Recommandé)

Pournouveaux projets: Créez votre PRD à.taskmaster/docs/prd.txt. Pourprojets existants: Vous pouvez utiliserscripts/prd.txtou migrer avectask-master migrate

Un exemple de modèle PRD est disponible après initialisation dans.taskmaster/templates/example_prd.txt.

[!NOTE] Bien qu'un PRD soit recommandé pour des projets complexes, vous pouvez toujours créer des tâches individuelles en demandant « Pouvez-vous m'aider à mettre en œuvre [description de ce que vous voulez faire] ? » dans le chat.

Commencez toujours par un PRD détaillé.

Plus votre PRD est détaillé, mieux les tâches générées seront.

6. Commandes communes

Utilisez votre assistant AI pour :

Exigences en matière d'analyse:Can you parse my PRD at scripts/prd.txt?
Planifiez l'étape suivante :What's the next task I should work on?
Mettre en œuvre une tâche :Can you help me implement task 3?
Afficher plusieurs tâches & #160;:Can you show me tasks 1, 3, and 5?
Élargir une tâche :Can you help me expand task 4?
Recherche de nouvelles informations:Research the latest best practices for implementing JWT authentication with Node.js
Recherche dans le contexte:Research React Query v5 migration strategies for our current API implementation in src/api.js

More examples on how to use Task Master in chat

Option 2: Utilisation de la ligne de commande

Installation

# Install globally
npm install -g task-master-ai

# OR install locally within your project
npm install task-master-ai

Initialiser un nouveau projet

# If installed globally
task-master init

# If installed locally
npx task-master init

# Initialize project with specific rules
task-master init --rules cursor,windsurf,vscode

Cela vous incitera à obtenir des détails sur le projet et à configurer un nouveau projet avec les fichiers et la structure nécessaires.

Commandes communes

# Initialize a new project
task-master init

# Parse a PRD and generate tasks
task-master parse-prd your-prd.txt

# List all tasks
task-master list

# Show the next task to work on
task-master next

# Show specific task(s) - supports comma-separated IDs
task-master show 1,3,5

# Research fresh information with project context
task-master research "What are the latest best practices for JWT authentication?"

# Move tasks between tags (cross-tag movement)
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

# Add rules after initialization
task-master rules add windsurf,roo,vscode

Chargement de l'outil Configuration

Optimisation du chargement de l'outil MCP

Le serveur MCP de Task Master prend en charge le chargement sélectif des outils pour réduire l'utilisation des fenêtres contextuelles. Par défaut, les 36 outils sont chargés (~21 000 jetons) pour maintenir la compatibilité avec les installations existantes.

Vous pouvez optimiser les performances en configurant leTASK_MASTER_TOOLSvariable d'environnement:

Modes disponibles

Mode Outils Utilisation du contexte Cas d'utilisation - C'est quoi ? Autresall(default) Autresstandard~10 000 jetons Autrescore(oulean7:5 000 jetons AutrescustomVariable Variable

Méthodes de configuration

Méthode 1: Variable d'environnement dans la configuration de MCP

AjouterTASK_MASTER_TOOLSà votre fichier de configuration MCPenvrubrique:

{
  "mcpServers": {  // or "servers" for VS Code
    "task-master-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai"],
      "env": {
        "TASK_MASTER_TOOLS": "standard",  // Options: "all", "standard", "core", "lean", or comma-separated list
        "ANTHROPIC_API_KEY": "your-key-here",
        // ... other API keys
      }
    }
  }
}

Méthode 2 : Code Claude CLI (configuration en une seule fois)

Pour les utilisateurs de Claude Code, vous pouvez définir le mode lors de l'installation:

# Core mode example (~70% token reduction)
claude mcp add task-master-ai --scope user \
  --env TASK_MASTER_TOOLS="core" \
  -- npx -y task-master-ai@latest

# Custom tools example
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

Détails de l'outil

Outils de base (7): get_tasks,next_task,get_task,set_task_status,update_subtask,parse_prd,expand_task

Outils standard (15):Tous les outils de base plusinitialize_project,analyze_project_complexity,expand_all,add_subtask,remove_task,generate,add_task,complexity_report

Tous les outils (36) :Ensemble complet comprenant la configuration du projet, la gestion des tâches, l'analyse, les dépendances, les étiquettes, la recherche et plus

Recommandations

Nouveaux utilisateurs: Commencez par"standard"mode pour un bon équilibre
Grands projets: Utilisation"core"mode pour minimiser l'utilisation du jeton
Travaux complexes: Utilisation"all"mode ou sélection personnalisée
Compatibilité arrière: Si ce n'est pas spécifié, par défaut"all"mode

Soutien au code Claude

Task Master prend maintenant en charge les modèles Claude grâce au Claude Code CLI, qui ne nécessite aucune clé API:

Modèles:claude-code/opusetclaude-code/sonnet
Exigences: Claude Code CLI installé
Avantages: Pas de clé API nécessaire, utilise votre instance locale Claude

Learn more about Claude Code setup

Dépannage

Si`task-master init`ne répond pas

Essayez de l'exécuter directement avec Node:

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

Ou cloner le dépôt et exécuter:

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

Rejoignez notre équipe

Contributeurs

Histoire de l'étoile

Délivrance de licences

Le maître de tâche est titulaire d'une licence MIT avec la clause Commons. Cela signifie que vous pouvez:

( )Autorisé:

Utilisez le Master de tâches à n'importe quel but (personnel, commercial, académique)
Modifier le code
Distribution d'exemplaires
Créer et vendre des produits construits en utilisant Task Master

C'est vraiNon autorisé: