Introduction

Claude Task Master is a CLI tool that automates the full development loop for Claude Code users. It takes a high-level goal, plans the work, writes code, opens pull requests, handles CI failures, and merges when everything passes. The tool persists its state, so an interruption does not lose progress.

How It Works

The workflow consists of four stages: planning, working, PR lifecycle, and verification. In the planning stage the CLI reads the repository, creates a task list, and defines success criteria. During the working stage it makes code changes, runs tests, commits, and pushes to a branch. The PR lifecycle stage opens a pull request, waits for CI checks, fixes failures, and addresses review comments. Finally, the verification stage runs the final test suite and linter before declaring the task complete.

Core Features

  • Autonomous execution until the goal is achieved or human input is required.
  • PR-based workflow that keeps all changes reviewable.
  • CI integration that automatically fixes failures and responds to review comments.
  • Mailbox system for dynamic plan updates via REST API, MCP server, or webhooks.
  • Multi-instance coordination using isolated profiles, allowing multiple Claude subscriptions to run in parallel without conflict.
  • State persistence across sessions, enabling seamless recovery after interruptions.

Integration Options

Claude Task Master exposes a REST API, an MCP server, and HMAC-signed webhooks. These endpoints let external systems dispatch tasks, monitor progress, and react to events. The CLI also supports direct Anthropic API keys or OpenRouter endpoints, providing flexibility for different deployment environments.

Example Workflow 

# Install the CLI uv tool install claude-task-master # Authenticate with Claude Code claude login # Start a task in a project directory cd my-project claudetm start "Add user authentication with tests"

The command creates a plan, opens a pull request, fixes any CI failures, and merges when the PR is approved. If the process is interrupted, running the same command resumes from the last saved state.

Benefits for Teams

Teams that already use Claude Code can automate repetitive development steps, reduce manual PR handling, and keep multiple Claude subscriptions isolated. The tool’s open-source MIT license makes it free to install via PyPI or Docker, and the REST API enables integration with existing CI pipelines or dashboards.

Getting Started

The repository is hosted on GitHub at https://github.com/developerz-ai/claude-task-master. Follow the README for installation, authentication, and configuration details. The CLI works on Python 3.10 and later, and requires the GitHub CLI for PR operations.

Conclusion

Claude Task Master provides a hands-off, PR-centric development experience that survives interruptions and supports parallel Claude instances. By automating planning, coding, testing, and merging, it lets developers focus on higher-level design while the tool handles the repetitive work. Explore the open source project and try it on your next Ruby, Python, or JavaScript feature. #ClaudeCode #DevTools