st is a command line application that enables adding time data from the command line, and listing projects and buckets from the command line.
If using a desktop computer, or laptop computer, one can run STOPTHAT GUI. The GUI enables adding time data, listing projects, listing buckets. But some devices may only have the command line. st brings some of the functions to the command line.
st is a short form of “stop that”. It has two subcommands, add and list.
Help text for st:
Add Time Date
The main thing you would do with st is add time data from the command line. Use st add for this purpose. Example:
This would add a datum right now, to project with ID KSPL, saying I just finished the task of adding a page to the website.
You can also enter a date override to enter data for some time other than right now. Example:
This would add a datum saying that fifteen minutes ago I finished checking email, and assign that time to the MISC project.
Help text for st add:
When you are adding time data from the command line, you may need to be reminded about what project IDs you have configured. Use st list for this purpose. Example:
This would list all projects in the bucket “mybucket”.
You may even need a reminder about what buckets you have configured. st list can also list the buckets, like this:
Help text for st list: