English

ClickUp Code Companion

ClickUp Code Companion is an unofficial Visual Studio Code extension that helps you streamline your workflow by integrating essential ClickUp task-management features directly into your editor. With this extension, development teams can:

• Create Git branches from ClickUp tasks.
• Track time for each task without leaving VS Code.
• Quickly manage assignees and statuses in a user-friendly interface.

All of this is done without juggling multiple apps—stay focused on your code, and let the extension handle the rest.

---

Features

• Secure ClickUp Authentication
  Enter your ClickUp API token once, and the extension remembers it for subsequent sessions.

• Task & List Management

  • Easily select and switch between ClickUp lists or folders.
  • Browse detailed task information in a dedicated Webview, including status, assignees, and content.

  

• Time Tracking

  • Start, Pause, Resume, and Stop timers directly linked to ClickUp tasks.
  • Automatically sync your tracked time with ClickUp for consistent reporting.

  

• Git Branch Creation

  • Instantly generate a standardized Git branch name using the task ID and title.
  • Pick from common prefixes (e.g., feature, bugfix, chore, hotfix) to keep branch names tidy.

• Quick Status & Assignee Updates

  • Assign users or change assignees on a task without leaving VS Code.
  • Update a task’s status (like to do, in progress, or done) on the fly.

• Search Tasks, View Recent & Assigned-to-Me, and Create New Tasks

  • Quickly search tasks by keyword in the sidebar.
  • Access “Recent Tasks” or “Assigned to Me” tasks with a click.
  • Create new ClickUp tasks directly from the VS Code sidebar.

---

Installation & Setup

1. Install from the VS Code Marketplace

1. Open the Extensions view in Visual Studio Code (Ctrl/Cmd + Shift + X).
2. Type "ClickUp Code Companion" in the search bar.
3. When found, click Install.

2. Initial Configuration

1. Enter Your ClickUp API Token

   • Press Ctrl/Cmd + Shift + P, select ClickUp Code Companion: Enter API Token, and follow the prompt.
   • Finding Your API Token in ClickUp:
     1. Log into your ClickUp workspace.
     2. Click the Settings icon at the bottom-left corner.
     3. Select Apps from the menu.
     4. Generate or Regenerate your API key.
     5. Copy that key—this is your personal ClickUp API token.

2. Select ClickUp List

   • Again, press Ctrl/Cmd + Shift + P, select ClickUp Code Companion: Select ClickUp List, then choose your team/space/folder.

---

Step-by-Step Usage

1. View & Manage Tasks

   • Use ClickUp Code Companion: Show Tasks to list tasks from your selected list.
   • Or open the ClickUp Companion sidebar to browse tasks in a hierarchical view.

2. Track Time on a Task

   • Run ClickUp Code Companion: Start Timer from the command palette.
   • Use Pause, Resume, or Stop to manage your session.
   • Time automatically syncs with ClickUp.

3. Create a Branch

   • Execute ClickUp Code Companion: Create Branch to generate a Git branch.
   • Pick a prefix (e.g., feature, bugfix), and let the extension handle the rest.

4. Assign or Change Assignees

   • If a task is unassigned, run ClickUp Code Companion: Add Assignee.
   • If it already has someone assigned, use ClickUp Code Companion: Change Assignee to select another user.

5. Update Task Status

   • Run ClickUp Code Companion: Change Status and choose the new status (like to do, in progress, or done).

6. Refresh Data

   • In the companion sidebar, click the Refresh Data button to reload the latest tasks and hierarchy.

---

Example Workflows

Creating a Branch and Starting a Timer

1. Show Tasks → pick a ClickUp task.
2. Create Branch from that task.
3. Start Timer to begin tracking.
4. Pause or stop any time—your time logs appear in ClickUp automatically.

---

Requirements

• Visual Studio Code ^1.98.0
• A valid ClickUp account and API token
• A Git-initialized project if you plan to create branches

---

Roadmap / Future Enhancements

• Additional ClickUp features (comments, attachments, advanced custom fields).
• More robust idle-time detection.
• Deeper board or sprint integrations for agile workflows.

---

Support & Feedback

• Open an Issue on GitHub for suggestions or bugs.
• Contact the maintainer directly.

Your feedback helps improve ClickUp Code Companion—thank you for using it!

---

Buy Me a Coffee

If you find this extension useful, consider supporting its development:

Any contribution helps me dedicate more time to adding features, fixing bugs, and improving documentation.

---

Happy Coding with ClickUp Code Companion!

---

中文 (Simplified Chinese)

ClickUp Code Companion

ClickUp Code Companion 是一款非官方的 Visual Studio Code 扩展，可将关键的 ClickUp 任务管理功能直接集成到编辑器中，让开发团队可以：

