Automating PR-Based Development with Claude Task Master

Claude Task Master ( claudetm ) is a command-line tool that keeps Claude working until a specified goal is achieved. It is built on the Claude Agent SDK and follows a fully PR-based workflow. This article explains how the tool orchestrates planning, execution, CI handling, and verification, and how it can be extended through its REST API and webhook system.

The tool operates through a clear sequence of stages:

Each stage is designed to be hands-off, allowing developers to set a goal and let the system handle the details.

A key advantage is the persistence of state between sessions. If a machine restarts or the process is interrupted, claudetm resumes exactly where it left off. This is achieved by storing the current task list, plan, and PR identifiers on disk. No manual re-execution is required.

Claude Task Master supports multiple isolated profiles. A profile can be an oauth profile that uses a separate Claude Code configuration directory, or an api-key profile that injects a direct Anthropic API key and base URL. This enables teams to run several Claude subscriptions in parallel without credential clashes.

# Example of using a profile claudetm --profile myteam start "Implement OAuth login flow" Enter fullscreen mode Exit fullscreen mode Extensibility via REST API and Webhooks Beyond the CLI, the tool exposes a REST API and an MCP server that allow external systems to dispatch tasks and receive updates. Webhooks can be HMAC-signed to provide secure callbacks. This makes it possible to integrate Claude Task Master into CI pipelines, dashboards, or custom bots.

# Dispatch a task via the REST API (curl example) curl -X POST https://localhost:8000/api/tasks \ -H "Content-Type: application/json" \ -d '{"goal":"Add rate limiting middleware"}' Enter fullscreen mode Exit fullscreen mode Installation Claude Task Master is MIT licensed and can be installed via PyPI, uv, or Docker. The minimum Python version is 3.10.

uv tool install claude-task-master # or pip install claude-task-master Enter fullscreen mode Exit fullscreen mode When to Use Claude Task Master The tool is ideal for teams that already use Claude Code and want to automate the entire PR lifecycle. It works best for well-scoped goals that can be verified against explicit success criteria. Teams running multiple Claude subscriptions benefit from the profile isolation feature.

Claude Task Master provides a robust, autonomous solution for PR-based development. By handling planning, execution, CI failures, review comments, and merging, it frees developers to focus on design and architecture. Its extensible API and profile system make it suitable for a wide range of engineering workflows.

For more details and to contribute, visit the repository: https://github.com/developerz-ai/claude-task-master