/clickup:detail - View Task Details
Purpose
Display comprehensive information about a ClickUp task including title, description, status, priority, tags, custom fields, and recent comments.
Usage
/clickup:detail <task_id>
Behavioral Flow
When this command is invoked with a task ID:
-
Load Environment: Read ClickUp credentials from
.env:CLICKUP_TOKEN
-
Fetch Task Details:
curl -s "https://api.clickup.com/api/v2/task/${TASK_ID}" \ -H "Authorization: ${CLICKUP_TOKEN}" -
Fetch Task Comments:
curl -s "https://api.clickup.com/api/v2/task/${TASK_ID}/comment" \ -H "Authorization: ${CLICKUP_TOKEN}" -
Display Formatted Output:
╔═══════════════════════════════════════════════════════════════════╗ ║ 📋 CLICKUP TASK DETAILS ║ ╚═══════════════════════════════════════════════════════════════════╝ 🆔 Task ID: {task_id} 📌 Title: {task_name} 📊 Status: {status} {status_color_emoji} 🎯 Priority: {priority_flag} {priority_name} 🏷️ Tags: {tags_list or "None"} 👤 Assignees: {assignee_names or "Unassigned"} 📅 Due Date: {due_date or "No due date"} 🔗 URL: https://app.clickup.com/t/{task_id} ─────────────────────────────────────────────────────────────────── 📝 DESCRIPTION ─────────────────────────────────────────────────────────────────── {task_description or "No description provided."} ─────────────────────────────────────────────────────────────────── 🔧 CUSTOM FIELDS ─────────────────────────────────────────────────────────────────── {custom_field_name}: {custom_field_value} ... (If no custom fields: "No custom fields set.") ─────────────────────────────────────────────────────────────────── 💬 COMMENTS ({comment_count}) ─────────────────────────────────────────────────────────────────── [{timestamp}] @{username}: {comment_text} [{timestamp}] @{username}: {comment_text} ... (If no comments: "No comments on this task.") ═══════════════════════════════════════════════════════════════════
Field Extraction
From Task Response
| Field | JSON Path | Description |
|---|---|---|
| Task ID | id | Unique task identifier |
| Title | name | Task name/title |
| Status | status.status | Current status name |
| Status Color | status.color | Status color for emoji mapping |
| Priority | priority.priority | Priority level (1=urgent, 4=low) |
| Priority Name | priority.priority | "urgent", "high", "normal", "low" |
| Tags | tags[].name | Array of tag names |
| Assignees | assignees[].username | Array of assigned usernames |
| Due Date | due_date | Unix timestamp (convert to readable) |
| Description | description | Markdown description |
| Text Content | text_content | Plain text version |
| Custom Fields | custom_fields[] | Array of custom field objects |
From Comments Response
| Field | JSON Path | Description |
|---|---|---|
| Comment Text | comments[].comment_text | Comment content |
| Username | comments[].user.username | Author username |
| Timestamp | comments[].date | Unix timestamp |
Status Emoji Mapping
| Status | Emoji |
|---|---|
| to do | ⚪ |
| in progress | 🔵 |
| in review | 🟡 |
| complete | 🟢 |
| closed | ⚫ |
Priority Emoji Mapping
| Priority | Emoji |
|---|---|
| urgent | 🔴 |
| high | 🟠 |
| normal | 🔵 |
| low | ⚪ |
Error Handling
- Task ID not provided: Show usage instructions
- Task not found: "Task {task_id} not found. Please verify the task ID."
- API error: "Failed to fetch task details: {error_message}"
- Invalid token: "ClickUp authentication failed. Check CLICKUP_TOKEN in .env"
Related Commands
/clickup:list- List tasks from ClickUp/clickup:process <id>- Start working on a task/clickup:work <id>- Spawn subagent to work on task/clickup:done- Complete and merge task
Tool Coordination
- Bash: curl for ClickUp API calls
- Read: Load
.envfor credentials
ARGUMENTS: $ARGUMENTS