ClickUp Code Companion

Love this extension? Become a sponsor to support ongoing development and new features.

Manage ClickUp Without Leaving VS Code

Track time with Pomodoro, create Git branches, manage dependencies, view tasks in Kanban boards, and more. A comprehensive ClickUp integration for developers.

Features

Task Management

• Browse workspaces, spaces, folders, and lists
• Rich task display with custom fields, tags, priorities, dependencies
• Multiple assignees, watchers, comments
• Advanced search and filtering
• Export tasks to CSV, JSON, or Markdown

Time Tracking

• Smart timer with auto-pause on inactivity
• Pomodoro mode (25/5 minute work/break cycles)
• Billable/non-billable tracking
• Time reports and visualization
• Offline sync support

Git Integration

• One-click branch creation from task ID and name
• Customizable branch and commit templates
• PR linking to tasks
• Auto status updates when PR merges

Views

• List, Board, Calendar, and Gantt views
• Group by status, priority, assignee, or due date
• Sort by due date, priority, created, or updated
• Theme support (adapts to VS Code theme)

Quick Start

1. Setup Connection

# Open command palette
Cmd+Shift+P (Mac) / Ctrl+Shift+P (Windows/Linux)

# Run setup command
> ClickUp: Setup Connection

# Enter your API token (get it from ClickUp Settings → Apps)

2. Select Workspace

> ClickUp: Select Workspace
> ClickUp: Select Space
> ClickUp: Select List

3. Start Working

> ClickUp: Show Tasks

Keyboard Shortcuts

Configuration

{
  "clickup.defaultView": "board",
  "clickup.groupBy": "status",
  "clickup.sortBy": "priority",

  "clickup.pomodoroEnabled": true,
  "clickup.pomodoroWorkDuration": 25,
  "clickup.pomodoroBreakDuration": 5,
  "clickup.billableByDefault": true,

  "clickup.gitBranchTemplate": "{type}/{id}-{name}",
  "clickup.commitMessageTemplate": "[{id}] {message}",

  "clickup.showSubtasks": true,
  "clickup.showClosedTasks": false
}

All Commands

Troubleshooting

Privacy

• Local Storage: API tokens stored securely in VS Code
• No Third Parties: Direct connection to ClickUp only

Disable analytics:

{
  "clickup.enableAnalytics": false
}

Requirements

• VS Code 1.98.0 or higher
• ClickUp account with API access
• Git (for branch features)

Changelog

See CHANGELOG.md for version history.

Support Development

This extension is free and open source. If it improves your ClickUp workflow, consider supporting its development:

Sponsor on GitHub (Recommended)

GitHub Sponsors is the best way to support ongoing development. Sponsors get priority support and help fund new features.

Other ways to help

• Leave a review on the VS Code Marketplace
• Report issues to help improve quality
• Buy me a coffee for one-time support

MIT License