ClickUp Timer - Kimono
Extensión de VS Code para vincular tareas de ClickUp, verlas en una cola en
el panel lateral, y correr temporizadores Pomodoro asociados a ellas con
countdown en vivo en la barra de estado.
Features
- Panel lateral propio con la cola de tareas de ClickUp agregadas — se guarda entre sesiones (persiste al cerrar y reabrir VS Code).
- Vinculación de tareas por ID, consultando el nombre directamente desde la API de ClickUp.
- Temporizadores Pomodoro de 5, 10, 30 o 60 minutos por tarea.
- Countdown en vivo en la barra de estado, resaltado en verde mientras corre (
⏱ NombreTarea MM:SS); un clic ahí también lo detiene.
- Botón de stop inline en el panel sobre la tarea que está corriendo (reemplaza al de play), y su nombre se resalta en verde en la lista.
- Un solo timer activo a la vez: iniciar uno nuevo reemplaza al anterior.
- Al finalizar (o frenar manualmente) se registra el tiempo real en ClickUp como time entry de la tarea.
- Sonido al completarse un Pomodoro naturalmente (no al frenarlo a mano).
- Clic en el título de una tarea despliega su historial de tiempos registrados en ClickUp.
- API key de ClickUp guardada de forma segura (
SecretStorage), nunca en texto plano.
- Localización en español e inglés, siguiendo el idioma configurado en VS Code.
Requisitos
Instalación
Todavía no está publicada en el Marketplace de VS Code (ver Roadmap).
Por ahora, para probarla desde el código fuente:
git clone https://github.com/Kimono-Apps/clickup-timer-vscode.git
cd clickup-timer-vscode
npm install
Abrí la carpeta en VS Code y presioná F5 para levantar una ventana de
Extension Development Host con la extensión activa.
Uso / Comandos
| Comando |
Título |
Cómo se dispara |
clickupTimer.setApiKey |
Set ClickUp API Key |
Paleta de comandos |
clickupTimer.addTask |
Add ClickUp Task |
Paleta de comandos / botón "+" en el panel |
clickupTimer.startPomodoro |
Start Pomodoro |
Ícono ▶ inline sobre cada tarea en el panel |
clickupTimer.stopPomodoro |
Stop Pomodoro |
Paleta de comandos |
Configuración de la API key
Ejecutá ClickUp Timer: Set ClickUp API Key desde la paleta de comandos
(Cmd+Shift+P / Ctrl+Shift+P) y pegá tu token personal de ClickUp. Se
guarda de forma segura vía SecretStorage, nunca en settings.json.
Screenshots
Localización
La extensión detecta automáticamente el idioma configurado en VS Code
(Configure Display Language) y muestra comandos, vistas y mensajes en
español o inglés según corresponda, usando la API nativa vscode.l10n.
Roadmap
- [ ] Publicación en el VS Code Marketplace (ícono, changelog, CI de build/publish).
Contribuir
Ver /docs para arquitectura, decisiones de diseño y notas de la API de
ClickUp. Antes de un PR: npm run lint y npm run test.
Licencia
MIT
