fork of vim-wakatime that repoints to localhost
Go to file
Alan Hamlett f98bb02423 upgrade wakatime-cli to v10.2.1 2018-04-26 08:39:09 -07:00
doc add version 0.1.2 2013-06-25 00:57:15 -07:00
packages/wakatime upgrade wakatime-cli to v10.2.1 2018-04-26 08:39:09 -07:00
plugin move wakatime-cli to parent folder for faster startup on Windows 2018-04-05 09:24:11 -07:00
.gitignore v2.0.5 2014-08-07 08:29:01 -07:00
AUTHORS add Maxim to authors file 2017-07-03 12:03:06 -07:00
HISTORY.rst changes for v7.1.1 2018-04-04 08:13:01 -07:00
LICENSE.txt add authors file and update license 2014-12-21 19:47:29 -06:00 move badges to top of readme 2017-11-22 13:17:16 -08:00

Vim Neovim MacVim gVim


Quantify your coding inside Vim.


  1. With Vundle: echo "Plugin 'wakatime/vim-wakatime'" >> ~/.vimrc && vim +PluginInstall

    Or with Pathogen: cd ~/.vim/bundle && git clone git://

  2. Enter your api key, then press enter.

  3. Use Vim and your coding activity will be displayed on your WakaTime dashboard.

Note: WakaTime depends on Python being installed to work correctly.

Screen Shots

Project Overview



  • :WakaTimeApiKey - change the api key saved in your ~/.wakatime.cfg
  • :WakaTimeDebugEnable - enable debug mode (may slow down Vim so disable when finished debugging)
  • :WakaTimeDebugDisable - disable debug mode
  • :WakaTimeScreenRedrawEnable - enable screen redraw to prevent artifacts (only for Vim < 8.0)
  • :WakaTimeScreenRedrawEnableAuto - redraw screen when plugin takes too long (only for Vim < 8.0)
  • :WakaTimeScreenRedrawDisable - disable screen redraw

Vimrc Settings:

let g:wakatime_PythonBinary = '/usr/bin/python'  " (Default: 'python')

Tells the plugin to use a custom python binary. The default is to use python from your system PATH.

WakaTime plugins also share a common ~/.wakatime.cfg config file. See common configs...


Run :WakaTimeDebugEnable in Vim then run this Terminal command:

tail -f ~/.wakatime.log

Enabling Debug Mode writes Vim Script errors to your Vim Status Bar and tells wakatime-cli to write verbose logs to $WAKATIME_HOME/.wakatime.log.

Debug mode can make it hard to find the real error because of all the extra logging, so also try disabling Debug Mode while tailing ~/.wakatime.log and editing files in Vim. With Debug Mode enabled, the plugin sends data synchronously so disable it when finished debugging with :WakaTimeDebugDisable.

The How to Debug Plugins guide shows how to check when coding activity was last received from Vim use the User Agents API. For more general troubleshooting info, see the wakatime-cli Troubleshooting Section.


  1. Remove Plugin 'wakatime/vim-wakatime' from your .vimrc file.

  2. Run in terminal: rm ~/.wakatime.*.

  3. Run in terminal: vim +PluginClean.