Getting Started

Install

go install github.com/heuwels/hrs@latest

Or build from source:

git clone https://github.com/heuwels/hrs
cd hrs
go build -o hrs .

Start the server

hrs serve --db ~/hrs.db --dir ~/worklogs/

--dir is where markdown files get rendered. Point it at a directory your editor or TUI watches.

Log something

# via CLI
hrs log -c dev -t "first entry" -b "hello world" -e 0.1

# via curl
curl -X POST http://localhost:9746/entries -d '{
  "category": "dev",
  "title": "first entry",
  "bullets": ["hello world"],
  "hours_est": 0.1
}'

View your logs

# print today's log
hrs ls

# launch the TUI
hrs tui

Migrate existing markdown

If you have existing YYYY-MM-DD.md worklog files:

hrs migrate --dir ~/worklogs/