• 从 ClickUp 任务中创建 Git 分支。
• 在 VS Code 中 跟踪每个任务的时间。
• 在简洁易用的界面中快速管理 任务分配 (assignees) 和 状态 (statuses)。

专注于代码，无需在多个应用之间切换，一切交给扩展即可。

---

功能亮点

• 安全的 ClickUp 身份验证
  输入一次 ClickUp API token 后，扩展可记住它，以后无需重复输入。

• 任务与列表管理

  • 轻松选择并切换不同的 ClickUp 列表或文件夹。
  • 在专用 Webview 中查看详细的 任务信息（状态、分配人、内容）。

• 时间追踪

  • 直接在 VS Code 中 开始、暂停、恢复、停止 计时。
  • 自动将计时同步到 ClickUp，方便汇总统计。

• Git 分支创建

  • 基于任务 ID 和标题，快速生成规范化的 Git 分支名称。
  • 可选择常用前缀（如 feature, bugfix, chore, hotfix）使分支命名更整洁。

• 快速修改状态与分配

  • 无需离开 VS Code 即可为任务添加或更改分配人。
  • 动态更新任务状态（例如 to do, in progress, done）。

• 搜索任务、查看近期任务与我的任务，并在侧边栏创建新任务

  • 通过关键字快速搜索任务，或一键打开“最近任务”与“分配给我的”任务列表。
  • 直接在 VS Code 侧边栏中创建新的 ClickUp 任务。

---

安装与配置

1. 从 VS Code Marketplace 安装

1. 在 Visual Studio Code 中打开 扩展 视图（Ctrl/Cmd + Shift + X）。
2. 在搜索栏中输入 "ClickUp Code Companion"。
3. 找到后点击 Install 安装。

2. 初始配置

1. 输入 ClickUp API Token

   • 按下 Ctrl/Cmd + Shift + P，选择 ClickUp Code Companion: Enter API Token，按提示输入。
   • 如何获取 ClickUp API Token：
     1. 登录到你的 ClickUp 工作区。
     2. 在左下角点击 设置 (Settings) 图标。
     3. 在菜单中选择 Apps。
     4. 查找 Generate 或 Regenerate 以生成/更新密钥。
     5. 复制此密钥—这就是你的 API token。

2. 选择 ClickUp 列表

   • 再次按下 Ctrl/Cmd + Shift + P，选择 ClickUp Code Companion: Select ClickUp List，并选择团队/空间/文件夹。

---

使用步骤

1. 查看和管理任务

   • 使用 ClickUp Code Companion: Show Tasks 列出已选列表中的任务。
   • 也可以在活动栏打开 ClickUp Companion 侧边栏，分层级查看任务。

2. 为任务追踪时间

   • 在命令面板运行 ClickUp Code Companion: Start Timer。
   • 可使用 Pause, Resume 或 Stop 管理计时。
   • 计时会自动同步到 ClickUp。

3. 创建分支

   • 执行 ClickUp Code Companion: Create Branch 来生成 Git 分支。
   • 选择前缀（如 feature, bugfix），其余交给扩展。

4. 分配或更改任务分配人

   • 如果任务尚未分配，用 ClickUp Code Companion: Add Assignee。
   • 如果已有分配人，可使用 ClickUp Code Companion: Change Assignee 更改。

5. 更新任务状态

   • 运行 ClickUp Code Companion: Change Status 并选择新的状态（to do, in progress, done）。

6. 刷新数据

   • 在侧边栏中点击 Refresh Data 来加载最新的任务与层级信息。

---

示例流程

创建分支并开始计时

1. Show Tasks → 选中一个 ClickUp 任务。
2. Create Branch 基于同一任务。
3. Start Timer 开始记录时间。
4. 随时可暂停或停止，计时时间会自动出现在 ClickUp 中。

---

环境要求

• Visual Studio Code ^1.98.0
• 有效的 ClickUp 账号和 API token
• 若需创建分支，请使用初始化了 Git 的项目

---

路线图 / 未来改进

• 更多 ClickUp 功能（评论、附件、高级自定义字段）。
• 更灵活的空闲检测。
• 与看板或冲刺的深入集成。

---

支持与反馈

• 在 GitHub 上提交 Issue 来提出建议或反馈 Bug。
• 可直接联系维护者。

感谢使用 ClickUp Code Companion，期待你的意见和建议！

---

请我喝咖啡

如果你觉得这个扩展对你有帮助，可以考虑支持我的开发工作：

你的支持可以帮助我投入更多时间来完善此扩展。

---

祝编码愉快，点击 ClickUp Code Companion 体验更高效！

---

Français

ClickUp Code Companion

