WakaTime en VSCode
Si no sabes cuánto tardas realmente en hacer una tarea, no puedes estimar ni planificar. WakaTime cronometra automáticamente el tiempo que pasas programando por archivo, lenguaje y proyecto. Sin pulsar botones.
1 ¿Qué es WakaTime?
WakaTime es una extensión (disponible para VSCode, JetBrains, Neovim, Sublime y muchos más) que mide de forma pasiva cuánto tiempo pasas programando. Registra:
📁 Archivo en el que trabajas
Cuánto has estado sobre anexos/ux.astro, por ejemplo.
🧪 Lenguaje
TypeScript, Java, CSS, Astro, lo que sea.
📦 Proyecto
Lo deduce por el nombre de la carpeta raíz del repositorio.
🌿 Rama de Git
Para saber en qué feature estabas trabajando.
Todo se envía a wakatime.com, donde tienes un dashboard con gráficas, desgloses y estadísticas semanales.
2 ¿Para qué lo quieres?
El principal uso práctico es aprender a estimar tareas. Cuando un cliente o un jefe te pregunta "¿cuánto tardas en hacer X?", casi siempre fallamos. Solemos subestimar 2x o 3x.
WakaTime te da datos reales de cuánto te llevó una tarea parecida en el pasado. Con el tiempo, tus estimaciones empiezan a ser fiables.
Planificación
Sabes cuánto cuesta cada tipo de tarea en horas reales.
Autoconocimiento
Detectas en qué lenguajes o archivos pierdes más tiempo.
Justificación
Evidencia medible de lo que has hecho en la semana.
3 Crear cuenta y obtener la API key
La extensión necesita una API key para enviar los datos a tu cuenta. Pasos:
Entra en wakatime.com/signup
Regístrate con email o con tu cuenta de GitHub. El plan gratuito te da los últimos 14 días de datos.
Verifica el email
Pulsa el enlace que recibes. Sin verificar no vas a ver datos en el dashboard.
Copia tu API key
Ve a wakatime.com/api-key (o Settings → Account). La key tiene este formato:
1waka_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxGuárdala a mano: la extensión te la va a pedir enseguida.
La API key es privada
Nunca la subas a git, al Slack del equipo, ni al README. Si se expone, regenérala desde el mismo panel.
4 Instalar la extensión en VSCode
Abre la pestaña de extensiones
Ctrl + Shift + X (en Mac, Cmd).
Busca e instala "WakaTime"
Publisher: WakaTime. Pulsa Install.
También desde la línea de comandos:
1code --install-extension WakaTime.vscode-wakatimePega la API key
La primera vez aparece un input arriba de VSCode pidiéndola. Pégala y pulsa Enter. Si se te cierra, ejecútalo manualmente desde la paleta de comandos:
1Ctrl+Shift+P → WakaTime: API KeyVerifica que funciona
En la barra inferior de VSCode aparece un icono con un tiempo (ej. ⏱ 12 mins).
Si pinchas encima, se abre tu dashboard web.
Dónde queda guardada la config
La extensión crea el archivo ~/.wakatime.cfg con tu API key:
1[settings]2api_key = waka_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx3# opcional: ignorar ciertas carpetas4exclude =5 COMMIT_EDITMSG$6 PULLREQ_EDITMSG$7 /node_modules/8 /dist/5 Así trabaja WakaTime mientras escribes
Una vez instalado, te olvidas de él. La extensión manda pequeños heartbeats cada vez que guardas, cambias de archivo o escribes, y suma tiempo al archivo/proyecto/lenguaje correspondiente.
WakaTime trabajando en segundo plano
No tienes que pulsar nada. Mientras editas, suma tiempo al archivo, lenguaje y proyecto.
El tiempo avanza cada segundo que estás editando. Si te vas a por un café, pausa automáticamente.
Si te quedas quieto más de 2 minutos, asume que no estás programando y pausa automáticamente. No hay botón de play/stop: ese es precisamente su mayor valor.
6 Qué ves en el dashboard
Entra en wakatime.com/dashboard. Las vistas más útiles:
Gráfica diaria
Cuántas horas programaste cada día de la última semana.
Desglose por proyecto
Cuánto tiempo llevas en cada proyecto (útil para facturar por horas).
Lenguajes y editores
Qué porcentaje de tu tiempo es TypeScript, CSS, Java, etc.
Horario de actividad
Heatmap por hora y día. Ves cuándo eres más productivo.
7 Cómo usarlo para cronometrar tareas y planificar mejor
Este es el objetivo real: que la próxima vez que alguien te pregunte cuánto tardas en hacer algo, tengas datos. Proceso simple:
1. Antes de empezar — estima
Anota tu predicción: "Creo que tardo 2h en implementar el login." Sin mirar WakaTime aún. Esto es clave para aprender a calibrar.
2. Trabaja como siempre
No cambies nada. WakaTime suma tiempo mientras editas los archivos de la feature
(suele coincidir con una rama de git: feat/login).
3. Al terminar — compara
Filtra en el dashboard por proyecto o por rama y mira las horas reales. "Estimé 2h, tardé 5h." Apúntalo.
4. Calcula tu factor de corrección
Después de 5 o 10 tareas, sabrás que multiplicas tus estimaciones por ~2.5x (o lo que sea). Esa corrección es la que tienes que aplicar al estimar la siguiente.
💡 Truco práctico
Si quieres medir una tarea concreta con precisión, créate una rama de git para esa tarea
(feat/nombre-tarea). WakaTime agrupa el tiempo por rama, así que el dato sale limpio.
8 Privacidad y plan gratuito
Qué se envía
- Nombre del archivo, proyecto, rama, lenguaje.
- Timestamp del evento.
- No se envía el contenido del archivo.
Plan gratuito
- Dashboard completo.
- Histórico de los últimos 14 días.
- Para histórico ilimitado, plan de pago (~$9/mes).
9 Checklist de puesta en marcha
- Cuenta creada en wakatime.com y email verificado.
- API key copiada desde wakatime.com/api-key.
- Extensión WakaTime instalada en VSCode.
- API key pegada cuando la extensión la pidió.
- Icono de tiempo visible en la barra inferior de VSCode.
- Al menos 2 minutos de actividad registrados en el dashboard.
- Primera tarea con estimación anotada antes de empezar.
- (Opcional) Rama de git por tarea para medir con precisión.
10 En una frase
"No puedes mejorar lo que no mides."
WakaTime convierte horas invisibles en datos. Instálalo hoy, trabaja normal, y dentro de dos semanas tendrás por primera vez una idea honesta de cuánto te cuesta cada tipo de tarea.