wakatime/wakatime-cli

Command line interface used by all WakaTime text editor plugins

451

stars

1,804

commits

Go

primary language

Aug 31, 2026

updated

wakatime.com/plugins
analytics
metrics
productivity
quantified-self
time-tracker
Browse cluster: Rust TUI and Terminal Applications

README

WakaTime CLI

Tests Coverage Downloads wakatime

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

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

$WAKATIME_HOME/.wakatime/wakatime.log

With the ~/.wakatime.cfg config debug = true enabling 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.

Contributors

alanhamlett

701 commits

gandarez

680 commits

dron22

403 commits

1chooo

4 commits

wakatime/wakatime-cli

Command line interface used by all WakaTime text editor plugins

451

stars

1,804

commits

Go

primary language

Aug 31, 2026

updated

wakatime.com/plugins
analytics
metrics
productivity
quantified-self
time-tracker
Browse cluster: Rust TUI and Terminal Applications

README

WakaTime CLI

Tests Coverage Downloads wakatime

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

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

$WAKATIME_HOME/.wakatime/wakatime.log

With the ~/.wakatime.cfg config debug = true enabling 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.

Contributors

alanhamlett

701 commits

gandarez

680 commits

dron22

403 commits

1chooo

4 commits

Languages

Go

99.5%