ClickUp Code Companion est une extension non officielle pour Visual Studio Code qui vous permet de simplifier votre flux de travail en intégrant directement les fonctionnalités essentielles de gestion de tâches ClickUp dans votre éditeur. Grâce à cette extension, les équipes de développement peuvent :

• Créer des branches Git à partir de tâches ClickUp.
• Suivre le temps passé sur chaque tâche, sans quitter VS Code.
• Gérer rapidement les assignations et les statuts via une interface conviviale.

Restez concentré sur votre code sans jongler entre plusieurs applications.

---

Fonctionnalités

• Authentification sécurisée ClickUp
  Saisissez une fois votre jeton API ClickUp, et l'extension le mémorise pour les sessions ultérieures.

• Gestion des tâches et listes

  • Sélectionnez et basculez facilement entre différentes listes ou dossiers ClickUp.
  • Consultez des informations détaillées sur les tâches (statut, assignés, contenu) dans une Webview dédiée.

• Suivi du temps

  • Commencez, mettez en pause, reprenez ou arrêtez un minuteur directement associé à une tâche ClickUp.
  • Les temps suivis sont automatiquement synchronisés avec ClickUp.

• Création de branches Git

  • Générez instantanément un nom de branche Git standardisé à partir de l’ID et du titre de la tâche.
  • Choisissez parmi des préfixes courants (ex. feature, bugfix, chore, hotfix) pour garder des noms de branches ordonnés.

• Mises à jour rapides du statut et des assignés

  • Assignez ou changez l'assigné d'une tâche sans quitter VS Code.
  • Modifiez le statut d’une tâche (ex. to do, in progress, done) à la volée.

• Recherche de Tâches, Tâches Récentes & Assignées, et Création de Nouvelles Tâches

  • Recherchez rapidement des tâches par mot-clé via la barre latérale.
  • Accédez en un clic à vos “Tâches récentes” ou “Assignées à moi”.
  • Créez de nouvelles tâches ClickUp directement depuis la barre latérale VS Code.

---

Installation & Configuration

1. Depuis le Marketplace VS Code

1. Ouvrez l’onglet Extensions dans Visual Studio Code (Ctrl/Cmd + Shift + X).
2. Tapez "ClickUp Code Companion" dans la barre de recherche.
3. Cliquez sur Install.

2. Configuration initiale

1. Entrez votre jeton API ClickUp

   • Ctrl/Cmd + Shift + P → ClickUp Code Companion: Enter API Token, suivez les instructions.
   • Trouver votre jeton API dans ClickUp :
     1. Connectez-vous à votre espace de travail ClickUp.
     2. Cliquez sur l'icône Paramètres (Settings) en bas à gauche.
     3. Sélectionnez Apps.
     4. Générez ou régénérez votre clé.
     5. Copiez la clé, c’est votre jeton API ClickUp.

2. Sélectionnez la liste ClickUp

   • Encore une fois : Ctrl/Cmd + Shift + P → ClickUp Code Companion: Select ClickUp List → Choisissez équipe/espace/dossier.

---

Utilisation étape par étape

1. Afficher et gérer les tâches

   • ClickUp Code Companion: Show Tasks pour lister les tâches de la liste sélectionnée.
   • Ouvrez la barre latérale ClickUp Companion pour explorer les tâches de manière hiérarchique.

2. Suivre le temps sur une tâche

   • Exécutez ClickUp Code Companion: Start Timer.
   • Utilisez Pause, Resume, Stop pour gérer votre session.
   • Le temps est synchronisé automatiquement avec ClickUp.

3. Créer une branche

   • ClickUp Code Companion: Create Branch pour générer une branche Git.
   • Choisissez un préfixe (ex. feature, bugfix) et laissez faire l’extension.

4. Assigner ou changer l’assigné

   • Si la tâche n’a pas d’assigné, utilisez ClickUp Code Companion: Add Assignee.
   • Sinon, ClickUp Code Companion: Change Assignee pour choisir un autre utilisateur.

5. Mettre à jour le statut

   • ClickUp Code Companion: Change Status et sélectionnez un nouveau statut (to do, in progress, done).

6. Rafraîchir les données

   • Dans la barre latérale, cliquez sur Refresh Data pour recharger les informations récentes.

---

Exemples de workflows

Créer une branche et lancer un minuteur

1. Show Tasks → sélectionnez une tâche.
2. Create Branch sur la même tâche.
3. Start Timer pour commencer.
4. Mettez en pause ou arrêtez quand vous voulez — les infos de temps sont visibles dans ClickUp.

---

Exigences

• Visual Studio Code ^1.98.0
• Compte ClickUp valide et jeton API
• Un projet Git initialisé si vous voulez créer des branches

---

