A helper for keeping time. Primarily intended for Unix systems. No widgets involved, just simple command line.

Install

npm i -g today-cli

Usage

You can use it in interactive mode or via commands.

Interactive Mode

today

You'll get prompts.

CLI Commands

When required, all dates must be in YYYY-MM-DD format.

Show Tasks & Totals

Can also use: . (period), s

today show [<date>]

If date is not specified today is implied. You can get a date selector by passing "-" and you can get the previous day with records by passing "prev".

today .
today s
today show
# all the above show today

today show 2020-01-01
# shows specific date

today show -
# you can select from a list

today show prev
# shows previous day

Show Path to Tasks File

If you want to edit the file use edit command instead.

It's easier to tweak it directly if you really need to change some previous values in major ways.

today path [<date>]

If date is not specified today is implied.

today path
today path 2020-01-01

Edit Tasks File

Edit the tasks file directly.

today edit [<date>]

If date is not specified today is implied.

today edit
today edit 2020-01-01

New Task

Creates new task. Ends previous task (if it's not ended), starts new one.

If you place a semicolon in a task name everything after it is interpreted as a description and everything before as the (group) name of the task.

Can also use: n start task

today next <name>[:<description>]

today next break
today next dev: server
today next dev: ui
today next dev: css
today n dev
today start dev
today task dev

The last 3 entries above are just "dev". As such you will only get totals for "break" and "dev" when you use show.

List All Dates

Lists known dates.

today list

End Last Task

Intended to be used for end of day. You can also use it to create breaks between tasks. If you provide a time that will be used as the end time.

today end
today end 19:00

End Last Task

Opposite of end. Removes end time from last task.

today resume

Continue Last Task

Takes name of last task and starts new task with it. Will warn you if last task is ongoing or there isn't one.

today continue

Just Show Totals

Like show but only shows totals.

today total [<date>]

If date is not specified today is implied.

today total
today total 2020-01-01