LinuxCommandLibrary

timetrap

Simple command-line time tracking

TLDR

Start timer

$ timetrap in "[task description]"
copy
Stop timer
$ timetrap out
copy
Show current
$ timetrap now
copy
Display today
$ timetrap display
copy
Switch sheet
$ timetrap sheet [project]
copy
List sheets
$ timetrap list
copy
Edit entry
$ timetrap edit
copy

SYNOPSIS

timetrap command [options] [args]

DESCRIPTION

timetrap is a simple command-line time tracking tool that uses a clock in/out model. You start a timer with in and stop it with out, and entries are stored in a local SQLite database for reliable, portable storage.
Time entries are organized into sheets, which act as separate timesheets for different projects or clients. Switching between sheets with the sheet command makes it easy to track time across multiple activities without mixing entries.
The display command shows logged entries with calculated durations, and reporting features provide time summaries for billing or review. Entries can be edited after the fact to correct mistakes or add notes.

PARAMETERS

in

Start tracking.
out
Stop tracking.
now
Current status.
display
Show entries.
sheet
Switch timesheet.
list
List sheets.
edit
Edit entries.

CAVEATS

Ruby required. Command-line only. Manual entry.

HISTORY

timetrap was created as a simple command-line time tracking tool using SQLite for storage.

SEE ALSO

watson(1), timew(1), tog(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community