Roadmap / Évolutions futures

• Plus de fonctionnalités ClickUp (commentaires, pièces jointes, champs personnalisés avancés).
• Détection d’inactivité plus flexible.
• Intégrations poussées avec boards ou sprints agiles.

---

Support & Feedback

• Ouvrez une Issue sur GitHub pour suggestions ou bugs.
• Contactez directement le mainteneur.

Merci d’utiliser ClickUp Code Companion, vos retours nous aident à l’améliorer !

---

Buy Me a Coffee

Si cette extension vous est utile, envisagez de soutenir son développement :

Chaque contribution nous permet de passer plus de temps à ajouter des fonctionnalités, corriger des bugs et améliorer la documentation.

---

Bon développement avec ClickUp Code Companion !

---

Deutsch

ClickUp Code Companion

ClickUp Code Companion ist eine inoffizielle Visual-Studio-Code-Erweiterung, die Ihren Arbeitsablauf optimiert, indem sie wesentliche ClickUp-Aufgabenverwaltungsfunktionen direkt in Ihren Editor integriert. Mit dieser Erweiterung kann Ihr Entwicklungsteam:

• Git-Branches aus ClickUp-Aufgaben erstellen.
• Zeit pro Aufgabe direkt in VS Code erfassen.
• Zuständigkeiten (Assignees) und Status schnell in einer benutzerfreundlichen Oberfläche verwalten.

Konzentrieren Sie sich auf Ihren Code, ohne zwischen mehreren Anwendungen zu wechseln.

---

Funktionen

• Sichere ClickUp-Authentifizierung
  Geben Sie Ihren ClickUp-API-Token einmal ein, und die Erweiterung merkt ihn sich für zukünftige Sitzungen.

• Aufgaben- und Listenverwaltung

  • Wählen und wechseln Sie mühelos zwischen verschiedenen ClickUp-Listen oder Ordnern.
  • Betrachten Sie detaillierte Aufgabeninformationen (Status, Bearbeiter, Inhalt) in einer dedizierten Webview.

• Zeiterfassung

  • Starten, pausieren, fortsetzen und stoppen Sie Timer direkt für ClickUp-Aufgaben.
  • Die erfasste Zeit wird automatisch mit ClickUp synchronisiert.

• Git-Branch-Erstellung

  • Erstellen Sie standardisierte Git-Branch-Namen aus Aufgaben-ID und Aufgabentitel.
  • Wählen Sie Prefixe wie feature, bugfix, chore, hotfix für konsistente Branch-Namen.

• Schnelle Status- und Zuständigkeitsänderungen

  • Weisen Sie Aufgaben neue Bearbeiter zu oder ändern Sie Zuständigkeiten ohne VS Code zu verlassen.
  • Aktualisieren Sie den Aufgabenstatus (z.B. to do, in progress, done) sofort.

• Aufgaben suchen, zuletzt verwendete & mir zugewiesene anzeigen, und neue Aufgaben erstellen

  • Nutzen Sie die Seitenleiste, um Aufgaben nach Stichworten zu durchsuchen.
  • Greifen Sie mit einem Klick auf „Zuletzt verwendete Aufgaben“ oder „Mir zugewiesene Aufgaben“ zu.
  • Erstellen Sie neue ClickUp-Aufgaben direkt in der VS Code-Seitenleiste.

---

Installation & Einrichtung

1. Installation über den VS Code Marketplace

1. Öffnen Sie den Erweiterungen-Bereich in Visual Studio Code (Ctrl/Cmd + Shift + X).
2. Suchen Sie nach "ClickUp Code Companion".
3. Klicken Sie auf Install, sobald die Erweiterung gefunden wird.

2. Erste Konfiguration

1. ClickUp-API-Token eingeben

   • Ctrl/Cmd + Shift + P → ClickUp Code Companion: Enter API Token → Befolgen Sie die Anweisungen.
   • API-Token in ClickUp finden:
     1. Melden Sie sich in Ihrem ClickUp-Arbeitsbereich an.
     2. Klicken Sie unten links auf Einstellungen (Settings).
     3. Wählen Sie Apps.
     4. Generieren oder regenerieren Sie Ihren Schlüssel.
     5. Kopieren Sie ihn—das ist Ihr persönlicher Token.

2. ClickUp-Liste auswählen

   • Erneut Ctrl/Cmd + Shift + P → ClickUp Code Companion: Select ClickUp List → Wählen Sie Ihr Team/Space/Ordner.

---

Schritt-für-Schritt-Anleitung

1. Aufgaben anzeigen & verwalten

   • ClickUp Code Companion: Show Tasks, um Aufgaben der gewählten Liste zu sehen.
   • Öffnen Sie die Seitenleiste ClickUp Companion, um Aufgaben hierarchisch zu durchsuchen.

