clock

Track your working hours on the command line

Install

Available as a bpkg

bpkg install [-g] lordvlad/clock

Usage

clock <command> [<task>] [<options>]

Commands

  • clock help show the help
  • clock in clock in, will clock out any running task
  • clock out clock out
  • clock log show all log entries, or log entries for <task>
  • clock list show sums for all tasks

Task

If no task is specified, the current working directory will be used as task identifier

Options

  • -m|--message record additional message when clocking in/out
  • -f|--file where to save the clocks, defaults to $HOME/.clocks
  • --by-task sort log entries by task for clock log
  • --gt=DATE with clock log, show only entries after DATE, with clock list sum up only entries after DATE. DATE can be any string that unix’ date understands
  • --lt=DATE with clock log, show only entries before DATE, with clock list sum up only entries before DATE. DATE can be any string that unix’ date understands

Examples

$ mkdir -p tasks/{work,sleep}
$ clock in tasks/work
> clocked in /home/lordvlad/tasks/work
$ clock in tasks/sleep
> clocked out /home/lordvlad/tasks/work
> clocked in /home/lordvlad/tasks/sleep
$ clock out
> clocked out /home/lordvlad/tasks/sleep
$ clock log
> Tue 21 Apr 2015 06:31:24 PM UTC 00:01:23        /home/lordvlad/tasks/work
> Tue 21 Apr 2015 06:32:47 PM UTC 00:00:04        /home/lordvlad/tasks/sleep
$ clock list
> 00:00:04        /home/lordvlad/tasks/sleep
> 00:01:23        /home/lordvlad/tasks/work

Published: April 19 2015

blog comments powered by Disqus