A dead-simple language server around wakatime-cli to send code tracking heartbeats

I made this language server wrapper implementation around wakatime-cli because I wanted support for WakaTime in Helix. That said, it's should be compatible with every LSP implementation.

wakatime-ls listens to open, change, save and close file events. It then reflects this activity by sending heartbeats via the wakatime-cli.

# from crates.io
cargo install wakatime-ls
# or from source
cargo install --git https://github.com/mrnossiom/wakatime-ls

You will also need wakatime-cli in your $PATH for setups others than Nix, which already bundles it. You can download wakatime-cli:

• with your preferred package manager (see wakatime-cli repology)
• from the wakatime-cli releases page

Currently wakatime-ls is not configurable cause it's more of a simple wakatime-cli wrapper which itself is configurable with $WAKATIME_HOME/.wakatime.cfg (see docs). ($WAKATIME_HOME defaults to $HOME)

It might be already filled if you've used another WakaTime plugin in the past.

Required configuration is to set your WakaTime api key in $WAKATIME_HOME/.wakatime.cfg, like so:

[settings]
api_key=waka_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

You need to add wakatime-ls to your languages.toml configuration (see docs). Though, it's not currently possible to add global language servers, you can add wakatime for your most significant languages.

Helix does not merge values, you also need to specify the original language servers defined for the language. You can find them in the default languages.toml

Adding global language servers is blocking on Helix's new config system.

e.g.

[language-server.wakatime]
command = "wakatime-ls"

[[language]]
name = "markdown"
language-servers = ["marksman", "wakatime"]

[[language]]
name = "rust"
language-servers = ["rust-analyzer", "wakatime"]

[[language]]
name = "nix"
language-servers = ["nil", "wakatime"]

# add as many entries as the number of the languages you use

wakatime-ls is a language server, it's easy to quickly integrate into any editor that support the language server protocol.

Feel free to make a PR for your own favorite editor.

Work is licensed under CECILL-2.1, a French OSS license that allows modification and distribution of the software while requiring the same license for derived works.