2. Zeiterfassung starten

   • ClickUp Code Companion: Start Timer in der Kommando-Palette.
   • Nutzen Sie Pause, Resume oder Stop für die Steuerung.
   • Die Zeit wird automatisch mit ClickUp synchronisiert.

3. Branch erstellen

   • ClickUp Code Companion: Create Branch generiert einen Git-Branch.
   • Wählen Sie ein Prefix (z.B. feature, bugfix).

4. Bearbeiter zuweisen oder ändern

   • ClickUp Code Companion: Add Assignee, wenn keine Person zugewiesen ist.
   • ClickUp Code Companion: Change Assignee, um einen anderen Benutzer auszuwählen.

5. Aufgabenstatus aktualisieren

   • ClickUp Code Companion: Change Status → Wählen Sie den neuen Status (to do, in progress, done).

6. Daten aktualisieren

   • In der Seitenleiste finden Sie Refresh Data, um aktuelle Aufgaben und Strukturen zu laden.

---

Beispiel-Workflows

Einen Branch erstellen & Timer starten

1. Show Tasks → Wählen Sie eine Aufgabe.
2. Create Branch für diese Aufgabe.
3. Start Timer, um die Zeit zu erfassen.
4. Pausieren oder stoppen Sie wann immer Sie möchten—die Zeit wird automatisch in ClickUp eingetragen.

---

Anforderungen

• Visual Studio Code ^1.98.0
• Ein gültiges ClickUp-Konto und API-Token
• Git-initialisiertes Projekt zum Erstellen von Branches

---

Roadmap / Zukünftige Verbesserungen

• Weitere ClickUp-Funktionen (Kommentare, Anhänge, erweiterte benutzerdefinierte Felder).
• Flexiblere Erkennung von Inaktivität.
• Tiefergehende Integration mit Boards oder Sprints.

---

Support & Feedback

• Eröffnen Sie ein Issue auf GitHub für Vorschläge oder Fehlerberichte.
• Kontaktieren Sie den Maintainer direkt.

Vielen Dank fürs Nutzen von ClickUp Code Companion—Ihr Feedback macht es besser!

---

Buy Me a Coffee

Falls diese Erweiterung hilfreich ist, können Sie deren Weiterentwicklung unterstützen:

Jede Unterstützung ermöglicht mehr Zeit für neue Features, Fehlerbehebungen und Dokumentation.

---

Viel Spaß beim Coden mit ClickUp Code Companion!

---

Español

ClickUp Code Companion

ClickUp Code Companion es una extensión no oficial para Visual Studio Code que te ayuda a optimizar tu flujo de trabajo al integrar características esenciales de la gestión de tareas de ClickUp directamente en tu editor. Con esta extensión, los equipos de desarrollo pueden:

• Crear ramas Git a partir de tareas de ClickUp.
• Registrar tiempo para cada tarea sin salir de VS Code.
• Gestionar rápidamente asignaciones y estados desde una interfaz intuitiva.

Mantente concentrado en tu código sin alternar entre múltiples aplicaciones.

---

Funcionalidades

• Autenticación segura de ClickUp
  Ingresa tu token de API de ClickUp una sola vez, y la extensión lo recordará en futuras sesiones.

• Gestión de tareas y listas

  • Selecciona y alterna fácilmente entre listas o carpetas de ClickUp.
  • Explora información detallada de las tareas (estado, asignados, contenido) en una vista web dedicada.

• Registro de tiempo

  • Inicia, pausa, reanuda y detén temporizadores vinculados a tareas de ClickUp.
  • El tiempo registrado se sincroniza automáticamente con ClickUp para mantener informes consistentes.

• Creación de ramas Git

  • Genera de inmediato un nombre de rama Git estandarizado usando el ID y el título de la tarea.
  • Escoge entre prefijos comunes (p. ej., feature, bugfix, chore, hotfix) para un orden coherente.

• Actualizaciones rápidas de estado y asignación

  • Asigna o cambia el responsable de una tarea sin salir de VS Code.
  • Actualiza el estado de la tarea (p. ej., to do, in progress, done) rápidamente.

• Buscar Tareas, Ver Recientes & Asignadas a Mí, y Crear Nuevas Tareas

  • Desde la barra lateral, busca rápidamente tareas por palabra clave.
  • Accede con un clic a “Tareas Recientes” o “Asignadas a Mí”.
  • Crea nuevas tareas de ClickUp directamente desde la barra lateral de VS Code.

---

Instalación y Configuración

1. Instalar desde el VS Code Marketplace

