DEV Community

developerz.ai
developerz.ai

Posted on

Automating End-to-End PR Workflows with Claude Task Master

Introduction

Claude Task Master (claudetm) is a CLI tool that keeps Claude Code working until a defined goal is achieved. It plans the work, writes code, opens pull requests, handles CI failures, addresses review comments, and merges when everything passes. The tool is built on the Claude Agent SDK and is MIT licensed.

How It Works

  1. Planning - The agent reads the repository, creates a task list, and defines success criteria.
  2. Working - For each task it makes changes, runs tests, commits, and pushes to a new branch.
  3. PR Lifecycle - A pull request is opened, CI checks are awaited, failures are fixed, and review comments are addressed.
  4. Verification - After all criteria are met the PR is merged automatically.

The state is persisted between sessions, so interruptions do not lose progress. Multiple Claude subscriptions can run in parallel using isolated profiles.

Core Features

  • Autonomous execution until the goal is met.
  • Full PR lifecycle automation.
  • CI integration with automatic failure handling.
  • Mailbox system for dynamic plan updates via REST API, MCP server, or webhooks.
  • Multi-instance coordination through isolated profiles.
  • State persistence across interruptions.

Integration Options

Claude Task Master exposes a REST API, an MCP server, and HMAC-signed webhooks, allowing other systems to dispatch tasks and monitor progress. It works with the direct Anthropic API or any Anthropic-compatible endpoint such as OpenRouter.

Getting Started 

# Install via uv, pip, or Docker
uv tool install claude-task-master

# Authenticate with Claude Code
claude login

# Run a task
cd your-project
claudetm start "Add user authentication with tests"
Enter fullscreen mode Exit fullscreen mode

The CLI will create a plan, execute the work, open a PR, and merge it when all checks pass.

Conclusion

Claude Task Master turns a high-level development goal into an autonomous, PR-based workflow that survives interruptions and scales across multiple Claude accounts. It is a practical tool for engineering teams that want to reduce manual overhead and keep their codebase clean. Explore the repository at https://github.com/developerz-ai/claude-task-master and start automating today.

Top comments (0)