claude-code-wakatime 1.0.0

package/LICENSE

@@ -0,0 +1,30 @@
+BSD 3-Clause License
+
+Copyright (c) 2025 WakaTime, LLC.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer
+  in the documentation and/or other materials provided
+  with the distribution.
+
+* Neither the names of WakaTime, nor the names of its
+  contributors may be used to endorse or promote products derived
+  from this software without specific prior written permission.
+
+THIS SOFTWARE AND DOCUMENTATION IS PROVIDED BY THE COPYRIGHT HOLDERS AND
+CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
+NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER
+OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,17 @@
+# WakaTime for Claude Code
+
+[WakaTime](https://wakatime.com/) is an open source VS Code plugin for metrics, insights, and time tracking automatically generated from your programming activity.
+
+## Installation
+
+1. `npm install -g claude-code-wakatime`
+
+2. Install WakaTime for [VS Code](https://wakatime.com/vs-code) to setup your `~/.wakatime/` folder and api key.
+
+4. Use Claude Code and your AI coding activity will be displayed on your [WakaTime dashboard](https://wakatime.com)
+
+## Usage
+
+Visit [https://wakatime.com](https://wakatime.com) to see your coding activity.
+
+![Project Overview](https://wakatime.com/static/img/ScreenShots/Screen-Shot-2016-03-21.png)

package/dist/index.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const child_process_1 = require("child_process");
+const STATE_FILE = path_1.default.join(os_1.default.homedir(), '.wakatime', 'claude-code.json');
+const WAKATIME_CLI = path_1.default.join(os_1.default.homedir(), '.wakatime', 'wakatime-cli');
+function timestamp() {
+    return Date.now() / 1000;
+}
+function shouldSendHeartbeat() {
+    try {
+        const last = JSON.parse(fs_1.default.readFileSync(STATE_FILE, 'utf-8')).lastHeartbeatAt ?? timestamp();
+        return timestamp() - last >= 60;
+    }
+    catch {
+        return true;
+    }
+}
+function updateState() {
+    fs_1.default.mkdirSync(path_1.default.dirname(STATE_FILE), { recursive: true });
+    fs_1.default.writeFileSync(STATE_FILE, JSON.stringify({ lastHeartbeatAt: timestamp() }, null, 2));
+}
+function sendHeartbeat() {
+    try {
+        (0, child_process_1.execFileSync)(WAKATIME_CLI, ['--entity', 'claude code', '--entity-type', 'app', '--category', 'ai coding']);
+    }
+    catch (err) {
+        console.error('Failed to send WakaTime heartbeat:', err.message);
+    }
+}
+if (shouldSendHeartbeat()) {
+    sendHeartbeat();
+    updateState();
+}

package/dist/install-hooks.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const CLAUDE_SETTINGS = path_1.default.join(os_1.default.homedir(), '.claude', 'settings.json');
+const HOOK_EVENTS = ['PreToolUse', 'PostToolUse', 'UserPromptSubmit', 'SessionStart'];
+function loadSettings() {
+    if (!fs_1.default.existsSync(CLAUDE_SETTINGS)) {
+        return {};
+    }
+    return JSON.parse(fs_1.default.readFileSync(CLAUDE_SETTINGS, 'utf-8'));
+}
+function saveSettings(settings) {
+    fs_1.default.mkdirSync(path_1.default.dirname(CLAUDE_SETTINGS), { recursive: true });
+    fs_1.default.writeFileSync(CLAUDE_SETTINGS, JSON.stringify(settings, null, 2));
+}
+function installHooks() {
+    const settings = loadSettings();
+    settings.hooks = settings.hooks || {};
+    const hook = {
+        matcher: '*',
+        hooks: [
+            {
+                type: 'command',
+                command: 'claude-code-wakatime',
+            },
+        ],
+    };
+    let hookAlreadyExists = true;
+    for (const event of HOOK_EVENTS) {
+        settings.hooks[event] = settings.hooks[event] || [];
+        // Check if a hook with the same command already exists
+        const existingHook = settings.hooks[event].find((existingHook) => existingHook.hooks &&
+            Array.isArray(existingHook.hooks) &&
+            existingHook.hooks.some((hookItem) => hookItem.command === 'claude-code-wakatime'));
+        if (!existingHook) {
+            settings.hooks[event].push(hook);
+            hookAlreadyExists = false;
+        }
+    }
+    if (hookAlreadyExists) {
+        console.log(`WakaTime hooks already installed in Claude ${CLAUDE_SETTINGS}`);
+    }
+    else {
+        saveSettings(settings);
+        console.log(`WakaTime hooks installed in Claude ${CLAUDE_SETTINGS}`);
+    }
+}
+installHooks();

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "claude-code-wakatime",
+  "version": "1.0.0",
+  "description": "WakaTime plugin for Claude Code",
+  "bin": {
+    "claude-code-wakatime": "dist/index.js"
+  },
+  "scripts": {
+    "postinstall": "node dist/install-hooks.js",
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "release:major": "npm version major && npm publish && git push && git push --tags",
+    "release:minor": "npm version minor && npm publish && git push && git push --tags",
+    "release:patch": "npm version patch && npm publish && git push && git push --tags"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wakatime/claude-code-wakatime.git"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "time-tracking",
+    "ai"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "@types/eslint": "^8.44.7",
+    "@types/node": "^20.9.2",
+    "@types/pidusage": "^2.0.5",
+    "@types/prettier": "^2.7.3",
+    "@typescript-eslint/eslint-plugin": "6.11.0",
+    "@typescript-eslint/parser": "6.11.0",
+    "eslint": "^8.54.0",
+    "prettier": "^3.1.0",
+    "typescript": "^5.2.2"
+  },
+  "author": "WakaTime",
+  "license": "BSD-3-Clause",
+  "bugs": {
+    "url": "https://github.com/wakatime/claude-code-wakatime/issues"
+  },
+  "homepage": "https://github.com/wakatime/claude-code-wakatime#readme"
+}

package/prettier.config.cjs

@@ -0,0 +1,8 @@
+/** @type {import("prettier").Config} */
+const config = {
+  singleQuote: true,
+  trailingComma: 'all',
+  printWidth: 140,
+};
+
+module.exports = config;

package/src/index.ts

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { execFileSync } from 'child_process';
+
+const STATE_FILE = path.join(os.homedir(), '.wakatime', 'claude-code.json');
+const WAKATIME_CLI = path.join(os.homedir(), '.wakatime', 'wakatime-cli');
+
+type State = {
+  lastHeartbeatAt?: number;
+};
+
+function timestamp() {
+  return Date.now() / 1000;
+}
+
+function shouldSendHeartbeat(): boolean {
+  try {
+    const last = (JSON.parse(fs.readFileSync(STATE_FILE, 'utf-8')) as State).lastHeartbeatAt ?? timestamp();
+    return timestamp() - last >= 60;
+  } catch {
+    return true;
+  }
+}
+
+function updateState() {
+  fs.mkdirSync(path.dirname(STATE_FILE), { recursive: true });
+  fs.writeFileSync(STATE_FILE, JSON.stringify({ lastHeartbeatAt: timestamp() } as State, null, 2));
+}
+
+function sendHeartbeat() {
+  try {
+    execFileSync(WAKATIME_CLI, ['--entity', 'claude code', '--entity-type', 'app', '--category', 'ai coding']);
+  } catch (err: any) {
+    console.error('Failed to send WakaTime heartbeat:', err.message);
+  }
+}
+
+if (shouldSendHeartbeat()) {
+  sendHeartbeat();
+  updateState();
+}

package/src/install-hooks.ts

@@ -0,0 +1,63 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+const CLAUDE_SETTINGS = path.join(os.homedir(), '.claude', 'settings.json');
+const HOOK_EVENTS = ['PreToolUse', 'PostToolUse', 'UserPromptSubmit', 'SessionStart'];
+
+function loadSettings(): any {
+  if (!fs.existsSync(CLAUDE_SETTINGS)) {
+    return {};
+  }
+
+  return JSON.parse(fs.readFileSync(CLAUDE_SETTINGS, 'utf-8'));
+}
+
+function saveSettings(settings: any): void {
+  fs.mkdirSync(path.dirname(CLAUDE_SETTINGS), { recursive: true });
+  fs.writeFileSync(CLAUDE_SETTINGS, JSON.stringify(settings, null, 2));
+}
+
+function installHooks(): void {
+  const settings = loadSettings();
+  settings.hooks = settings.hooks || {};
+
+  const hook = {
+    matcher: '*',
+    hooks: [
+      {
+        type: 'command',
+        command: 'claude-code-wakatime',
+      },
+    ],
+  };
+
+  let hookAlreadyExists = true;
+  
+  for (const event of HOOK_EVENTS) {
+    settings.hooks[event] = settings.hooks[event] || [];
+    
+    // Check if a hook with the same command already exists
+    const existingHook = settings.hooks[event].find((existingHook: any) =>
+      existingHook.hooks && 
+      Array.isArray(existingHook.hooks) &&
+      existingHook.hooks.some((hookItem: any) => 
+        hookItem.command === 'claude-code-wakatime'
+      )
+    );
+    
+    if (!existingHook) {
+      settings.hooks[event].push(hook);
+      hookAlreadyExists = false;
+    }
+  }
+
+  if (hookAlreadyExists) {
+    console.log(`WakaTime hooks already installed in Claude ${CLAUDE_SETTINGS}`);
+  } else {
+    saveSettings(settings);
+    console.log(`WakaTime hooks installed in Claude ${CLAUDE_SETTINGS}`);
+  }
+}
+
+installHooks();

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "outDir": "dist",
+    "strict": true,
+    "esModuleInterop": true
+  },
+  "include": ["src"]
+}