urenbewijs 0.1.0

Reconstrueer je urencriterium uit GitHub, Claude Code en Toggl — local-first, voor dev-ZZP'ers.

urenbewijs

Reconstrueer je urencriterium (1.225 uur/jaar) uit third-party timestamps — local-first, voor dev-ZZP'ers.

Leuker kunnen we het niet maken, wel makkelijker.

Bronnen

• GitHub commits — sessie-clustering per repo (kost je een PAT)
• Claude Code sessies — leest lokale .jsonl in ~/.claude/projects/
• Claude.ai conversaties — uit Takeout-export
• Toggl Track — voor handmatige uren (reizen, KvK, admin)
• YouTube kijkgeschiedenis — gefilterd op tech-kanalen, voor leeruren

Toggl wint bij overlap. Output: CSV + Markdown + PDF, jaartotaal en maandtotalen, met bronvermelding.

Install

Vereist uv (single-binary Python-runner).

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

Gebruik

uvx urenbewijs init    # interactieve setup — PAT, Toggl, etc.
uvx urenbewijs run     # genereer rapport
uvx urenbewijs where   # toon paden van config + output

Config en tokens komen in ~/.urenbewijs/. Output in ~/.urenbewijs/output/.

Andere modi

uvx urenbewijs run --year 2025                  # vorig jaar
uvx urenbewijs run --source github,claude_code  # subset bronnen
uvx urenbewijs run --no-pdf --no-dedup          # debug
uvx urenbewijs run --verbose                    # toon elke sessie

Dagelijks automatisch

Windows Task Scheduler:

$uvx     = (Get-Command uv).Source
$action  = New-ScheduledTaskAction -Execute $uvx -Argument 'tool run urenbewijs run'
$trigger = New-ScheduledTaskTrigger -Daily -At 22:00
$set     = New-ScheduledTaskSettingsSet -StartWhenAvailable -ExecutionTimeLimit (New-TimeSpan -Minutes 30)
$user    = New-ScheduledTaskPrincipal -UserId $env:USERNAME -LogonType Interactive
Register-ScheduledTask -TaskName 'urenbewijs' `
  -Action $action -Trigger $trigger -Settings $set -Principal $user

macOS/Linux: gebruik cron of launchd.

Privacy

• Alle tokens staan in ~/.urenbewijs/.env — op Unix chmod 0600
• Tool draait local-only — geen calls naar 1225.nl backend
• Output bevat geen ruwe message-content, alleen aggregaten

Development

git clone https://github.com/cryptoprins-ship-it/uren-administratie
cd uren-administratie
uv run --with-editable . urenbewijs --help

Status

• GitHub source (PAT-based)
• Claude Code source (auto-detect ~/.claude/projects/)
• Claude.ai export source
• Toggl source
• YouTube/learning source (Takeout-based)
• Deduplicatie (Toggl > claude_code > claude_web > learning > github)
• CSV + Markdown + PDF rapport
• init wizard
• PyPI publish

License

MIT — zie LICENSE.