Achievements

Achievements is a Visual Studio Code extension that allows you to track your progress in coding, and earn achievements for completing tasks.

Warning

This extension is in beta, may contain bugs and database schema may change in future versions. It is recommended to back up your data before updating.

Features

• Track your progress in coding
• Earn achievements for completing tasks
• View your achievements in the Achievements panel
• View each achievement's description and requirements
• View your progress towards each achievement
• Track your time spent coding
• Filter achievements by category, progress, and name
• View your profile and completion percentage
• Enable or disable notifications
• Enable or disable any type of listeners for privacy

How it works

• The extension activates on onStartupFinished and listens to VS Code and Git events (based on your settings).
• Progress and achievement state are stored locally in a SQLite database powered by sql.js (no server).
• The UI is a VS Code webview (React) opened via Achievements: Show.

Local data & read-only mode

• Data is stored under VS Code's global storage as achievements.sqlite.
• A lock prevents multiple VS Code instances from writing the database at the same time.
  • If another instance is using the DB, the extension runs in read-only mode: listeners are disabled and a status bar item indicates the state.

Extension Commands

Several commands are available to interact with the Achievements extension. You can access these commands through the Command Palette (Ctrl+Shift+P) or by using keybindings.

Command	Description
achievements.enable	Enable or Disable the Achievements extension event tracking (requires a restart)
achievements.settings	Open the Achievements configuration page
achievements.show	Show the Achievements panel

Configuration

The Achievements extension can be configured through the settings. You can access the settings by going to File > Preferences > Settings and searching for "Achievements". You can also access the settings by using the command achievements.settings.

Setting	Description
achievements.enabled	Enable or disable the Achievements extension event tracking
achievements.notifications	Enable or disable notifications for achievements
achievements.logDirectory	Select the directory where the log files will be stored
achievements.logLevel	Select the log level (info, debug, error)
achievements.username	Define your username for the Achievements score display
achievements.listeners.debug	Enable or disable debug listeners
achievements.listeners.git	Enable or disable git listeners
achievements.listeners.extensions	Enable or disable extension listeners
achievements.listeners.files	Enable or disable file listeners
achievements.listeners.tabs	Enable or disable tab listeners
achievements.listeners.tasks	Enable or disable task listeners
achievements.listeners.time	Enable or disable time tracking listeners

Installation

From OpenVSX

1. Download and install Visual Studio Code.
2. Download and install the Achievements Extension VSIX from the OpenVSX registry.
3. Open Visual Studio Code. Go to the Extensions view by clicking on the Extensions icon in the Activity Bar on the side of the window or by pressing Ctrl+Shift+X.
4. Click on the three-dot menu icon in the top-right corner of the Extensions view and select "Install from VSIX...".
5. In the file dialog that appears, navigate to the location where you downloaded the Achievements Extension VSIX file, select it, and click "Open".
6. Visual Studio Code will install the extension. Once the installation is complete, you may need to reload Visual Studio Code for the extension to be activated. You can do this by clicking the "Reload" button that appears in the Extensions view after installation or by closing and reopening Visual Studio Code.
7. Run the command Achievements: Show from the Command Palette (Ctrl+Shift+P) to open the Achievements panel.

From VSIX

1. Download and install Visual Studio Code.
2. Download and install the Achievements Extension VSIX from the GitHub releases page.
3. Open Visual Studio Code. Go to the Extensions view by clicking on the Extensions icon in the Activity Bar on the side of the window or by pressing Ctrl+Shift+X.
4. Click on the three-dot menu icon in the top-right corner of the Extensions view and select "Install from VSIX...".
5. In the file dialog that appears, navigate to the location where you downloaded the Achievements Extension VSIX file, select it, and click "Open".
6. Visual Studio Code will install the extension. Once the installation is complete, you may need to reload Visual Studio Code for the extension to be activated. You can do this by clicking the "Reload" button that appears in the Extensions view after installation or by closing and reopening Visual Studio Code.
7. Run the command Achievements: Show from the Command Palette (Ctrl+Shift+P) to open the Achievements panel.

Development

Prerequisites:

• Node.js 24 (matches CI)
• npm
• VS Code

Quick start:

1. Install dependencies: npm ci
2. Open in VS Code: code .
3. Press F5 (launches the Extension Development Host)

Build system notes:

• The default debug launch runs the VS Code task watch (see .vscode/tasks.json).
  • watch:esbuild bundles the extension + webview.
  • watch:tsc type-checks in watch mode.

Useful scripts:

Command	Description
npm run compile	Clean + build Tailwind + bundle extension/webview (dev build)
npm run build	Production build (typecheck + lint + minified bundle)
npm test	Compile with tsc and run extension tests via @vscode/test-cli
npm run test:coverage	Run tests with NYC coverage output
npm run lint	Lint src/
npm run check-types	Typecheck only (tsc --noEmit)
npm run package	Build and create a .vsix via vsce

Contributing guidelines: see CONTRIBUTING.md.