WakaTime for Emacs Emacs

The open source plugin for productivity metrics, goals, leaderboards, and automatic time tracking.


  1. Follow the instructions under "installing" on MELPA's getting started page. (Doom users see these instructions instead)

  2. Restart Emacs, to make it reloads your init file.

  3. Run M-x package-list-packages.

  4. Find the wakatime-mode package in the list of packages, and move the cursor there.

  5. Press i to mark the package for installation.

  6. Press x to execute the commands and install the marked wakatime-mode package.

  7. Enter your API Key, then press Enter.

  8. Install wakatime cli with sudo pip install wakatime or by downloading the GitHub repo.

  9. Find the path to wakatime cli with which wakatime or use the absolute path to wakatime/cli.py inside the GitHub repo you downloaded.

  10. Enter the path to wakatime cli, then press Enter.

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

  12. Use Emacs with wakatime-mode turned on and your stats will automatically show on your https://wakatime.com/dashboard.

WakaTime plugins collect file path and project names from your IDE. Learn more about data collected and privacy.