npm package Open Source Zero Dependencies

Turn ClickUp tasks into
pull requests

Write a task in ClickUp. clawdup picks it up, uses Claude Code to implement the changes, and opens a PR on GitHub — ready for your review. No manual coding required.

$ npm install -g clawdup click to copy
10x
Faster task turnaround

Tasks move from "to do" to "in review" in minutes, not hours.

0
Runtime dependencies

Built entirely on Node.js built-ins and CLI tools. Nothing extra to install.

24/7
Continuous automation

Polls ClickUp every 30 seconds. Tasks get implemented even while you sleep.

Before & After clawdup

See how clawdup transforms your development workflow.

Without clawdup
  1. Read ClickUp task
  2. Create a git branch manually
  3. Write the code yourself
  4. Commit and push
  5. Create PR on GitHub
  6. Update ClickUp status
  7. Link PR to task manually
~30–60 min per task
With clawdup
  1. Write a clear task in ClickUp
  2. clawdup does everything else
  3. Review the PR
~3–5 min of your time

How It Works

From task description to merged pull request, fully automated.

📋

ClickUp Task

Write a task with a clear description

🔌

Git Branch

Auto-created and linked to the task

🤖

Claude Code

AI implements the task changes

🚀

GitHub PR

PR created for human review

Review & Approve

Human reviews the PR

🔗

Auto Merge

PR merged, task completed

Built for Real Workflows

Everything you need for automated task-to-PR workflows, nothing you don't.

Zero Runtime Dependencies

Built entirely on Node.js built-ins and CLI tools. No bloated dependency tree to worry about.

🔄

Full Lifecycle Management

From polling ClickUp to merging PRs — every step is handled automatically.

🤖

Claude Code Integration

Powered by Anthropic's Claude Code for AI-driven implementation with streaming output.

🔗

ClickUp Auto-Linking

Branches, commits, and PRs include task IDs for automatic two-way linking in ClickUp.

📁

Monorepo Support

Each workspace package gets its own config pointing to a different ClickUp list.

🔒

Security First

Task content is treated as untrusted with prompt injection detection and content sanitization.

🔌

Crash Recovery

Automatically recovers orphaned tasks left in progress from previous crashes.

📚

CLAUDE.md Aware

Automatically includes your project context file so Claude understands your codebase.

🛠

Programmatic API

Import individual modules for custom integrations beyond the CLI.

Who Is This For?

clawdup works for teams and solo developers who use ClickUp and GitHub.

👨‍💻

Solo Developers

Offload routine implementation tasks so you can focus on architecture and code review. Let clawdup handle the boilerplate while you handle the decisions.

👥

Small Teams

Multiply your team's output without adding headcount. Queue up tasks in ClickUp and clawdup works through them continuously — even outside business hours.

🏗

Agencies & Consultancies

Deliver faster on client projects. Write clear tasks from requirements, let clawdup generate the PRs, then review and ship. More throughput, same quality bar.

🚀

Open Source Maintainers

Triage issues into ClickUp tasks and let clawdup draft implementations. Spend your time reviewing contributions instead of writing every line yourself.

See It in Action

A single command kicks off the entire automation loop.

Terminal
$ clawdup
[info]  clawdup v1.0.0 started
[info]  Polling ClickUp list 901234567 every 30s...
[info]  Found task: CU-abc123 "Add user avatar upload"
[info]  Created branch: clickup/CU-abc123-add-user-avatar-upload
[info]  Running Claude Code...
[info]  Claude finished — 4 files changed, 127 insertions
[info]  Committed: [CU-abc123] Add user avatar upload
[info]  Pushed to origin
[info]  PR created: #42 — ready for review
[info]  Task CU-abc123 moved to in review
[info]  Returning to main, polling for next task...

Quick Start

Get up and running in under 5 minutes.

1

Install

Install globally with npm, or use npx clawdup for zero-install usage.

2

Configure

Run the setup wizard or create a .clawdup.env file with your ClickUp API token and list ID.

3

Validate

Run clawdup --check to verify your ClickUp connection, statuses, and dependencies.

4

Run

Start with clawdup. Create tasks in ClickUp and watch PRs appear on GitHub.

Terminal
# Install globally
$ npm install -g clawdup

# Or use npx (no install needed)
$ npx clawdup --init

# Run the interactive setup
$ clawdup --setup

# Validate your configuration
$ clawdup --check

# Start the automation
$ clawdup

Task Status Lifecycle

clawdup manages task statuses automatically through each phase.

Status Type Triggered By What Happens
to do Open Human Task is ready to be picked up
in progress Active Automation clawdup is working on the task
in review Active Automation PR created, awaiting human review
approved Active Human Human approved, automation will merge
require input Active Automation Needs clarification (see task comment)
blocked Active Automation An error occurred during processing
complete Closed Automation PR merged, task done

Simple Configuration

Two files, a few lines each. That's all you need.

.clawdup.env

Required settings for ClickUp connection.

# Required
CLICKUP_API_TOKEN=pk_xxx
CLICKUP_LIST_ID=your-list-id

# Optional
BASE_BRANCH=main
POLL_INTERVAL_MS=30000
CLAUDE_TIMEOUT_MS=600000
LOG_LEVEL=info

clawdup.config.mjs

Optional Claude Code customization.

export default {
  // Extra instructions for Claude
  prompt: `
After making changes, run
"npm run lint" to check.
Always write tests.
  `.trim(),

  // Extra CLI args for claude
  // claudeArgs: ["--model",
  //   "opus"]
};

Prerequisites

What you need before getting started.

🎯

Node.js 18+

Required for native fetch support. The runtime for clawdup.

🤖

Claude Code CLI

Anthropic's AI coding assistant. Install with npm install -g @anthropic-ai/claude-code.

🐙

GitHub CLI (gh)

Used to create and merge pull requests. Install from cli.github.com.

🔌

Git + ClickUp Account

Git with push access to your repo, and a ClickUp account (free tier works).

Stop context-switching.
Start shipping.

clawdup bridges the gap between your task board and your codebase. Write the task, review the PR — skip everything in between.

npm install -g clawdup