skills.rest
TserenTserenov
TserenTserenovCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

setup-wakatime

Configure WakaTime heartbeat hooks for Claude Code and VS Code tracking.

44|125|Updated Feb 10, 2026
Search Tags:#automation#vscode#hooks#claude#time-tracking#wakatime
One-click install
npx skills add https://github.com/TserenTserenov/FMT-exocortex-template --skill setup-wakatime
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup-wakatime
Source: https://github.com/TserenTserenov/FMT-exocortex-template/tree/main/.claude/skills/setup-wakatime
Command: npx skills add https://github.com/TserenTserenov/FMT-exocortex-template --skill setup-wakatime

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents lost work-time context by automating WakaTime time-tracking for Claude Code and VS Code so your AI coding and editor activity is recorded reliably.

Core Features & Use Cases

  • wakatime-cli installation and linking: ensures the CLI is available and callable from a predictable path.
  • Hook integration for Claude Code: installs a wakatime-heartbeat hook and guides adding it to UserPromptSubmit, PostToolUse, and Stop events.
  • Optional desktop focus tracking: guides installing the WakaTime Desktop App for window-focus tracking and macOS accessibility permissions.
  • Use case: a developer wants all Claude Code sessions and VS Code editing time logged to a single WakaTime dashboard for personal productivity analysis.

Quick Start

Install wakatime-cli, add your WakaTime API key to ~/.wakatime.cfg, copy the wakatime-heartbeat hook to ~/.claude/hooks, and add the hook entries to ~/.claude/settings.json to start automatic tracking.

Frequently Asked Questions about setup-wakatime

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up WakaTime tracking for Claude Code?▼

Set up WakaTime tracking for Claude Code by installing wakatime-cli, adding your API key to ~/.wakatime.cfg, placing the wakatime-heartbeat hook in ~/.claude/hooks, and registering hook entries in ~/.claude/settings.json for automatic logging.

Can I track VS Code and Claude Code time in the same WakaTime dashboard?▼

You can track VS Code and Claude Code time in the same WakaTime dashboard by using the WakaTime Desktop App for window-focus tracking alongside heartbeat hooks, recording all editor and AI coding activity reliably.

Do I need the WakaTime Desktop App to track Claude Code sessions?▼

You do not need the WakaTime Desktop App to track Claude Code sessions; it is optional for window-focus tracking. Core session logging relies on wakatime-cli and the heartbeat hook integrated into your settings.

What WakaTime hooks do I need for UserPromptSubmit and PostToolUse events?▼

For UserPromptSubmit and PostToolUse events, you need the wakatime-heartbeat hook placed in ~/.claude/hooks and added as entries to ~/.claude/settings.json to trigger time-tracking during Claude Code workflows.

Why does WakaTime tracking require a config file and CLI installation?▼

WakaTime tracking requires wakatime-cli to send heartbeat API requests and the ~/.wakatime.cfg file to authenticate your API key, ensuring your AI coding and editor activity is recorded reliably to your dashboard.

Related Skills

Explore More Software Engineering Skills→
TbK0ngTbK0ng

trellis-bootstrap

Initialize Trellis AI workflow scaffolding with .trellis structure, memory, and CLI hooks.

Community
Intermediate
sefllessseflless

self-reflect

Consolidate GitHub and coding agent data into a web dashboard.

Community
Intermediate
auge2uauge2u

setup-cdk-editor

Configure VS Code or Cursor environments for Claude Code development.

Community
Advanced
joeleung0122joeleung0122

openai-whisper

Transcribe and translate audio locally using the Whisper CLI.

Community
Intermediate