thepont / zsh-wakatime

ZSH plugin for wakatime

ZSH plugin for wakatime

Automatic time tracking for commands in ZSH using wakatime.

Installation

It depends on wakatime CLI 6.0 or higher. Make sure you have configured wakatime API key in your ~/.wakatime.cfg file. If you use wakatime in other editors, this file may be already there.

1. pip install wakatime to install wakatime CLI, with 6.0 or higher. Check wakatime CLI version by wakatime --version. See more here for wakatime CLI.

2. For oh-my-zsh user:

• cd ~/.oh-my-zsh/custom/plugins && git clone https://github.com/wbingli/zsh-wakatime.git

• Edit your .zshrc file and add zsh-wakatime to oh-my-zsh plugins

3. For Antigen user:

• antigen bundle wbingli/zsh-wakatime

4. Open a new terminal and type commands

5. Visit https://wakatime.com/project/Terminal

Project Detection

By default all actions logged by the ZSH plugin for wakatime are associated with the Terminal project, if you would like the plugin to attribute the project based on either git repository or the last accessed project then set ZSH_WAKATIME_PROJECT_DETECTION to true in your environment.

To enable:

1. Edit your .zshrc
2. Add the line export ZSH_WAKATIME_PROJECT_DETECTION=true at the top of the file.

Screenshot

Configuration

WakaTime plugins share a common config file .wakatime.cfg located in your user home directory with these options available.