1. Abre la vista de Extensiones en Visual Studio Code (Ctrl/Cmd + Shift + X).
2. Escribe "ClickUp Code Companion" en la barra de búsqueda.
3. Haz clic en Install.

2. Configuración Inicial

1. Ingresa tu token de API de ClickUp

   • Ctrl/Cmd + Shift + P → ClickUp Code Companion: Enter API Token, sigue las indicaciones.
   • Cómo encontrar tu token de API en ClickUp:
     1. Inicia sesión en tu espacio de trabajo de ClickUp.
     2. Haz clic en el ícono de Configuración (Settings) en la esquina inferior izquierda.
     3. Selecciona Apps.
     4. Genera o Regenera tu clave.
     5. Copia la clave—es tu token de API.

2. Selecciona la lista de ClickUp

   • De nuevo: Ctrl/Cmd + Shift + P → ClickUp Code Companion: Select ClickUp List, escoge tu equipo/espacio/carpeta.

---

Uso Paso a Paso

1. Ver y gestionar tareas

   • ClickUp Code Companion: Show Tasks para mostrar tareas de la lista seleccionada.
   • O bien, abre la barra lateral ClickUp Companion para explorar tareas de forma jerárquica.

2. Registrar tiempo en una tarea

   • Ejecuta ClickUp Code Companion: Start Timer.
   • Usa Pause, Resume, o Stop para controlar tu sesión.
   • El tiempo se sincroniza automáticamente con ClickUp.

3. Crear una rama

   • ClickUp Code Companion: Create Branch para generar una rama Git.
   • Elige un prefijo (ej. feature, bugfix) y listo.

4. Asignar o cambiar responsables

   • Si una tarea está sin asignar, usa ClickUp Code Companion: Add Assignee.
   • Si ya cuenta con alguien, usa ClickUp Code Companion: Change Assignee para seleccionar otro usuario.

5. Actualizar el estado

   • ClickUp Code Companion: Change Status y elige el nuevo estado (to do, in progress, done).

6. Refrescar datos

   • En la barra lateral, presiona Refresh Data para recargar tareas y jerarquías recientes.

---

Ejemplo de Flujos de Trabajo

Crear una rama y comenzar a registrar tiempo

1. Show Tasks → selecciona una tarea.
2. Create Branch en esa tarea.
3. Start Timer para iniciar el registro.
4. Pausa o detén en cualquier momento—el tiempo aparece automáticamente en ClickUp.

---

Requisitos

• Visual Studio Code ^1.98.0
• Una cuenta válida de ClickUp y un token de API
• Un proyecto con Git inicializado si vas a crear ramas

---

Roadmap / Mejoras Futuras

• Más características de ClickUp (comentarios, adjuntos, campos personalizados avanzados).
• Detección de inactividad más sólida.
• Integraciones más profundas con tableros o sprints ágiles.

---

Soporte y Retroalimentación

• Abre un Issue en GitHub para sugerencias o reportes de errores.
• Contacta al mantenedor directamente.

Tu retroalimentación ayuda a mejorar ClickUp Code Companion—gracias por usarlo.

---

Buy Me a Coffee

Si esta extensión te resulta útil, considera apoyar su desarrollo:

Cualquier contribución permite dedicar más tiempo a agregar funciones, corregir errores y mejorar la documentación.

---

¡Feliz programación con ClickUp Code Companion!

---

Português (Brasil)

ClickUp Code Companion

ClickUp Code Companion é uma extensão não oficial para o Visual Studio Code que ajuda você a otimizar seu fluxo de trabalho ao integrar recursos essenciais de gerenciamento de tarefas do ClickUp diretamente no seu editor. Com esta extensão, equipes de desenvolvimento podem:

• Criar branches Git a partir de tarefas do ClickUp.
• Rastrear tempo para cada tarefa sem sair do VS Code.
• Gerenciar rapidamente responsáveis (assignees) e status em uma interface amigável.

Mantenha o foco no código, sem alternar entre vários aplicativos.

---

Recursos

• Autenticação segura do ClickUp
  Insira seu token de API do ClickUp uma única vez; a extensão se lembrará dele para sessões futuras.

• Gerenciamento de tarefas e listas

  • Selecione e alterne facilmente entre listas ou pastas do ClickUp.
  • Visualize informações detalhadas das tarefas (status, responsáveis, conteúdo) em uma Webview dedicada.

• Rastreamento de tempo

  • Inicie, pause, retome e pare cronômetros diretamente vinculados a tarefas do ClickUp.
  • O tempo rastreado é sincronizado automaticamente com o ClickUp.

• Criação de branches Git

  • Gere instantaneamente um nome de branch Git padronizado a partir do ID e título da tarefa.
  • Escolha entre prefixos comuns (ex.: feature, bugfix, chore, hotfix) para manter organização.

