bitstillery
← Terug naar de blog

Wakamonth: urenrapportages uit WakaTime

Weten waar je tijd blijft is handig. Je ziet welke delen van de code steeds uren opslokken, het zegt iets over technische schuld, en soms heb je gewoon een urenrapportage nodig. Maar uren met de hand bijhouden vraagt discipline, en als het druk wordt, schiet dat er als eerste bij in. Wat we wilden was een stopwatch die vanzelf loopt, en die weet aan welk project en welke branch we werken.

Wat we eerst probeerden

We begonnen met de Tempo-plugin voor Jira, maar daarmee moest je uren met de hand op issues zetten, zonder koppeling met de code. Toen we overstapten op GitLab, kwamen issues en merge requests veel dichter bij elkaar, maar GitLab kan je niet goed laten zien hoeveel uur je in een periode hebt gewerkt. Je kunt tijd op issues boeken, en daar houdt het ongeveer op.

WakaTime en Wakapi

Toen vonden we WakaTime, een soort Fitbit voor programmeren. Een plugin in je editor stuurt tijdens het werk ongemerkt kleine “heartbeats”, die hij zelfs bewaart als je offline bent, en WakaTime maakt daar tijd per project, branch en bestand van.

Het Wakapi-dashboard op een laptop

Wij draaien Wakapi, een open source server die dezelfde taal spreekt als WakaTime, zodat de data bij ons blijft. Je kunt hem zelf op een kleine server zetten, of hun gehoste versie gebruiken. De editor-plugins merken het verschil niet.

Wakamonth

Wat nog ontbrak was een rapportage: hoeveel uur heb ik deze maand waaraan besteed? Daarom schreven we Wakamonth. Het vraagt een maand aan data op bij de API van WakaTime of Wakapi en maakt daar uren per branch van, in de terminal of als Excel-bestand:

bunx @bitstillery/wakamonth -y 2024 -m 1 -p myproject report
Wakamonth-rapport in de terminal, met uren per branch

Bedenk wel dat bijgehouden tijd een schatting is, niet iets om zonder controle op een factuur te zetten. Maar het geeft een veel beter beeld van waar de uren heen gingen dan wat we vroeger uit ons hoofd opschreven.

Dank aan WakaTime, aan Wakapi-maker Ferdinand Mütsch, en aan de makers van de WakaTime-browserextensie, die de ondersteuning voor de laatste branch toevoegden die we nodig hadden.

Laten we kennismaken

Benieuwd wat we doen, of wat we voor je kunnen betekenen? We horen graag van je.