work

work allows manual time tracking with an interaction model inspired by git.

Documentation: this page

PyPI package: https://pypi.org/project/work/

Key concepts

Human-readable text files for storage. This makes it easy to track the log with git or perform manual edits.
The tool does not run continously and instead maintains the current state on disk.
Global work status, meaning any terminal can be used to check or update it.

Time tracking
- Track time while working and (optionally) add a category and message.
- Retroactively add and modify any entry.
Analyses
- Calculate and check the hours worked over arbitrary periods.
- List tracked entries by date or category with optional filters.
Overtime and undertime
- Configure "expected hours" and view the accumulated over-/undertime.
- (Optionally) store vacations or holidays.
Export entries as CSV

Using pipx for the installation is recommended:

pipx install work

Of course, installing with pip works as well:

pip install --user work

Find a list of example use cases on the page Examples.

Furthermore, check out the help pages: