flik

flik is a command line client for Proventis Blue Ant. It provides basic time tracking functionalities using dynamic zsh command completion.

Install

Install using pip:

pip install git+https://github.com/rsteube/flik

Add completion plugin using zgen or similar:

zgen load rsteube/flik

Or extend fpath manually:

#~/.zshrc
#
#zstyle ':completion:*' menu select
fpath+=($(flik completion))
autoload -U compinit && compinit

Windows

• install Babun
• update cygwin $HOME/.babun/update.bat (https://github.com/babun/babun/issues/720)
• start Babun and enter:

curl -sSL https://bootstrap.pypa.io/get-pip.py | python
pip install git+https://github.com/rsteube/flik
sed -i '1ifpath+=($(flik completion))\' ~/.zshrc

• restart Babun

First use

• flik login (config stored in ~/.config/flik/config.yml and password using the available keyring)
• flik sync (updates cache in ~/.local/share/flik)

Limiting/blacklisting completion options

In case that you have more projects, tasks or activities assigned than you need for time tracking you can simply remove the corresponding entries from the cache files in ~/.local/share/flik. Note that you have to redo this step after updating the cache using flik sync.

Demo

docker-compose run flik
flik# flik login
flik# flik sync
flik# flik list