# CU-CLI Command Reference

A complete reference for all CU-CLI commands. Set your API token once:

```bash
export CU_API_TOKEN=your_clickup_api_token
```

---

## `cu create`

Create a new task in a list.

**Usage:**
```bash
cu create "Task name" --list-id <id> [options]
```

**Options:**
| Flag | Description |
|------|-------------|
| `--list-id` | **(required)** The list ID to create the task in |
| `--priority` | Priority: 1 (Urgent), 2 (High), 3 (Normal), 4 (Low) |
| `--due-date` | Unix timestamp for due date |
| `--assignee` | User email or ID to assign |
| `--description` | Task description text |

**Example:**
```bash
cu create "Ship the prototype" --list-id 123 --priority 2
```

---

## `cu list`

List tasks from a specific list.

**Usage:**
```bash
cu list --list-id <id> [options]
```

**Options:**
| Flag | Description |
|------|-------------|
| `--list-id` | **(required)** The list ID to fetch tasks from |
| `--status` | Filter by status name (e.g., "open", "In Progress") |
| `--assignee` | Filter by assignee email or ID |

**Example:**
```bash
cu list --list-id 123 --status open
```

---

## `cu find`

Search for tasks matching a query string across your workspace.

**Usage:**
```bash
cu find -q "<query>" [options]
```

**Options:**
| Flag | Description |
|------|-------------|
| `-q`, `--query` | **(required)** Search query string |
| `--list-id` | Limit search to a specific list |
| `--team-id` | Workspace ID to search in |

**Example:**
```bash
cu find -q "budget" --team-id 9014416713
```

---

## `cu task get`

Get full details for a specific task.

**Usage:**
```bash
cu task get <task-id>
```

**Example:**
```bash
cu task get abc123xyz
```

---

## `cu task update`

Update task properties.

**Usage:**
```bash
cu task update <task-id> [options]
```

**Options:**
| Flag | Description |
|------|-------------|
| `--status` | New status name (e.g., "In Progress", "Complete") |
| `--priority` | New priority (1=Urgent, 2=High, 3=Normal, 4=Low) |
| `--due-date` | Unix timestamp for due date |
| `--name` | New task name |
| `--description` | New description text |

**Example:**
```bash
cu task update abc123xyz --status "In Progress" --priority 1
```

---

## `cu task delete`

Permanently delete a task.

**Usage:**
```bash
cu task delete <task-id> [options]
```

**Options:**
| Flag | Description |
|------|-------------|
| `--force` | Skip the confirmation prompt |

**Example:**
```bash
# With confirmation prompt:
cu task delete abc123xyz

# Skip confirmation:
cu task delete abc123xyz --force
```

---

## `cu comment list`

List all comments on a task.

**Usage:**
```bash
cu comment list <task-id>
```

**Example:**
```bash
cu comment list abc123xyz
```

---

## `cu comment add`

Add a comment to a task.

**Usage:**
```bash
cu comment add <task-id> -m "<message>"
```

**Options:**
| Flag | Description |
|------|-------------|
| `-m`, `--message` | **(required)** Comment text |

**Example:**
```bash
cu comment add abc123xyz -m "Looks good, ready to ship!"
```

---

## `cu tag add`

Add a tag to a task.

**Usage:**
```bash
cu tag add <task-id> -t "<tag-name>"
```

**Options:**
| Flag | Description |
|------|-------------|
| `-t`, `--tag` | **(required)** Tag name to add |

**Example:**
```bash
cu tag add abc123xyz -t "urgent"
```

---

## `cu tag remove`

Remove a tag from a task.

**Usage:**
```bash
cu tag remove <task-id> -t "<tag-name>"
```

**Options:**
| Flag | Description |
|------|-------------|
| `-t`, `--tag` | **(required)** Tag name to remove |

**Example:**
```bash
cu tag remove abc123xyz -t "urgent"
```

---

## `cu move`

Move a task to a different list.

**Usage:**
```bash
cu move <task-id> --to-list <list-id>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--to-list` | **(required)** Target list ID |

**Example:**
```bash
cu move abc123xyz --to-list 456
```

