Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



32 Commits

Repository files navigation



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, 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 timetaggercommand.

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 [-h] [--version] {setup,app,status,show,start,stop,add,resume} ...

Track your time from the command-line, a CLI for

positional arguments:
    setup               Edit the API URL and token by opening the config file in your default editor.
    app                 Open the TimeTagger app in your default browser.
    status              Get an overview of today and this week. The exact content may change.
    show                List records of the requested time frame.
    start               Start timer with the given description. Use '#' to create tags.
    stop                Stop any running timers.
    add                 Add already finished task.
    resume              Start a timer with the same description as the selected record.

  -h, --help            show this help message and exit
  --version             show program's version number and exit


$ 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:24             17:13      1:49  #timeapp #oss cli
 2021-03-23 17:13                 -      0:12  #timeapp #oss more cli




Additional developer dependencies:

pip install invoke black flake8 pytest
  • invoke -l to see available invoke tasks
  • invoke clean to remove temporary files
  • invoke format to autoformat the code (using black)
  • invoke lint to detect linting errors (using flake8)
  • invoke tests to run tests (using pytest)