Track your time from the command-line
This is a command line interface (CLI) that connects to a TimeTagger server. This can be the server at https://timetagger.app, or a self-hosted server.
The idea is to provide a quick way to track time for devs who are already using a terminal.
The TimeTagger CLI requires Python 3.6 or higher. Install with pip
:
$ pip install timetagger_cli
After installation, you should be able to use the timetagger
command.
Start by running timetagger setup
to setup the API's url and authentication token.
Run timetagger
without arguments to get the list of available subcommands:
$ timetagger
usage: timetagger command [arguments]
Track your time from the command-line, a CLI for https://timetagger.app.
Available commands:
version
Print version.
help
Show this help message and exit.
app
Open the TimeTagger app in your default browser.
setup
Edit the API URL and token by opening the config file in your default editor.
status
Get an overview of today and this week. The exact content may change.
start DESCRIPTION
Start timer with the given description. Use '#' to create tags.
stop
Stop any running timers.
$ timetagger status
Hours clocked this week: 11:42
Hours clocked today: 7:00
Running: 0:01 - #timeapp #oss more cli
Todays records:
Started Stopped Duration Description
2021-03-23 09:05 09:42 0:37 #oss #vispy prep
2021-03-23 09:42 12:12 2:30 #timeapp #oss cli
2021-03-23 13:06 14:00 0:53 #timeapp #oss cli
2021-03-23 14:00 14:58 0:58 #oss #vispy #meeting
2021-03-23 15:23 15:23 0:00 HIDDEN #oss #vispy #meeting
2021-03-23 15:24 17:13 1:49 #timeapp #oss cli
2021-03-23 17:13 - 0:12 #timeapp #oss more cli
MIT
Additional developer dependencies:
pip install invoke black flake8 pytest
invoke -l
to see available invoke tasksinvoke clean
to remove temporary filesinvoke format
to autoformat the code (using black)invoke lint
to detect linting errors (using flake8)invoke tests
to run tests (using pytest)