GitScrum / Docs

Timer

Contrôlez votre temps depuis le terminal. Démarrez, arrêtez, enregistrez manuellement et générez des rapports.

⚠️ BETA — GitScrum CLI est en développement actif. Open source sous licence MIT. Disponible sur GitHub.

Suivi du temps sans friction. Démarrez le timer, continuez à coder.


Commandes Disponibles

CommandeDescription
gitscrum timerVoir le statut du timer actif
gitscrum timer start [uuid]Démarrer timer pour une tâche
gitscrum timer stopArrêter et enregistrer le temps
gitscrum timer logEnregistrer le temps manuellement
gitscrum timer reportRapport de temps
gitscrum timer productivityMétriques de productivité

Démarrer Timer

Démarrez le timer pour la tâche actuelle (détectée depuis votre branche Git):

gitscrum timer start
⏱️  Timer démarré pour GS-1234: Refactoriser module auth
    Depuis: 09:15

Ou spécifiez une tâche:

gitscrum timer start a1b2c3d4

Ajoutez un message:

gitscrum timer start -m "Implémentation validation"

Voir Timer Actif

gitscrum timer
⏱️  Timer Actif

Tâche:   GS-1234 - Refactoriser module auth
Projet:  backend-api
Durée:   01:47:32
Début:   09:15

Arrêter Timer

Arrête et enregistre le temps automatiquement:

gitscrum timer stop
⏱️  Timer arrêté

Tâche:        GS-1234 - Refactoriser module auth
Durée:        2h 34m
Total jour:   4h 49m

✓ Temps enregistré

Enregistrer Temps Manuel

Utilisez quand vous avez oublié de démarrer le timer:

gitscrum timer log

Flags disponibles:

# Avec code de tâche
gitscrum timer log --code a1b2c3d4

# Avec durée
gitscrum timer log --duration 2h30m

# Avec message
gitscrum timer log -m "Revue de code"

Rapport de Temps

Rapport Personnel

gitscrum timer report
⏱️  Rapport de Temps - Cette Semaine

Lun   │ ████████████████░░░░ │ 6h 30m
Mar   │ ████████████████████ │ 8h 15m
Mer   │ ██████████████░░░░░░ │ 5h 45m
Jeu   │ ██████████████████░░ │ 7h 20m
Ven   │ ████████░░░░░░░░░░░░ │ 3h 15m

Total: 31h 05m

Rapport Hebdomadaire

gitscrum timer report --week

Rapport d'Équipe

gitscrum timer report --team

Métriques de Productivité

gitscrum timer productivity
📊 Productivité - 7 derniers jours

Moyenne jour:    6h 13m
Focus continu:   2h 45m
Tâches/jour:     4.2

Distribution:
  Développement  ████████████████░░░░  68%
  Revue          ████░░░░░░░░░░░░░░░░  18%
  Réunions       ███░░░░░░░░░░░░░░░░░  14%

Avec période spécifique:

gitscrum timer productivity --period month

Exemples Pratiques

Flux Quotidien

# Matin: démarrer travail
gitscrum timer start

# Déjeuner: arrêter timer
gitscrum timer stop

# Après-midi: reprendre
gitscrum timer start

# Fin de journée: arrêter et vérifier
gitscrum timer stop
gitscrum timer report

Enregistrement Manuel post-réunion

gitscrum timer log --duration 1h -m "Réunion de planification"

Flags Disponibles

FlagDescription
-m, --messageAjouter description
--weekRapport hebdomadaire
--teamRapport d'équipe
--periodPériode (week, month)
--durationDurée pour log manuel
--codeCode de la tâche