help

# /clickup:help - ClickUp Integration Commands

## Overview

ClickUp integration commands for task management, parallel development, and agent orchestration.

## Quick Reference

| Command | Purpose |
|---------|---------|
| `/clickup:list` | List tasks by status |
| `/clickup:detail <id>` | View task details & comments |
| `/clickup:process <id>` | Start task → create branch + worktree |
| `/clickup:work <id>` | Spawn agent in tmux session |
| `/clickup:attach <id>` | Attach to agent's tmux session |
| `/clickup:kill <id>` | Terminate agent tmux session |
| `/clickup:done` | Complete task → merge + update ClickUp |
| `/clickup:status` | Show active agents & worktrees |
| `/clickup:add <title> <tag>` | Create new task |
| `/clickup:comment <prompt>` | Add AI-generated comment |
| `/clickup:update <id> <prompt>` | Update task via natural language |

---

## Commands

### `/clickup:list`
**Fetch and display tasks by status**

```
/clickup:list                         # Default: "To Do" tasks
/clickup:list --status "in progress"  # Tasks being worked on
/clickup:list --status "to review"    # Tasks ready for review
```

Output shows: ID, Type (bug/story), Priority, Title

---

### `/clickup:detail <task_id>`
**View comprehensive task information**

```
/clickup:detail 86ew4b2eg
```

Shows: Title, Status, Priority, Tags, Description, Custom Fields, Comments

---

### `/clickup:process <task_id(s)>`
**Start working on task(s) - creates branch/worktrees and updates ClickUp**

```
/clickup:process 86ew4b2eg                          # Single task, create branch
/clickup:process 86ew4b2eg --worktree               # Single task with worktree
/clickup:process 86abc 86def 86ghi                  # Multiple tasks → all get worktrees
/clickup:process 86abc 86def 86ghi --work           # Process + spawn agents immediately
```

Actions:
- Creates branch: `fix/{id}-{slug}` (for bugs) or `feature/{id}-{slug}` (for stories)
- Updates ClickUp status: "To Do" → "In Progress"
- Sets branc