GitScrum / Docs

Tarefas

Gerencie tarefas GitScrum do terminal. Liste, crie, atualize tarefas e crie branches com detecção automática de Git.

⚠️ BETA — GitScrum CLI está em desenvolvimento ativo. Open source sob licença MIT. Disponível no GitHub.

Gestão de tarefas sem trocar de contexto. O CLI detecta automaticamente sua tarefa da branch Git.


Referência Rápida

gitscrum tasks                        # Listar suas tarefas
gitscrum tasks view a1b2c3d4          # Ver detalhes
gitscrum tasks current                # Tarefa atual (da branch Git)
gitscrum tasks create -t "Título"     # Criar tarefa
gitscrum tasks complete a1b2c3d4      # Marcar como concluída
gitscrum tasks branch a1b2c3d4        # Criar branch da tarefa
gitscrum tasks comment a1b2c3d4       # Ver/adicionar comentários
gitscrum tasks today                  # Tarefas para hoje

Listar Tarefas

gitscrum tasks
CODE      TITLE                              STATUS         EFFORT
GS-1234   Refatorar módulo auth              Em Progresso   8 pts
GS-1235   Adicionar testes OAuth             A Fazer        3 pts
GS-1236   Atualizar docs API                 Em Revisão     2 pts

Filtros

# Por status do 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 responsável
gitscrum tasks --assignee @john

# Apenas bloqueios
gitscrum tasks --filter blocker

# Paginação
gitscrum tasks --limit 50
gitscrum tasks --page 2

Tarefa Atual

O CLI detecta automaticamente a tarefa da branch Git:

$ git checkout feature/GS-123-auth

$ gitscrum tasks current
📋 GS-123: Refatorar módulo de autenticação
   Status: Em Progresso | Sprint 15

Ver Detalhes

gitscrum tasks view a1b2c3d4
GS-1234: Refatorar módulo de autenticação
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Status:     Em Progresso
Tipo:       Feature
Effort:     8 pts
Sprint:     Sprint 15 (Dia 5 de 10)
Responsável: john@empresa.com

Descrição:
  Refatorar o módulo de autenticação para usar OAuth 2.0

Ver com comentários

gitscrum tasks view a1b2c3d4 --comments

Ver com timers

gitscrum tasks view a1b2c3d4 --timers

Criar Tarefa

gitscrum tasks create -t "Implementar login OAuth"

Com opções

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

Completar Tarefa

gitscrum tasks complete a1b2c3d4
✓ GS-1234 marcada como concluída

Criar Branch

Crie uma branch Git a partir da tarefa:

gitscrum tasks branch a1b2c3d4
✓ Criada branch: feature/GS-1234-refatorar-modulo-auth
✓ Alterado para a branch

Comentários

Ver comentários

gitscrum tasks comment a1b2c3d4

Adicionar comentário

gitscrum tasks comment a1b2c3d4 -m "Código revisado e pronto para merge"

Formato de Saída

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

Exemplo com jq

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