Skip to content


Repository files navigation


This extension allows ActivityWatch, the free and open-source time tracker, to keep track of the projects and programming languages you use in VS Code.

The extension is published on Visual Studio Marketplace and Open VSX.

The source code is available at


Sends following data to ActivityWatch:

  • current project name
  • programming language
  • current file name
  • current Git branch

Currently VS Code extensions don't support getting file/project names for non-editable files, therefore this results in the value "unknown" for those properties. (For instance when opening logo.png this happens)


This extension requires ActivityWatch to be running on your machine.

Install Instructions

To install this extension, search for aw-watcher-vscode in the Extensions sidebar in VS Code, and install the one with ActivityWatch as the publisher name. And that's it, if Activity Watch was running, it should detect this vs-code watcher automatically. Give it some time to have some data to display and it should show in the ActivityWatch Timeline and Activity sections soon.


Reload ActivityWatch

Use this in case VS Code has been started before the AW server.

Extension Settings

This extension adds the following settings:

  • aw-watcher-vscode.maxHeartbeatsPerSec: Controls the maximum number of heartbeats sent per second.

Error reporting

If you run into any errors or have feature requests, please open an issue.

Release Notes


  • Updated publisherId to activitywatch.
  • Added support for VSCodium.
  • Added support for VSCode remote.


Updated aw-client-js, media and npm dependencies.


Updated submodules aw-client-js and media to latest

fixed the extension to work with the latest aw-client:

  • AppEditorActivityHeartbeat --> IAppEditorEvent
  • createBucket --> ensureBucket
  • options object in AWClient constructor
  • timestamp should be a Date not a string


Fixed security vulnerability of an outdated dependency.


Added maxHeartbeatsPerSec configuration.


Refined error handling and heartbeat logic.


Refined error handling and README.


Initial release of aw-watcher-vscode.