Simtt - Interactive Simple Time Tracker for the CLI in PHP

Read the full documentation

The project was inspired by badcrocodile/cltt.

Getting started

Start timer and Status

What have I done today?

What did I do yesterday?

Installation

$ composer create-project sigma-z/simtt

Linux/MacOS

$ ./simtt --version

Windows

$ php simtt --version

Implemented features

This is an early project state. At the moment the tool can do:

• start a timer
• update the start of a timer
• stop a timer
• update the stop of a timer
• status whether a timer is running or not

Limitations

• it is not possible to track times across days

Quick feature overview

Usage ./simtt -i to run the Simple Time Tracker in interactive mode. You then can run a lot of commands directly by typing and pressing <enter>:

start [time<hhmm|hh:mm>] [task-name]

starts a timer at a given time for a named task. Note: time and task name can be left blank.

• implemented

start* [time<hhmm|hh:mm>] [task-name]

updates the start of last log entry. Note: time and task name can be left blank.

• implemented

stop [time<hhmm|hh:mm>] [task-name]

stops a timer at a given time for a named task. Note: time and task name can be left blank, a given task name will overwrite the task name given at the start.

• implemented

stop* [time<hhmm|hh:mm>] [task-name]

updates the stopping time of last log entry. Note: time and task name can be left blank.

• implemented

continue [time<hhmm|hh:mm>]

continues last stopped task for a given time.

• implemented

status

shows status whether a task is running, or not.

• implemented

now

shows current time (which can be different because of your configuration - see config precision)

• implemented

task[-offset] [<string>task-name]

updates a task text for a specified or currently running task. See also the documentation.

• implemented

comment[-offset] [<string>comment]

updates a comment for a specified or currently running task. See also the documentation.

• implemented

tasks

shows a list of the latest time tracked tasks

• implemented

log [range-selection<int>]

shows the latest log entries by range.

• implemented

day [sum]

shows the log entries of today. If "sum" is defined, it shows the log entries summarized.

• implemented

day-1 [sum] or yesterday [sum]

shows the log entries of yesterday. If "sum" is defined, it shows the log entries summarized.

• implemented

day-n [sum]

shows the log entries for n-days before today. If "sum" is defined, it shows the log entries summarized.

• implemented

You can do the same type of output for week and month.

• week implemented
• month implemented