TimeCoder
Descripción
TimeCoder es una extensión para Visual Studio Code que te permite medir y analizar tu tiempo de codificación. Obtén informes detallados de tu actividad de programación por lenguaje, proyecto, plataforma y rama git.
Características
- ✅ Seguimiento automático de actividad - Mide tu tiempo de codificación sin interrumpir tu flujo de trabajo
- 📊 Informes detallados - Visualiza estadísticas diarias y semanales en un panel integrado
- 🔄 Sincronización en la nube - Accede a tus datos desde cualquier dispositivo
- 🔎 Análisis por lenguaje - Descubre en qué lenguajes pasas más tiempo
- 🌳 Seguimiento de ramas git - Analiza el tiempo dedicado a cada rama de tus proyectos
- 🔍 Monitoreo de sesiones de depuración - Diferencia entre tiempo de codificación y depuración
- 🔌 Integración multiplataforma - Compatible con Windows, macOS y Linux
Requisitos
- Visual Studio Code 1.97.0 o superior
- Extensión Git de VS Code para funcionalidades de ramas
- Conexión a internet para sincronización de datos
Instalación
Desde VS Code Marketplace
- Abre VS Code
- Ve a la vista de extensiones (
Ctrl+Shift+X)
- Busca "TimeCoder"
- Haz clic en "Instalar"
Configuración inicial
Para comenzar a utilizar TimeCoder necesitas configurar una API Key:
- Después de instalar la extensión, verás una notificación solicitando configurar la API Key
- Puedes configurarla de dos formas:
- Automáticamente: Haz clic en "Obtener API Key desde el portal", inicia sesión en el portal web y autoriza la conexión
- Manualmente: Haz clic en "Configurar API Key manualmente" e introduce tu clave
También puedes configurar la API Key en cualquier momento:
- Abre la paleta de comandos con
Ctrl+Shift+P (Windows/Linux) o Cmd+Shift+P (Mac)
- Busca y selecciona "TimeCoder: Configurar API Key"
Uso
Una vez configurada la extensión, comenzará a rastrear automáticamente tu tiempo de codificación.
Para ver tus informes de actividad:
- Haz clic en el ícono de TimeCoder en la barra de actividades (lateral)
- O usa el comando "TimeCoder: Mostrar reporte" desde la paleta de comandos
Informe diario: Muestra estadísticas del día actual, incluyendo:
- Tiempo total de codificación
- Distribución por lenguaje
- Distribución por proyecto y plataforma
- Tiempo de depuración vs. codificación
Informe semanal: Muestra estadísticas de la semana actual, incluyendo:
- Resumen de actividad diaria
- Lenguajes más utilizados
- Proyectos y plataformas con más actividad
Cómo funciona
TimeCoder realiza un seguimiento de tu actividad mientras programas:
- Registra eventos como cambios en archivos y cambios de documento activo
- Detecta periodos de inactividad y los excluye de las métricas
- Identifica las ramas de git en las que trabajas
- Detecta sesiones de depuración
- Envía datos bajo tu usuario al servidor para procesamiento
- Recibe informes procesados y los muestra en la interfaz
Toda la información se envía de forma segura y puedes ver exactamente qué datos se están recopilando.
Privacidad
TimeCoder solo recopila datos relacionados con tu actividad de programación:
- Nombres de proyectos y archivos
- Lenguajes utilizados
- Tiempo de actividad
- Nombres de ramas git
- Plataforma y nombre de máquina
No se recopilan datos personales ni el contenido de tus archivos.
Solución de problemas
Si experimentas problemas:
- Verifica que tu API Key esté configurada correctamente
- Asegúrate de tener conexión a internet
- Reinicia VS Code si los informes no se cargan
- Verifica que la extensión Git esté instalada para el seguimiento de ramas
Desarrollo
Estructura del proyecto
- src: Código fuente de la extensión principal
- react-app: Aplicación React para la UI de los informes
- resources: Recursos estáticos (iconos, etc.)
Comandos útiles
# Instalar dependencias
bun install
# Desarrollo (compila la extensión y React en modo watch)
bun run dev
# Compilar la extensión y la UI
bun run build
# Empaquetar para distribución
bun run package
Contribución
¡Las contribuciones son bienvenidas! Si quieres contribuir:
- Haz fork del repositorio
- Crea una rama para tu característica (
git checkout -b feature/amazing-feature)
- Haz commit de tus cambios (
git commit -m 'Add some amazing feature')
- Push a la rama (
git push origin feature/amazing-feature)
- Abre un Pull Request
Licencia
Este proyecto está licenciado bajo la Licencia MIT - ver el archivo LICENSE.md para más detalles.
Desarrollado por
Sofka Technologies
¿Tienes preguntas o comentarios? Abre un issue en nuestro repositorio.
