timetagger_cli

Track your time from the command-line

Introduction

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.

Installation

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.

Docs

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.

Example

$ 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

License

MIT

Developers

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)

kwillno / timetagger_cli