https://github.com/oroszgy/hours

A minimalistic work time logger for the command line.
https://github.com/oroszgy/hours

cli time-tracking timesheet work-log

Last synced: 4 months ago
JSON representation

A minimalistic work time logger for the command line.

• Host: GitHub
• URL: https://github.com/oroszgy/hours
• Owner: oroszgy
• Created: 2023-11-23T20:05:03.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-01-03T13:05:49.000Z (over 2 years ago)
• Last Synced: 2025-12-28T06:41:35.854Z (6 months ago)
• Topics: cli, time-tracking, timesheet, work-log
• Language: Python
• Homepage: http://gyorgy.orosz.link/hours/
• Size: 763 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

README

          


# ⏳ Hours

[![Build](https://github.com/oroszgy/hours/actions/workflows/build.yml/badge.svg)](https://github.com/oroszgy/hours/actions/workflows/build.yml)

![PyPI - Wheel](https://img.shields.io/pypi/wheel/hours)

[![PyPI version](https://badge.fury.io/py/hours.svg)](https://pypi.org/project/hours/)

[![Downloads](https://static.pepy.tech/personalized-badge/hours?period=total&units=international_system&left_color=grey&right_color=green&left_text=Downloads)](https://pepy.tech/project/hours)

A minimalistic work time logger for the command line.





# Installation

```bash

pip install hours

```

## Usage

Let's add a client first and set the hourly rate:

```bash

hours clients add -n BigCorporate --rate 100 --currency €

hours clients list

```

Then log your work for today:

```bash

hours log -c BigCorporate -h 8.0 -p "ML pipeline" -t "fixing bugs"

```

Get a report for the current month (or any other period):

```bash

hours report 

```

Create a timesheet to Excel file:

```bash

hours export

```

For more information, see the [documentation](https://oroszgy.github.io/hours).