wakatime-mode is an automatic time tracking extension for Emacs using WakaTime.

1. Install wakatime-mode for Emacs using MELPA (Doom users see these instructions instead).

2. Download wakatime-cli to ~/.wakatime/ or somewhere in your $PATH. (Or brew install wakatime-cli on Mac)

3. Add (global-wakatime-mode) to your init.el file, then restart Emacs.

4. You will see a prompt asking for the path to wakatime-cli. Run which wakatime-cli and enter that path into the emacs prompt, then press enter.

5. Enter your api key in your init.el or ~/.wakatime.cfg file (config file format).

6. Use Emacs with wakatime-mode turned on and your time will be tracked for you automatically.

7. Visit http://wakatime.com to see your logged time.

See Installing WakaTime with Spacemacs.

Enable WakaTime for the current buffer by invoking M-x wakatime-mode. If you wish to activate it globally, run M-x global-wakatime-mode.

Set variable wakatime-api-key to your API key.

Point wakatime-cli-path to the absolute path of wakatime-cli.

To be sure heartbeats are getting sent, turn on debug mode by adding this line to your ~/.wakatime.cfg file:

debug = true

Then run tail -f ~/.wakatime.log and make sure you see a 201 response code from the WakaTime API.