DEV Community

developerz.ai
developerz.ai

Posted on

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

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

Claude Task Master (CLI claudetm) is an autonomous task orchestration system built on the Claude Agent SDK. It keeps Claude working until a goal is achieved, handling planning, code changes, commit creation, pull-request opening, CI failure remediation, review comment handling, and final merge.

Core Workflow

  1. Planning - The CLI scans the repository, creates a task list, and defines success criteria.\n2. Working - For each task it modifies code, runs tests, commits, and pushes changes.\n3. PR Lifecycle - A pull request is opened, CI checks run, failures are fixed automatically, and review comments are addressed.\n4. Verification - After all criteria are met, the PR is merged (auto-merge can be enabled).

State Persistence

The system persists its state between sessions. If the CLI is stopped or the machine reboots, Claude Task Master resumes exactly where it left off, ensuring no work is lost.

Multi-Profile Coordination

Profiles isolate Claude subscriptions. An oauth profile stores a separate Claude Code configuration under ~/.claudetm/profiles/<name>/. An api-key profile injects ANTHROPIC_API_KEY and ANTHROPIC_BASE_URL. This enables parallel execution of multiple Claude accounts without credential clashes.

Extensibility via API and Webhooks

Claude Task Master exposes a REST API, an MCP server, and HMAC-signed webhooks. Other systems can dispatch tasks, monitor progress, and react to lifecycle events. For example, a CI pipeline can listen for the task_completed webhook and trigger downstream deployments.

Quick Start 

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

# Authenticate with Claude
claude login

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

The CLI creates a PR, fixes any CI failures, and merges when the tests pass. The entire process requires minimal human oversight.

When to Use Claude Task Master

  • Teams already using Claude Code that want the PR lifecycle fully automated.\n- Projects with well-scoped goals and explicit success criteria.\n- Organizations running multiple Claude subscriptions that need isolated profiles.

Open Source

Claude Task Master is MIT licensed and available on GitHub. Contributions are welcome.

GitHub repository

Top comments (0)