---

## `cu space list`

List all spaces in a workspace.

**Usage:**
```bash
cu space list --team-id <id>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--team-id` | **(required)** Workspace/team ID |

**Example:**
```bash
cu space list --team-id 9014416713
```


## `cu space create`

Create a new space in a workspace.

**Usage:**
```bash
cu space create --team-id <id> --name "<name>"
```

**Options:**
| Flag | Description |
|------|-------------|
| `--team-id` | **(required)** Workspace/team ID |
| `--name` | **(required)** Space name |

**Example:**
```bash
cu space create --team-id 9014416713 --name "Q4 Projects"
```

---

## `cu space update`

Update a space's name.

**Usage:**
```bash
cu space update --space-id <id> --name "<name>"
```

**Options:**
| Flag | Description |
|------|-------------|
| `--space-id` | **(required)** Space ID |
| `--name` | New space name |

**Example:**
```bash
cu space update --space-id 789 --name "Q4 Launch"
```

---

## `cu space delete`

Delete a space and all its contents (folders and lists).

**Usage:**
```bash
cu space delete --space-id <id>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--space-id` | **(required)** Space ID |

**Example:**
```bash
cu space delete --space-id 789
```


---

## `cu space folders`

List all folders in a space.

**Usage:**
```bash
cu space folders <space-id>
```

**Example:**
```bash
cu space folders 789
```

---

## `cu space lists`

List all lists in a folder.

**Usage:**
```bash
cu space lists <folder-id>
```

**Example:**
```bash
cu space lists 101
```

---



## `cu folder`

Manage folders within a space.

### `cu folder create`

Create a new folder in a space.

```bash
cu folder create --space-id <id> --name "<name>"
```

| Flag | Description |
|------|-------------|
| `--space-id` | **(required)** Parent space ID |
| `--name` | **(required)** Folder name |

**Example:**
```bash
cu folder create --space-id 789 --name "Backend"
```

### `cu folder get`

Get details for a specific folder.

```bash
cu folder get --folder-id <id>
```

| Flag | Description |
|------|-------------|
| `--folder-id` | **(required)** Folder ID |

**Example:**
```bash
cu folder get --folder-id 123456
```

### `cu folder update`

Update a folder's name.

```bash
cu folder update --folder-id <id> --name "<name>"
```

| Flag | Description |
|------|-------------|
| `--folder-id` | **(required)** Folder ID |
| `--name` | New folder name |

**Example:**
```bash
cu folder update --folder-id 123456 --name "Frontend v2"
```

### `cu folder delete`

Delete a folder.

```bash
cu folder delete --folder-id <id>
```

| Flag | Description |
|------|-------------|
| `--folder-id` | **(required)** Folder ID |

**Example:**
```bash
cu folder delete --folder-id 123456
```

## `cu list-create`

Create a new list inside a space or folder.

**Usage:**
```bash
cu list-create --name "<name>" --space-id <id> [options]
```

**Options:**
| Flag | Description |
|------|-------------|
| `--name` | **(required)** List name |
| `--space-id` | **(required)** Parent space ID |
| `--folder-id` | Optional parent folder ID |

**Example:**
```bash
cu list-create --name "Sprint 23" --space-id 789
```

---

## `cu view list`

List all views available for a list.

**Usage:**
```bash
cu view list <list-id>
```

**Example:**
```bash
cu view list 123
```


## `cu view team`

List all views available in a workspace.

**Usage:**
```bash
cu view team --team-id <id>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--team-id` | **(required)** Workspace/team ID |

**Example:**
```bash
cu view team --team-id 9014416713
```


---

## `cu info time`

Show how long a task has been in its current status.

**Usage:**
```bash
cu info time <task-id>
```

**Example:**
```bash
cu info time abc123xyz
```

---

## `cu workspace list`

Browse your ClickUp org structure — spaces, folders, and lists.

**Usage:**
```bash
cu workspace list
```

---

## Environment Setup

Set your ClickUp API token:
```bash
export CU_API_TOKEN=pk_XXXXXXXXXXXXX
```

