WakaTime for Nova

Metrics, insights, and time tracking automatically generated from your programming activity.


  1. Navigate to the Extension Library inside Nova (Shift + ⌘ + 2).

  2. Search for wakatime, hit enter, then click Install.

  3. Enter your api key, then click Save.

    (If you’re not prompted, navigate to Extensions → WakaTime → API Key or ⌘ + Shift + P then type apikey.)

  4. Use Nova and your coding activity will be displayed on your WakaTime dashboard.


Visit to see your coding activity.


Extension settings are stored in the INI file at $HOME/.wakatime.cfg.

More information can be found from wakatime core.


First, turn on debug mode:

  1. Press ⌘ + Shift + P
  2. Type debug mode, and pressEnter`.
  3. Select enable, then press Enter.

Next, open your Extensions Console window (Extensions → Show Extension Console) to view the plugin's logs and errors.

Errors outside the scope of this plugin go to $HOME/.wakatime.log from wakatime-cli.

The How to Debug Plugins guide shows how to check when coding activity was last received from your editor using the Plugins Status Page.

For more general troubleshooting info, see the wakatime-cli Troubleshooting Section.


Version 2.2.1 (Released 2022-11-27)

Support api key with waka prefix.

Version 2.2.0 (Released 2022-04-05)

Support Mac M1 ARM architecture. #15

Version 2.1.0 (Released 2022-04-02)

Use Go wakatime-cli. #13

Version 2.0.3 (Released 2021-04-14)

Bugfix catch and log error when attaching stdout/err listener to wakatime-cli child process. #10

Version 2.0.2 (Released 2021-04-11)

Bugfix error when trying to enter API Key after initial config. #7

Version 2.0.1 (Released 2021-01-14)

Bugfix error when reading config file that doesn't yet exist on filesystem. #5

Version 2.0.0 (Released 2020-11-24)

Support for remote files. #2

Version 1.0.3 (Released 2020-09-17)

Update extension icon with correct corner radius.

Version 1.0.2 (Released 2020-09-17)

Update extension icon with app icon image.

Version 1.0.1 (Released 2020-09-17)

Update extension icon for dark backgrounds.

Version 1.0.0 (Released 2020-09-17)

Initial release