toki (時) is a Bash wrapper around
timew, the Timewarrior CLI.
- Extra commands
- Convenient aliases for built-in commands
- Extended duration syntax (e.g.
timew track tag for 1h35m20s) - Allows using
mas suffix for minutes instead of months - Acts on the latest interval by default
- Notifies of errors when running
timewoutside of a terminal - Thoroughly tested
Make sure you have installed Timewarrior first.
Note:
tokiis only compatible with the 1.4.x version oftimew
Clone the repo or download the scripts from the latest release,
and make sure they're executable (chmod +x <scripts>).
The toki script can be use in place of timew (one character less to type!).
Or, if you don't want to retrain your fingers, you can alias timew to toki
and get all of its benefits transparently.
The toki-restart commands uses jq to parse JSON, so you need to
install jq if you want to use it.
Source _completion.bash in your bashrc to enable better completion.
toki is used exactly like timew, with a few additions and differences that
are listed below.
Commands that expect an ID (delete, tag, lengthen, etc.) will default to
@1 if none is provided.
toki-cut: stop tracking and truncate the stopped interval to the closest minutetoki-restart: cancel and restart an intervaltoki-restore: resume tracking of the last interval and automatically fill the gaptoki-switch: cut the current interval and starts another
See toki help <command> for more info.
lengthen:+,extendshorten:-,reducejoin:mergetrack:t,a,add,recordcontinue:restartdelete:d,remove
toki adds support for the following duration syntaxes:
<minutes>m(themsuffix is treated as minutes instead of months)<hours>h<minutes><hours>h<minutes>m<hours>h<minutes>m<seconds><hours>h<minutes>m<seconds>s
Contributions are welcomed! Please open an issue before submitting substantial changes.
- https://timewarrior.net/docs - The official Timewarrior manual
ISC