Find your API token at: [ClickUp Settings → Apps](https://app.clickup.com/settings/apps)

---

## Quick Reference

| Command | Description |
|---------|-------------|
| `cu create "name" --list-id <id>` | Create a task |
| `cu list --list-id <id>` | List tasks in a list |
| `cu find -q "<query>"` | Search tasks |
| `cu task get <id>` | Get task details |
| `cu task update <id> --status "Done"` | Update task |
| `cu task delete <id> --force` | Delete task |
| `cu comment list <id>` | List comments |
| `cu comment add <id> -m "text"` | Add comment |
| `cu tag add <id> -t "tag"` | Add tag |
| `cu tag remove <id> -t "tag"` | Remove tag |
| `cu move <id> --to-list <id>` | Move task |
| `cu space list --team-id <id>` | List spaces |
| `cu space folders <id>` | List folders |
| `cu space lists <id>` | List lists in folder |
| `cu list-create --name "x" --space-id <id>` | Create list |
| `cu view list <id>` | List views |
| `cu info time <id>` | Time in status |
| `cu workspace list` | Browse workspace |---

## `cu list-delete`

Delete a list permanently.

**Usage:**
```bash
cu list-delete --list-id <id> [options]
```

**Options:**
| Flag | Description |
|------|-------------|
| `--list-id` | **(required)** The list ID to delete |
| `--force` | Skip the confirmation prompt |

**Example:**
```bash
# With confirmation prompt:
cu list-delete --list-id 123

# Skip confirmation:
cu list-delete --list-id 123 --force
```

---

## `cu mcp` — MCP (Model Context Protocol) Commands

CU-CLI includes MCP commands for extended ClickUp capabilities via the ClickUp MCP Server.
These commands use JSON-RPC 2.0 over HTTP to call the ClickUp MCP endpoint.

**Note:** MCP commands require OAuth setup with ClickUp. Set up your MCP server at [developer.clickup.com](https://developer.clickup.com).

---

### `cu mcp list-tools`

List all available MCP tools (discovery command).

**Usage:**
```bash
cu mcp list-tools
```

---

### `cu mcp search-workspace`

Search across the entire workspace (tasks, lists, folders, docs).

**Usage:**
```bash
cu mcp search-workspace --query "<text>"
```

**Options:**
| Flag | Description |
|------|-------------|
| `--query` | **(required)** Search query string |

**Example:**
```bash
cu mcp search-workspace --query "Q4 Marketing Launch"
```

---

### `cu mcp search-tasks-by-type`

Search tasks filtered by task type.

**Usage:**
```bash
cu mcp search-tasks-by-type --type <type>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--type` | **(required)** Task type to filter by |

**Example:**
```bash
cu mcp search-tasks-by-type --type "bug"
```

---

### `cu mcp search-tasks-by-tag`

Search tasks filtered by tag.

**Usage:**
```bash
cu mcp search-tasks-by-tag --tag <tag>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--tag` | **(required)** Tag name to filter by |

**Example:**
```bash
cu mcp search-tasks-by-tag --tag "urgent"
```

---

### `cu mcp create-task`

Create a new task via MCP (supports more fields than the base `create` command).

**Usage:**
```bash
cu mcp create-task --list-id <id> --name "<name>" [options]
```

**Options:**
| Flag | Description |
|------|-------------|
| `--list-id` | **(required)** Parent list ID |
| `--name` | **(required)** Task name |
| `--description` | Task description |
| `--assignee` | Assignee email or user ID |
| `--due-date` | Due date (YYYY-MM-DD) |
| `--priority` | Priority: 1=Urgent, 2=High, 3=Normal, 4=Low |

**Example:**
```bash
cu mcp create-task --list-id 123 --name "Draft blog post" --assignee "user@email.com" --priority 2
```

---

### `cu mcp get-task`

Get full details for a specific task.

**Usage:**
```bash
cu mcp get-task <task-id>
```

**Example:**
```bash
cu mcp get-task abc123xyz
```

---

### `cu mcp update-task`

Update an existing task's properties.

**Usage:**
```bash
cu mcp update-task --task-id <id> [options]
```

**Options:**
| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID to update |
| `--status` | New status name |
| `--name` | New task name |
| `--description` | New description |
| `--priority` | New priority (1=Urgent, 2=High, 3=Normal, 4=Low) |

**Example:**
```bash
cu mcp update-task --task-id abc123xyz --status "In Progress" --priority 1
```

---

### `cu mcp set-custom-fields`

Set custom fields on a task.

**Usage:**
```bash
cu mcp set-custom-fields --task-id <id> --fields <json>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID |
| `--fields` | **(required)** JSON array of field objects `[{"id":"field_id","value":"value"}]` |

**Example:**
```bash
cu mcp set-custom-fields --task-id abc123xyz --fields '[{"id":"abc","value":"4.07"}]'
```

---

### `cu mcp delete-task`

Delete a task permanently (via MCP endpoint).

**Usage:**
```bash
cu mcp delete-task --task-id <id>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID to delete |

**Example:**
```bash
cu mcp delete-task --task-id abc123xyz
```

---

### `cu mcp create-bulk-tasks`

Create multiple tasks at once via a single API call.

**Usage:**
```bash
cu mcp create-bulk-tasks --list-id <id> --tasks <json>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--list-id` | **(required)** Target list ID |
| `--tasks` | **(required)** JSON array of task objects |

**Example:**
```bash
cu mcp create-bulk-tasks --list-id 123 --tasks '[{"name":"Task 1"},{"name":"Task 2"}]'
```

---

### `cu mcp update-bulk-tasks`

Update multiple tasks at once (status, assignee, due date, etc.).

**Usage:**
```bash
cu mcp update-bulk-tasks --task-ids <json> --updates <json>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--task-ids` | **(required)** JSON array of task IDs |
| `--updates` | **(required)** JSON object with update fields |

**Example:**
```bash
cu mcp update-bulk-tasks --task-ids '["id1","id2"]' --updates '{"status":"in review"}'
```

---

### `cu mcp get-comments`

Get all comments on a task.

**Usage:**
```bash
cu mcp get-comments --task-id <id>
```

**Example:**
```bash
cu mcp get-comments --task-id abc123xyz
```

---

### `cu mcp get-threaded-replies`

Get threaded replies under a parent comment.

**Usage:**
```bash
cu mcp get-threaded-replies --task-id <id> --comment-id <id>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID |
| `--comment-id` | **(required)** Parent comment ID |

**Example:**
```bash
cu mcp get-threaded-replies --task-id abc123xyz --comment-id 999
```

---

### `cu mcp add-comment`

Add a comment to a task.

**Usage:**
```bash
cu mcp add-comment --task-id <id> --message "<text>" [options]
```

**Options:**
| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID |
| `--message` | **(required)** Comment text |
| `--mention` | User email or ID to mention |

**Example:**
```bash
cu mcp add-comment --task-id abc123xyz --message "@Mark, can you review?"
```

---

### `cu mcp add-tag`

Add a tag to a task.

**Usage:**
```bash
cu mcp add-tag --task-id <id> --tag <name>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID |
| `--tag` | **(required)** Tag name to add |

**Example:**
```bash
cu mcp add-tag --task-id abc123xyz --tag "urgent"
```

---

### `cu mcp remove-tag`

Remove a tag from a task.

**Usage:**
```bash
cu mcp remove-tag --task-id <id> --tag <name>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID |
| `--tag` | **(required)** Tag name to remove |

**Example:**
```bash
cu mcp remove-tag --task-id abc123xyz --tag "backend"
```

---

### `cu mcp add-task-link`

Create a link between two tasks.

**Usage:**
```bash
cu mcp add-task-link --task-id <id> --linked-task-id <id> --link-type <type>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Primary task ID |
| `--linked-task-id` | **(required)** Task ID to link to |
| `--link-type` | **(required)** Link type: `blocks`, `blocked_by`, `relates_to` |

**Example:**
```bash
cu mcp add-task-link --task-id abc123 --linked-task-id xyz789 --link-type "blocks"
```

---

### `cu mcp remove-task-link`

Remove a link between two tasks.

**Usage:**
```bash
cu mcp remove-task-link --task-id <id> --linked-task-id <id>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Primary task ID |
| `--linked-task-id` | **(required)** Linked task ID to unlink |

**Example:**
```bash
cu mcp remove-task-link --task-id abc123 --linked-task-id xyz789
```

---

### `cu mcp add-dependency`

Add a dependency relationship between tasks (blocking/blocked).

**Usage:**
```bash
cu mcp add-dependency --task-id <id> --dependency-task-id <id>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID |
| `--dependency-task-id` | **(required)** Task ID this depends on |

**Example:**
```bash
cu mcp add-dependency --task-id abc123 --dependency-task-id xyz789
```

---

### `cu mcp remove-dependency`

Remove a dependency relationship between tasks.

**Usage:**
```bash
cu mcp remove-dependency --task-id <id> --dependency-task-id <id>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID |
| `--dependency-task-id` | **(required)** Dependency task ID to remove |

**Example:**
```bash
cu mcp remove-dependency --task-id abc123 --dependency-task-id xyz789
```

---

### `cu mcp move-task`

Move a task to a different list.

**Usage:**
```bash
cu mcp move-task --task-id <id> --list-id <id>
```

**Options:**
| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID |
| `--list-id` | **(required)** Target list ID |

**Example:**
```bash
cu mcp move-task --task-id abc123xyz --list-id 456
```

---

## Quick Reference (Updated)

| Command | Description |
|---------|-------------|
| `cu create "name" --list-id <id>` | Create a task |
| `cu list --list-id <id>` | List tasks in a list |
| `cu find -q "<query>"` | Search tasks |
| `cu task get <id>` | Get task details |
| `cu task update <id> --status "Done"` | Update task |
| `cu task delete <id> --force` | Delete task |
| `cu comment list <id>` | List comments |
| `cu comment add <id> -m "text"` | Add comment |
| `cu tag add <id> -t "tag"` | Add tag |
| `cu tag remove <id> -t "tag"` | Remove tag |
| `cu move <id> --to-list <id>` | Move task |
| `cu space list --team-id <id>` | List spaces |
| `cu space folders <id>` | List folders |
| `cu space lists <id>` | List lists in folder |
| `cu list-create --name "x" --space-id <id>` | Create list |
| `cu list-delete --list-id <id>` | Delete list |
| `cu view list <id>` | List views |
| `cu info time <id>` | Time in status |
| `cu space create --team-id <id> --name "<name>"` | Create space |
| `cu space update --space-id <id> --name "<name>"` | Update space |
| `cu space delete --space-id <id>` | Delete space |
| `cu folder create --space-id <id> --name "<name>"` | Create folder |
| `cu folder get --folder-id <id>` | Get folder |
| `cu folder update --folder-id <id> --name "<name>"` | Update folder |
| `cu folder delete --folder-id <id>` | Delete folder |
| `cu view team --team-id <id>` | List workspace views |
| `cu workspace list` | Browse workspace |
| `cu mcp list-tools` | List MCP tools |
| `cu mcp create-task --list-id <id> --name "<name>"` | Create task (MCP) |
| `cu mcp get-task <id>` | Get task (MCP) |
| `cu mcp update-task --task-id <id> --status "Done"` | Update task (MCP) |
| `cu mcp delete-task --task-id <id>` | Delete task (MCP) |
| `cu mcp get-comments --task-id <id>` | Get comments (MCP) |
| `cu mcp add-comment --task-id <id> --message "<text>"` | Add comment (MCP) |
| `cu mcp add-tag --task-id <id> --tag <name>` | Add tag (MCP) |
| `cu mcp remove-tag --task-id <id> --tag <name>` | Remove tag (MCP) |
| `cu mcp add-task-link --task-id <id> --linked-task-id <id> --link-type <type>` | Link tasks |
| `cu mcp add-dependency --task-id <id> --dependency-task-id <id>` | Add dependency |
| `cu mcp move-task --task-id <id> --list-id <id>` | Move task (MCP) |
| `cu mcp search-workspace --query "<text>"` | Workspace search |
| `cu mcp search-tasks-by-tag --tag <name>` | Search by tag |
| `cu mcp search-tasks-by-type --type <type>` | Search by type |
| `cu mcp create-bulk-tasks --list-id <id> --tasks <json>` | Bulk create |
| `cu mcp update-bulk-tasks --task-ids <json> --updates <json>` | Bulk update |
| `cu mcp set-custom-fields --task-id <id> --fields <json>` | Set custom fields |
| `cu mcp get-threaded-replies --task-id <id> --comment-id <id>` | Get threaded replies |
| `cu mcp remove-task-link --task-id <id> --linked-task-id <id>` | Remove task link |
| `cu mcp remove-dependency --task-id <id> --dependency-task-id <id>` | Remove dependency |


---

## `cu goal`

Manage ClickUp Goals.

### `cu goal list`

List all goals in a workspace.

```bash
cu goal list --team-id <workspace_id>
```

| Flag | Description |
|------|-------------|
| `--team-id` | **(required)** Workspace/team ID |

**Example:**
```bash
cu goal list --team-id 9014416713
```

### `cu goal create`

Create a new goal.

```bash
cu goal create --team-id <id> --name "<name>" [options]
```

| Flag | Description |
|------|-------------|
| `--team-id` | **(required)** Workspace ID |
| `--name` | **(required)** Goal name |
| `--description` | Goal description |
| `--color` | Goal color (default: #00e5ff) |

**Example:**
```bash
cu goal create --team-id 9014416713 --name "Q2 Objectives" --description "Quarter 2 goals"
```

### `cu goal delete`

Delete a goal.

```bash
cu goal delete --goal-id <id>
```

| Flag | Description |
|------|-------------|
| `--goal-id` | **(required)** Goal ID to delete |

**Example:**
```bash
cu goal delete --goal-id 4bda1d0d-8069-4120-a3fc-cf11b8f30acf
```

---

## `cu webhook`

Manage ClickUp Webhooks.

### `cu webhook list`

List all webhooks for a workspace.

```bash
cu webhook list --team-id <id>
```

| Flag | Description |
|------|-------------|
| `--team-id` | **(required)** Workspace ID |

**Example:**
```bash
cu webhook list --team-id 9014416713
```

### `cu webhook create`

Create a webhook.

```bash
cu webhook create --team-id <id> --url <url> --events <events> [options]
```

| Flag | Description |
|------|-------------|
| `--team-id` | **(required)** Workspace ID |
| `--url` | **(required)** Webhook endpoint URL |
| `--events` | **(required)** Comma-separated events or * for all |
| `--list-id` | Limit webhook to a specific list |

**Example:**
```bash
cu webhook create --team-id 9014416713 --url "https://example.com/hook" --events "taskCreated,taskUpdated"
```

### `cu webhook delete`

Delete a webhook.

```bash
cu webhook delete --team-id <id> --webhook-id <id>
```

| Flag | Description |
|------|-------------|
| `--team-id` | **(required)** Workspace ID |
| `--webhook-id` | **(required)** Webhook ID |

**Example:**
```bash
cu webhook delete --team-id 9014416713 --webhook-id <webhook-id>
```

---

## `cu time`

Manage time entries and timers.

### `cu time list`

List time entries for a workspace.

```bash
cu time list --team-id <id> [options]
```

| Flag | Description |
|------|-------------|
| `--team-id` | **(required)** Workspace ID |
| `--start-date` | Filter start (YYYY-MM-DD) |
| `--end-date` | Filter end (YYYY-MM-DD) |

**Example:**
```bash
cu time list --team-id 9014416713
```

### `cu time start`

Start a timer on a task.

```bash
cu time start --task-id <id> [options]
```

| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID |
| `--description` | Timer description |

**Example:**
```bash
cu time start --task-id 86b9e64ww --description "Working on feature"
```

### `cu time stop`

Stop the timer on a task.

```bash
cu time stop --task-id <id>
```

| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID |

**Example:**
```bash
cu time stop --task-id 86b9e64ww
```

---

## `cu dependency`

Manage task dependencies (blocking relationships).

### `cu dependency add`

Add a dependency (blocking relationship).

```bash
cu dependency add --task-id <id> --depends-on <id> [options]
```

| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID that will be blocked |
| `--depends-on` | **(required)** Task ID to block by |
| `--type` | Dependency type (default: blocking) |

**Example:**
```bash
cu dependency add --task-id abc123 --depends-on xyz789
```

### `cu dependency remove`

Remove a dependency from a task.

```bash
cu dependency remove --task-id <id> --dependency-task-id <id>
```

| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Primary task ID |
| `--dependency-task-id` | **(required)** Dependency task ID to remove |

**Example:**
```bash
cu dependency remove --task-id abc123 --dependency-task-id xyz789
```

---

## `cu checklist`

Manage task checklists.

### `cu checklist add`

Add a checklist to a task.

```bash
cu checklist add --task-id <id> --name "<name>"
```

| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID |
| `--name` | **(required)** Checklist name |

**Example:**
```bash
cu checklist add --task-id abc123 --name "Review items"
```

### `cu checklist item-add`

Add an item to a checklist.

```bash
cu checklist item-add --checklist-id <id> --task-id <id> --content "<text>"
```

| Flag | Description |
|------|-------------|
| `--checklist-id` | **(required)** Checklist ID |
| `--task-id` | **(required)** Parent task ID |
| `--content` | **(required)** Item text |

**Example:**
```bash
cu checklist item-add --checklist-id clist123 --task-id abc123 --content "Review design"
```

---

## `cu customfield`

Manage custom fields on tasks and lists.

### `cu customfield list`

List custom fields available in a list.

```bash
cu customfield list --list-id <id>
```

| Flag | Description |
|------|-------------|
| `--list-id` | **(required)** List ID |

**Example:**
```bash
cu customfield list --list-id 123456
```

### `cu customfield set`

Set a custom field value on a task.

```bash
cu customfield set --task-id <id> --field-id <id> --value <value>
```

| Flag | Description |
|------|-------------|
| `--task-id` | **(required)** Task ID |
| `--field-id` | **(required)** Custom field ID |
| `--value` | **(required)** Field value |

**Example:**
```bash
cu customfield set --task-id abc123 --field-id fld456 --value "Done"
```

---

## Phase 4 MCP Extensions

| Command | Description |
|---------|-------------|
| `cu mcp goal-list --team-id <id>` | List goals (MCP) |
| `cu mcp goal-create --team-id <id> --name "<name>"` | Create goal (MCP) |
| `cu mcp webhook-list --team-id <id>` | List webhooks (MCP) |
| `cu mcp webhook-create --team-id <id> --url <url> --events <events>` | Create webhook (MCP) |
| `cu mcp webhook-delete --team-id <id> --webhook-id <id>` | Delete webhook (MCP) |
| `cu mcp time-list --team-id <id>` | List time entries (MCP) |
| `cu mcp time-start --task-id <id>` | Start timer (MCP) |
| `cu mcp time-stop --task-id <id>` | Stop timer (MCP) |
| `cu mcp checklist-add --task-id <id> --name "<name>"` | Add checklist (MCP) |
| `cu mcp checklist-item-add --checklist-id <id> --task-id <id> --content "<text>"` | Add item (MCP) |
| `cu mcp customfield-list --list-id <id>` | List custom fields (MCP) |
| `cu mcp customfield-set --task-id <id> --field-id <id> --value <value>` | Set field value (MCP) |

---

## Phase 5 MCP Extensions

| Command | Description |
|---------|-------------|
| `cu mcp space-create --team-id <id> --name "<name>"` | Create space |
| `cu mcp space-update --space-id <id> --name "<name>"` | Update space |
| `cu mcp space-delete --space-id <id>` | Delete space |
| `cu mcp folder-create --space-id <id> --name "<name>"` | Create folder |
| `cu mcp folder-update --folder-id <id> --name "<name>"` | Update folder |
| `cu mcp folder-delete --folder-id <id>` | Delete folder |
| `cu mcp view-team --team-id <id>` | List workspace views |
| `cu mcp task-customfields --task-id <id>` | Get task custom fields |