PTO CLI
A PHP command-line tool for calculating remaining paid time off days, with support for accrual policies, part-time scaling, German public holidays, and year-end carry-over caps.
Overview
PTO CLI is an open-source command-line tool I built to solve a real problem I encountered: accurately calculating how many paid vacation days remain when working in Germany. German labour law has specific rules around accrual, part-time scaling, and public holidays that vary by state — all of which existing tools either ignored or got wrong. The CLI handles all of this correctly from the terminal.
My Role
I designed and built the entire tool from scratch as a personal open-source project. The goal was a zero-dependency, single-command tool that any developer could run without a web app or spreadsheet.
Key Contributions
- Supports multiple accrual policies including monthly, anniversary, and front-loaded yearly
- Part-time scaling automatically adjusts entitlement based on contracted weekly hours
- Accounts for German public holidays by federal state, correctly excluding them from PTO counts
- Year-end carry-over caps enforce company policies and expire unused days automatically