• Atualizações rápidas de status e responsável

  • Atribua usuários ou altere responsáveis sem sair do VS Code.
  • Atualize o status da tarefa (ex.: to do, in progress, done) de modo rápido.

• Buscar Tarefas, Ver Recentes & Atribuídas a Mim, e Criar Novas Tarefas

  • Pesquise tarefas rapidamente por palavra-chave na barra lateral.
  • Acesse “Tarefas Recentes” ou “Atribuídas a Mim” com um clique.
  • Crie novas tarefas do ClickUp diretamente na barra lateral do VS Code.

---

Instalação e Configuração

1. Instalar pelo VS Code Marketplace

1. Abra a visualização de Extensões no Visual Studio Code (Ctrl/Cmd + Shift + X).
2. Digite "ClickUp Code Companion" na barra de busca.
3. Clique em Install quando encontrar a extensão.

2. Configuração Inicial

1. Insira seu token de API do ClickUp

   • Ctrl/Cmd + Shift + P → ClickUp Code Companion: Enter API Token, siga as instruções.
   • Como encontrar seu token de API no ClickUp:
     1. Faça login no seu workspace do ClickUp.
     2. Clique no ícone Settings (Configurações) no canto inferior esquerdo.
     3. Selecione Apps.
     4. Gere ou regenere sua chave.
     5. Copie a chave—é o seu token de API.

2. Selecione a lista do ClickUp

   • Novamente: Ctrl/Cmd + Shift + P → ClickUp Code Companion: Select ClickUp List, escolha seu time/espaço/pasta.

---

Passo a Passo de Uso

1. Visualizar e gerenciar tarefas

   • ClickUp Code Companion: Show Tasks para listar as tarefas da lista selecionada.
   • Ou abra a barra lateral ClickUp Companion para navegar nas tarefas em formato hierárquico.

2. Rastrear tempo em uma tarefa

   • ClickUp Code Companion: Start Timer na paleta de comandos.
   • Use Pause, Resume ou Stop para gerenciar a sessão.
   • O tempo é sincronizado com o ClickUp.

3. Criar uma branch

   • ClickUp Code Companion: Create Branch para gerar uma branch Git.
   • Escolha um prefixo (ex. feature, bugfix) e pronto.

4. Atribuir ou alterar responsáveis

   • Se uma tarefa está sem responsável, use ClickUp Code Companion: Add Assignee.
   • Se já houver um responsável, ClickUp Code Companion: Change Assignee para trocar o usuário.

5. Atualizar status da tarefa

   • ClickUp Code Companion: Change Status e selecione o novo status (to do, in progress, done).

6. Atualizar dados

   • Use Refresh Data na barra lateral para recarregar as tarefas mais recentes.

---

Exemplo de Fluxo de Trabalho

Criando uma branch e iniciando um timer

1. Show Tasks → escolha uma tarefa.
2. Create Branch dessa mesma tarefa.
3. Start Timer para começar o rastreamento.
4. Pause ou pare quando quiser—o tempo aparece automaticamente no ClickUp.

---

Requisitos

• Visual Studio Code ^1.98.0
• Uma conta válida do ClickUp + token de API
• Projeto Git inicializado para criar branches

---

Roadmap / Futuras Melhorias

• Mais recursos do ClickUp (comentários, anexos, campos avançados).
• Detecção de inatividade mais robusta.
• Integrações mais profundas com boards ou sprints ágeis.

---

Suporte e Feedback

• Abra uma Issue no GitHub para sugestões ou problemas.
• Entre em contato diretamente com o mantenedor.

Seu feedback ajuda a melhorar o ClickUp Code Companion—obrigado por usá-lo!

---

Buy Me a Coffee

Se esta extensão for útil para você, considere apoiar seu desenvolvimento:

Qualquer contribuição ajuda a dedicar mais tempo a recursos, correções e documentação.

---

Boa codificação com o ClickUp Code Companion!

---

Italiano

ClickUp Code Companion

ClickUp Code Companion è un’estensione non ufficiale per Visual Studio Code che semplifica il tuo flusso di lavoro, integrando funzionalità essenziali di gestione delle attività di ClickUp direttamente nell’editor. Con questa estensione, i team di sviluppo possono:

• Creare branch Git partendo da attività di ClickUp.
• Tracciare il tempo di ogni attività senza uscire da VS Code.
• Gestire rapidamente assegnatari (assignees) e stati (statuses) in un’interfaccia intuitiva.

Rimani concentrato sul tuo codice, senza passare da un’app all’altra.

---

Caratteristiche

• Autenticazione sicura con ClickUp
  Inserisci il tuo token API di ClickUp una sola volta; l’estensione lo memorizzerà per le sessioni future.

