Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


A terminal based client for Clockify time tracker

GitHub release GitHub license AUR version goclockify


Binary installation

Download a compatible binary for your system and rename it to goclockify. Then move goclockify into your $PATH somewhere (e.g. /usr/local/bin).

$ mv goclockify /usr/local/bin

Also, from this page, you can download .deb and .rpm packages and install them using your package manager:

# dpkg
$ sudo dpkg -i /path/to/goclockify.deb
$ sudo apt-get install -f

# apt
$ sudo apt install /path/to/goclockify.deb

# rpm
$ sudo rpm –i /path/to/goclockify.rpm

# yum
$ sudo yum localinstall /path/to/goclockify.rpm

# dnf
$ sudo dnf localinstall /path/to/goclockify.rpm

# ...


goclockify is available on AUR:

Install it using yay

$ yay -S goclockify

or clone the git repository

$ clone
$ cd goclockify
$ makepkg -sirc

Via Go

You can also get goclockify via Go:

Note: Go 1.14+ required.

$ go get -u
$ cd $GOPATH/src/
$ go install .

Using Snap

goclockify is also available on Snap:

$ snap install goclockify


  1. Create a Clockify API Key;

  2. Running goclockify for the first time, will create a default config file at ~/.config/abgeo/goclockify/config;
    Note: The path to the config file will be different if you install goclockify using Snap. Check the error message (Config file: ...).

    $ goclockify
  3. Update the config file and set your clockify_api_token:

        "clockify_api_token": "your_api_key"


When everything is set up correctly you can run goclockify with the following command:

$ goclockify

Default Key Mapping

Note: You can change them in your config file.

Key Action
a Workplace navigation Up
z Workplace navigation Down
k, <Up> and <MouseWheelUp> Time Entries navigation Up
j, <Down> and <MouseWheelDown> Time Entries navigation Down
g, <Home> Time Entries jump to Top
G, <End> Time Entries jump to Down
<Enter> Display time entry details
<Delete> Delete selected Time Entry
Ctrl + n Create new time entry
Ctrl + e Edit the selected time entry
<F1>, ? Show help message
<Escape> close the 2nd level window, go to the dashboard


Please see CHANGELOG for details.


Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.



Copyright © 2020 Temuri Takalandze.
Released under the MIT license.