Sistema de Comandos do TimeWarrior

O TimeWarrior utiliza uma sintaxe minimalista baseada em linha de comando, estruturada como:

timew [--version | --help | <comando> [<argumentos>]]

Elementos-chave incluem:

• Comando: Define a ação principal (ex: start, stop, track)
• Subcomando: Detalha o comportamento (ex: tag list, tag remove)
• Data: Representa momentos temporais (14:30, yesterday, 2025-09-09)
• Intervalo: Define faixas de tempo (09:00 - 12:00, 2h ago - now)
• Etiquetas: Identificadores para categorização (#coding, @projectX)
• Filtros: Limitam operações por ID ou atributo (@1, #meeting)
• Dicas: Modificam o comportamento (:quiet, :yes)

Operações Fundamentais com Tempo

Iniciar e Encerrar Rastreamento

# Iniciar sem etiquetas
timew start

# Iniciar com etiquetas específicas
timew start #design @clientB

# Definir horário de início personalizado
timew start yesterday 16:00 #review

# Parar o rastreamento atual
timew stop

# Parar com horário específico
timew stop 17:30

# Parar e iniciar imediatamente um novo intervalo
timew stop :continue #documentation

Corrigir Intervalos Incompletos

# Cancelar o rastreamento ativo
timew cancel

# Cancelar silenciosamente
timew cancel :quiet

Registro Direto de Intervalos com Track

O comando track combina início e fim, ideal para registrar trabalho concluído.

# Registrar 2 horas de desenvolvimento ontem
timew track yesterday 14:00 for 2h #development @backend

# Registar período entre 9h e 11h hoje
timew track 09:00 - 11:00 #coding

# Usar referências relativas
timew track last tuesday 3h #report-writing

Gerenciamento Inteligente de Etiquetas

Estratégias eficazes de etiquetagem melhoram análise de dados.

# Adicionar etiqueta ao último intervalo
timew tag @1 #urgent

# Remover etiquetas de múltiplos registros
timew tag remove @2 @3 #meeting #internal

# Listar todas as etiquetas usadas
timew tags :verbose

# Verificar frequência de uso
timew tags | sort -nr

Dica prática: Use uma hierarquia de três níveis: tipo de atividade (#coding), projeto (@project-alpha), prioridade (!high).

Técnicas Avançadas de Manipulação Temporal

Ajustar Durações e Horários

# Aumentar duração de 15 minutos
timew lengthen @1 15m

# Reduzir duração de um intervalo
timew shorten @3 30m

# Definir início e fim exatos
timew modify @2 start 10:15 end 11:45

Dividir e Mesclar Intervalos

# Dividir em dois intervalos iguais
timew split @1

# Dividir em um ponto específico
timew split @1 at 10:30

# Unir intervalos adjacentes com mesma etiqueta
timew join @2 @3

Consultas Precisas com Filtros

# Mostrar todos os registros do dia
timew show today

# Filtrar por período
timew show last week #coding

# Excluir certos tipos
timew show :not #meeting

# Buscar por projeto e prioridade
timew show @projectX !high

Relatórios e Visualizações Dinâmicas

Resumos Estratégicos

# Resumo diário
timew summary today

# Resumo semanal agrupado por etiqueta
timew summary week :group tags

# Relatório detalhado mensal
timew summary last month :details

Gráficos Interativos

# Distribuição diária em gráfico circular
timew chart day

# Comparação diária semanal
timew chart week

# Tendência mensal
timew chart month

Exportação para Análise Externa

# Exportar para CSV
timew export csv > work_hours.csv

# Exportar em JSON para processamento automatizado
timew export json :quiet > data.json

# Relatório personalizado em formato tabela
timew report summary :tags #coding,#testing :format table

Cenários Reais e Soluções

1. Análise de Tempo por Projeto

# Relatório de tempo gasto nos últimos 14 dias
timew summary 2 weeks ago to today :group tags :format table

# Exportar dados para análise em Excel
timew export csv :from 2025-08-26 :to 2025-09-08 > project_data.csv

2. Correção de Erros em Registros

# Verificar registro de ontem
timew show yesterday

# Ajustar final de um intervalo incorreto
timew modify @7 end yesterday 18:30

# Reverter alterações se necessário
timew undo

3. Relatório Semanal Automatizado

Crie um script bash para gerar relatórios semanais:

#!/bin/bash
REPORT_FILE="weekly_report_$(date +%Y-%m-%d).md"

echo "# Relatório Semanal de Tempo" > $REPORT_FILE
echo "## Tempo Total por Categoria" >> $REPORT_FILE
timew summary week :format markdown >> $REPORT_FILE

echo "## Detalhes por Projeto" >> $REPORT_FILE
timew summary week :group tags :format markdown >> $REPORT_FILE

# Enviar por email (requer configuração de mail)
cat $REPORT_FILE | mail -s "Relatório Semanal $(date +%Y-%m-%d)" team@example.com

Agende com cron:

# Executar toda sexta às 16h
0 16 * * 5 /path/to/weekly_report.sh

Personalização e Otimização

Configuração Personalizada

Arquivo localizado em ~/.timewarrior/timewarrior.cfg:

daystart = 08:30
weekstart = monday
theme = dark_blue
summary.hours = on

# Definir relatórios customizados
define report.weekly : filter 'last week' : group tags : format table

Aplicar mudanças:

timew config daystart 08:30
timew config report.monthly 'filter "last month" : group tags : format markdown'

Extensões e Integração

# Listar extensões disponíveis
timew extensions

# Instalar suporte para CSV
timew extensions install csv

# Criar extensão personalizada
# Local: ~/.timewarrior/extensions/burn-down.py

Dicas de Produtividade

• Aliases úteis: adicione no .bashrc: ``` alias tw='timew' alias tws='timew start' alias twe='timew stop' alias twt='timew track' alias twd='timew show today'

• Completamento automático: inclua: ``` source /path/to/timewarrior/completion/timew-completion.bash

• Dicas avançadas: use :blank para criar entradas vazias, :yes para confirmar automaticamente, :quiet em scripts.

Problemas Comuns e Soluções

Problema	Solução
Esquecer de parar rastreamento	Use timew modify @id end [horário]
Etiqueta errada aplicada	Use timew untag @id tag
Necessidade de mesclar intervalos	Use timew join @id1 @id2
Quer analisar um projeto específico	Use timew summary :filter @projeto
Formato de relatório inadequado	Customize via config ou exporte para ferramentas externas
Esquecer comandos	Crie um cheat sheet ou use timew help <comando>

Conclusão e Caminho para Especialistas

O TimeWarrior oferece um sistema robusto e modular para controle preciso do tempo, especialmente útil para profissionais que dependem de precisão em gestão de tarefas. Os conceitos abordados incluem:

• Modelo de comandos escalonável e lógico
• Manipulação dinâmica de intervalos
• Consulta intelignete com filtros combinados
• Integração com scripts e automação
• Extensibilidade via plugins

Recursos recomendados:

• timew help commands – Referência completa de comandos
• timew help dates – Formatos de datas suportados
• timew help ranges – Sintaxe avançada de intervalos

Domine o TimeWarrior não apenas como ferramenta de rastreamento, mas como sistema de tomada de decisão baseada em dados reais do seu fluxo de trabalho.