• Gestione di attività e liste

  • Seleziona e passa facilmente tra liste o cartelle di ClickUp.
  • Visualizza informazioni dettagliate (stato, assegnatari, contenuto) in una Webview dedicata.

• Tracciamento del tempo

  • Avvia, metti in pausa, riprendi e ferma timer collegati alle attività di ClickUp.
  • Il tempo tracciato viene sincronizzato automaticamente con ClickUp per un reporting coerente.

• Creazione di branch Git

  • Genera istantaneamente un nome di branch Git standardizzato usando ID e titolo dell’attività.
  • Scegli tra prefissi comuni (feature, bugfix, chore, hotfix) per nomi di branch ordinati.

• Aggiornamenti rapidi di stato e assegnatari

  • Assegna o modifica l’assegnatario di un’attività senza uscire da VS Code.
  • Aggiorna lo stato (es. to do, in progress, done) in modo rapido.

• Ricerca di Attività, Visualizzazione Recenti & Assegnate a Me, e Creazione di Nuove Attività

  • Dalla barra laterale, ricerca rapidamente le attività per parola chiave.
  • Accedi con un clic alle “Attività Recenti” o “Assegnate a Me”.
  • Crea nuove attività di ClickUp direttamente dalla sidebar di VS Code.

---

Installazione e Configurazione

1. Installa dal VS Code Marketplace

1. Apri la vista Extensions in Visual Studio Code (Ctrl/Cmd + Shift + X).
2. Digita "ClickUp Code Companion" nella barra di ricerca.
3. Clicca su Install.

2. Configurazione Iniziale

1. Inserisci il tuo token API di ClickUp

   • Ctrl/Cmd + Shift + P → ClickUp Code Companion: Enter API Token, segui le indicazioni.
   • Dove trovare il tuo token API:
     1. Accedi a ClickUp.
     2. Clicca sull’icona Settings in basso a sinistra.
     3. Seleziona Apps.
     4. Genera o rigenera la chiave.
     5. Copiala: è il tuo token API personale.

2. Seleziona la lista di ClickUp

   • Ancora: Ctrl/Cmd + Shift + P → ClickUp Code Companion: Select ClickUp List → scegli team/spazio/cartella.

---

Utilizzo Passo Passo

1. Visualizza e gestisci attività

   • ClickUp Code Companion: Show Tasks per elencare le attività della lista scelta.
   • Oppure apri la barra laterale ClickUp Companion per esplorare le attività in modo gerarchico.

2. Traccia tempo su un’attività

   • ClickUp Code Companion: Start Timer nella palette dei comandi.
   • Usa Pause, Resume, o Stop per gestire la sessione.
   • Il tempo si sincronizza automaticamente con ClickUp.

3. Crea un branch

   • ClickUp Code Companion: Create Branch per generare un branch Git.
   • Scegli un prefisso (feature, bugfix, ecc.) e il resto lo fa l’estensione.

4. Assegna o modifica l’assegnatario

   • Se l’attività non ha assegnatari, usa ClickUp Code Companion: Add Assignee.
   • Se già assegnata, ClickUp Code Companion: Change Assignee per scegliere un altro utente.

5. Aggiorna lo stato di un’attività

   • ClickUp Code Companion: Change Status → Seleziona un nuovo stato (to do, in progress, done).

6. Aggiorna dati

   • Nella barra laterale, clicca Refresh Data per ricaricare le ultime informazioni su attività e gerarchie.

---

Esempio di Flussi di Lavoro

Creare un branch e avviare un timer

1. Show Tasks → scegli un’attività.
2. Create Branch sulla stessa attività.
3. Start Timer per avviare il tracciamento.
4. Metti in pausa o ferma quando vuoi—i log del tempo vengono inviati a ClickUp in automatico.

---

Requisiti

• Visual Studio Code ^1.98.0
• Un account ClickUp valido e token API
• Un progetto Git inizializzato, se vuoi creare branch

---

Roadmap / Miglioramenti Futuri

• Più funzionalità di ClickUp (commenti, allegati, campi personalizzati avanzati).
• Rilevamento inattività più flessibile.
• Integrazioni più profonde con board o sprint agili.

---

Supporto e Feedback

• Apri una Issue su GitHub per suggerimenti o segnalare bug.
• Contatta direttamente il maintainer.

Il tuo feedback migliora ClickUp Code Companion—grazie per usarlo!

---

Buy Me a Coffee

Se questa estensione ti risulta utile, considera di supportarne lo sviluppo:

Ogni contributo mi aiuta a dedicare più tempo a nuove funzionalità, correzione di bug e miglioramenti della documentazione.

---

Buon coding con ClickUp Code Companion!