eyaltoledano/claude-task-master — a developer tool — sits at 28.3k GitHub stars in the Developer Tools space. An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Taskmaster: A task management system for AI-driven development, designed to work seamlessly with any AI chat.
|
Docs
By @eyaltoledano & @RalphEcom
A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.
Documentation
📚 View Full Documentation
Quick Links
Quick Start Guide
Installation
API Keys & Providers
Supported Editors
MCP Tools Reference
CLI Commands Reference
Task Structure
Task Dependencies
Tags & Workstreams
Research Command
Loop Command
AI Providers Overview
Team Collaboration
Best Practices
FAQ
Changelog
More from Hamster
Hamster Studio
Product & Engineering Methods
Product & Engineering Skills
Hamster Pricing
Quick Install for Cursor 1.0+ (One-Click)
Note: After clicking the link, you'll still need to add your API keys to the configuration. The link installs the MCP server with placeholder keys that you'll need to replace with your actual API keys.
Claude Code Quick Install
For Claude Code users:
claude mcp add taskmaster-ai -- npx -y task-master-ai
Don't forget to add your API keys to the configuration:
in the root .env of your Project
in the "env" section of your mcp config for taskmaster-ai
Requirements
Taskmaster utilizes AI across several commands, and those require a separate API key. You can use a variety of models from different AI providers provided you add your API keys. For example, if you want to use Claude 3.7, you'll need an Anthropic API key.
You can define 3 types of models to be used: the main model, the research model, and the fallback model (in case either the main or research fail). Whatever model you use, its provider API key must be present in either mcp.json or .env.
At least one (1) of the following is required:
Anthropic API key (Claude API)
OpenAI API key
Google Gemini API key
Perplexity API key (for research model)
xAI API Key (for research or main model)
OpenRouter API Key (for research or main model)
Claude Code (no API key required - requires Claude Code CLI)
Codex CLI (OAuth via ChatGPT subscription - requires Codex CLI)
Using the research model is optional but highly recommended. You will need at least ONE API key (unless using Claude Code or Codex CLI with OAuth). Adding all API keys enables you to seamlessly switch between model providers at will.
Quick Start
Option 1: MCP (Recommended)
MCP (Model Control Protocol) lets you run Task Master directly from your editor.
1. Add your MCP config at the following path depending on your editor
🔑 Replace YOUR_…_KEY_HERE with your real API keys. You can remove keys you don't use.
2. (Cursor-only) Enable Taskmaster MCP
Open Cursor Settings (Ctrl+Shift+J) ➡ Click on MCP tab on the left ➡ Enable task-master-ai with the toggle
3. (Optional) Configure the models you want to use
In your editor's AI chat pane, say:
Change the main, research and fallback models to <model_name>, <model_name> and <model_name> respectively.
For example, to use Claude Code (no API key required):
Change the main model to claude-code/sonnet
Table of available models | Claude Code setup
4. Initialize Task Master
In your editor's AI chat pane, say:
Initialize taskmaster-ai in my project
5. Make sure you have a PRD (Recommended)
For new projects: Create your PRD at .taskmaster/docs/prd.txt.
For existing projects: You can use scripts/prd.txt or migrate with task-master migrate
An example PRD template is available after initialization in .taskmaster/templates/example_prd.txt.
[!NOTE]
While a PRD is recommended for complex projects, you can always create individual tasks by asking "Can you help me implement [description of what you want to do]?" in chat.
Always start with a detailed PRD.
The more detailed your PRD, the better the generated tasks will be.
6. Common Commands
Use your AI assistant to:
Parse requirements: Can you parse my PRD at scripts/prd.txt?
Plan next step: What's the next task I should work on?
Implement a task: Can you help me implement task 3?
View multiple tasks: Can you show me tasks 1, 3, and 5?
Expand a task: Can you help me expand task 4?
Research fresh information: Research the latest best practices for implementing JWT authentication with Node.js
Research with context: 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: Using Command Line
Installation
# Install globally
npm install -g task-master-ai
# OR install locally within your project
npm install task-master-ai
Initialize a new project
# 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
This will prompt you for project details and set up a new project with the necessary files and structure.
Common Commands
# 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
Tool Loading Configuration
Optimizing MCP Tool Loading
Task Master's MCP server supports selective tool loading to reduce context window usage. By default, all 36 tools are loaded (~21,000 tokens) to maintain backward compatibility with existing installations.
You can optimize performance by configuring the TASK_MASTER_TOOLS environment variable:
Available Modes
Mode
Tools
Context Usage
Use Case
all (default)
36
~21,000 tokens
Complete feature set - all tools available
standard
15
~10,000 tokens
Common task management operations
core (or lean)
7
~5,000 tokens
Essential daily development workflow
custom
Variable
Variable
Comma-separated list of specific tools
Configuration Methods
Method 1: Environment Variable in MCP Configuration
Add TASK_MASTER_TOOLS to your MCP configuration file's env section:
{
"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
}
}
}
}
Method 2: Claude Code CLI (One-Time Setup)
For Claude Code users, you can set the mode during 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
Standard Tools (15): All core tools plus initialize_project, analyze_project_complexity, expand_all, add_subtask, remove_task, generate, add_task, complexity_report
All Tools (36): Complete set including project setup, task management, analysis, dependencies, tags, research, and more
Recommendations
New users: Start with "standard" mode for a good balance
Large projects: Use "core" mode to minimize token usage
Complex workflows: Use "all" mode or custom selection
Backward compatibility: If not specified, defaults to "all" mode
Claude Code Support
Task Master now supports Claude models through the Claude Code CLI, which requires no API key:
Models: claude-code/opus and claude-code/sonnet
Requirements: Claude Code CLI installed
Benefits: No API key needed, uses your local Claude instance
How active is development on eyaltoledano/claude-task-master?
The most recent commit recorded on eyaltoledano/claude-task-master was 6 months ago, based on the GitHub push timestamp. The repository has 2.6k forks — one of the better signals of community interest.
How many stars does eyaltoledano/claude-task-master have?
eyaltoledano/claude-task-master has 28.3k GitHub stars — refresh the page for the live number, or check github.com/eyaltoledano/claude-task-master. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is eyaltoledano/claude-task-master open source?
TopGit's metadata for eyaltoledano/claude-task-master does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary — verify by opening the LICENSE file directly.
What else is in the Developer Tools space?
eyaltoledano/claude-task-master is tracked by TopGit under the Developer Tools category, alongside 12 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What topics is eyaltoledano/claude-task-master associated with?
Where can I see eyaltoledano/claude-task-master in action?
The project maintains a homepage at https://tryhamster.com. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about eyaltoledano/claude-task-master?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/eyaltoledano/claude-task-master is the definitive source.
Read full README in the tab above.
Is claude-task-master worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of claude-task-master.