WakaTime CLI

Command line interface to WakaTime used by all WakaTime text editor plugins.

Go to http://wakatime.com/editors to install the plugin for your text editor or IDE.

Usage

Normally you don't need to use wakatime-cli directly unless you're building a new WakaTime plugin. If you're building a plugin using the WakaTime API, follow the Creating a Plugin guide.

WakaTime plugins and wakatime-cli share a common INI config file:

$WAKATIME_HOME/.wakatime.cfg

Without an explicit config path or WAKATIME_HOME, wakatime-cli also supports an XDG config fallback when ~/.wakatime.cfg does not exist.

IDE plugins log to the IDE’s console, and wakatime-cli writes JSONL logs to:

$WAKATIME_HOME/.wakatime/wakatime.log

Set debug = true in your config file to enable verbose logs.

See Usage or the WakaTime FAQ for more details.

Contributing

Pull requests and issues are welcome! See Contributing for more details.

Troubleshooting

See Troubleshooting for more details.

Many thanks to all contributors!

Made with :heart: by the WakaTime Team.