Task Master Liberty

Based on Task Master by @eyaltoledano & @RalphEcom

Maintained by keruru-amuri

A task management system for AI-driven development with multi-model support, designed to work seamlessly with Cursor AI. Supports Claude, Azure OpenAI (GPT-4.1), and Perplexity AI.

Requirements

At least one of the following API keys is required:

• Azure OpenAI API key (recommended for GPT-4.1)
• Anthropic API key (for Claude)
• Perplexity API key (for research tasks)

Updating

To update Task Master Liberty to the latest version:

# For global installation
npm update -g task-master-liberty

# For local project installation
npm update task-master-liberty

You can check your current version with:

npm list -g task-master-liberty  # For global installation
npm list task-master-liberty     # For local installation

Quick Start

Option 1 | MCP (Recommended):

MCP (Model Control Protocol) provides the easiest way to get started with Task Master directly in your editor.

1. Add the MCP config to your editor (Cursor recommended, but it works with other text editors):

{
	"mcpServers": {
		"taskmaster-liberty": {
			"command": "npx",
			"args": ["-y", "--package=task-master-liberty", "task-master-liberty-mcp"],
			"env": {
				"AZURE_OPENAI_API_KEY": "YOUR_AZURE_OPENAI_API_KEY_HERE",
				"AZURE_OPENAI_ENDPOINT": "YOUR_AZURE_OPENAI_ENDPOINT_HERE",
				"AZURE_OPENAI_API_VERSION": "2024-12-01-preview",
				"AZURE_OPENAI_DEPLOYMENT": "gpt-4.1",
				"PROVIDER": "azure-openai",
				"ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
				"PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
				"MODEL": "claude-3-7-sonnet-20250219",
				"PERPLEXITY_MODEL": "sonar-pro",
				"MAX_TOKENS": "64000",
				"TEMPERATURE": "0.2",
				"DEFAULT_SUBTASKS": "5",
				"DEFAULT_PRIORITY": "medium"
			}
		}
	}
}

2. Enable the MCP in your editor

3. Prompt the AI to initialize Task Master:

Can you please initialize taskmaster-liberty into my project?

4. Use common commands directly through your AI assistant:

Can you parse my PRD at scripts/prd.txt?
What's the next task I should work on?
Can you help me implement task 3?
Can you help me expand task 4?

Option 2: Using Command Line

Installation

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

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

Initialize a new project

# If installed globally
task-master-liberty init

# If installed locally
npx task-master-liberty init

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-liberty init

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

# List all tasks
task-master-liberty list

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

# Generate task files
task-master-liberty generate

Documentation

For more detailed information, check out the documentation in the docs directory:

• Configuration Guide - Set up environment variables and customize Task Master
• Tutorial - Step-by-step guide to getting started with Task Master
• Command Reference - Complete list of all available commands
• Task Structure - Understanding the task format and features
• Example Interactions - Common Cursor AI interaction examples

Troubleshooting

If task-master-liberty init doesn't respond:

Try running it with Node directly:

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

Or clone the repository and run:

git clone https://github.com/keruru-amuri/task-master-liberty.git
cd task-master-liberty
node scripts/init.js

Features

• Multi-Model Support: Choose between Azure OpenAI (GPT-4.1), Claude, and Perplexity AI
• Provider Selection: Set your preferred AI provider through environment variables
• Research Capabilities: Use Perplexity AI for research-backed tasks
• Fallback Mechanisms: Automatically fall back to available models if the preferred one is unavailable
• Comprehensive Error Handling: User-friendly error messages for each provider
• Seamless Integration: Works with Cursor AI and other text editors through MCP

Azure OpenAI Integration

Task Master Liberty includes full support for Azure OpenAI's GPT-4.1 model. To use Azure OpenAI:

1. Set up your Azure OpenAI resource and deploy the GPT-4.1 model
2. Configure the following environment variables:

   AZURE_OPENAI_API_KEY=your_azure_openai_api_key
   AZURE_OPENAI_ENDPOINT=https://your-resource-name.openai.azure.com
   AZURE_OPENAI_API_VERSION=2024-12-01-preview
   AZURE_OPENAI_DEPLOYMENT=gpt-4.1
   PROVIDER=azure-openai

3. Task Master Liberty will use Azure OpenAI for all operations

You can also keep Anthropic and Perplexity API keys configured as fallbacks.

Known Issues

• When installing the package, you might see a deprecation warning for node-domexception. This is related to a dependency of a dependency and doesn't affect the functionality of the package. It can be safely ignored.

Licensing

Task Master Liberty is licensed under the MIT License with Commons Clause. This means you can:

✅ Allowed:

• Use Task Master Liberty for any purpose (personal, commercial, academic)
• Modify the code
• Distribute copies
• Create and sell products built using Task Master Liberty

❌ Not Allowed:

• Sell Task Master Liberty itself
• Offer Task Master Liberty as a hosted service
• Create competing products based on Task Master Liberty

See the LICENSE file for the complete license text and licensing details for more information.