GitScrum / Docs

Tareas

Gestiona tareas de GitScrum desde tu terminal. Lista, crea, actualiza tareas y crea ramas con detección automática de Git.

⚠️ BETA — GitScrum CLI está en desarrollo activo. Open source bajo licencia MIT. Disponible en GitHub.

Gestión de tareas sin cambiar de contexto. El CLI detecta automáticamente tu tarea desde la rama Git.


Referencia Rápida

gitscrum tasks                        # Listar tus tareas
gitscrum tasks view a1b2c3d4          # Ver detalles
gitscrum tasks current                # Tarea actual (desde rama Git)
gitscrum tasks create -t "Título"     # Crear tarea
gitscrum tasks complete a1b2c3d4      # Marcar como completada
gitscrum tasks branch a1b2c3d4        # Crear rama desde tarea
gitscrum tasks comment a1b2c3d4       # Ver/añadir comentarios
gitscrum tasks today                  # Tareas para hoy

Listar Tareas

gitscrum tasks
CODE      TITLE                              STATUS         EFFORT
GS-1234   Refactorizar módulo auth           En Progreso    8 pts
GS-1235   Agregar tests OAuth                TODO           3 pts
GS-1236   Actualizar documentos API          En Revisión    2 pts

Filtros

# Por status del workflow
gitscrum tasks --workflow "in-progress"
gitscrum tasks --workflow todo
gitscrum tasks --workflow done

# Por tipo
gitscrum tasks --type bug
gitscrum tasks --type feature

# Por asignado
gitscrum tasks --assignee @john

# Solo bloqueadores
gitscrum tasks --filter blocker

# Paginación
gitscrum tasks --limit 50
gitscrum tasks --page 2

Tarea Actual

El CLI detecta automáticamente la tarea desde la rama Git:

$ git checkout feature/GS-123-auth

$ gitscrum tasks current
📋 GS-123: Refactorizar módulo de autenticación
   Estado: En Progreso | Sprint 15

Ver Detalles

gitscrum tasks view a1b2c3d4
GS-1234: Refactorizar módulo de autenticación
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Estado:     En Progreso
Tipo:       Feature
Effort:     8 pts
Sprint:     Sprint 15 (Día 5 de 10)
Asignado:   john@empresa.com

Descripción:
  Refactorizar el módulo de autenticación para usar OAuth 2.0

Ver con comentarios

gitscrum tasks view a1b2c3d4 --comments

Ver con timers

gitscrum tasks view a1b2c3d4 --timers

Crear Tarea

gitscrum tasks create -t "Implementar login OAuth"

Con opciones

gitscrum tasks create -t "Implementar login OAuth" \
  --type feature \
  --description "Implementar OAuth 2.0 Device Flow"

Completar Tarea

gitscrum tasks complete a1b2c3d4
✓ GS-1234 marcada como completada

Crear Rama

Crea una rama Git desde la tarea:

gitscrum tasks branch a1b2c3d4
✓ Creada rama: feature/GS-1234-refactorizar-modulo-auth
✓ Cambiado a la rama

Comentarios

Ver comentarios

gitscrum tasks comment a1b2c3d4

Añadir comentario

gitscrum tasks comment a1b2c3d4 -m "Código revisado y listo para merge"

Formato de Salida

gitscrum tasks --json       # JSON para scripts
gitscrum tasks -q           # Modo silencioso (solo códigos)

Ejemplo con jq

# Listar todos los códigos de tareas
gitscrum tasks --json | jq '.[].ref_code'