Setup wakatime

Skill TserenTserenov/FMT-exocortex-template/.claude/skills/setup-wakatime

Exocortex template: fork & deploy your AI-powered personal knowledge system with Claude Code

Install

npx -y skills add TserenTserenov/FMT-exocortex-template --skill setup-wakatime

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Set up WakaTime time-tracking for Claude Code and VS Code.

SKILL.md

4.0 KB, ~1.1k tokens by cl100k_base, as published. Nobody here has run it

Setup WakaTime Time Tracking

Автоматическая настройка WakaTime для отслеживания рабочего времени.

Что устанавливается

wakatime-cli — CLI для отправки heartbeat'ов
Хук Claude Code — автоматический трекинг при работе с Claude (категория "AI Coding")
WakaTime Desktop App (опционально) — трекинг фокуса окна (чтение, браузер)

Инструкция для Claude

Выполни шаги последовательно. На каждом шаге проверяй, не сделано ли уже.

Шаг 1: wakatime-cli

# Проверить наличие
~/.wakatime/wakatime-cli --version 2>/dev/null || wakatime-cli --version 2>/dev/null

Если не установлен:

brew install wakatime-cli
mkdir -p ~/.wakatime
ln -sf $(which wakatime-cli) ~/.wakatime/wakatime-cli

Шаг 2: API Key

cat ~/.wakatime.cfg 2>/dev/null

Если файл не существует или нет api_key:

Скажи пользователю: «Нужен WakaTime API-ключ. Получи его на https://wakatime.com/settings/api-key (нужна регистрация). Вставь ключ сюда.»
Дождись ответа
Запиши:

# ~/.wakatime.cfg
[settings]
api_key = <ключ от пользователя>

Шаг 3: Хук-скрипт

Скопируй хук-скрипт из шаблона в глобальную директорию:

mkdir -p ~/.claude/hooks
cp .claude/hooks/wakatime-heartbeat.sh ~/.claude/hooks/wakatime-heartbeat.sh
chmod +x ~/.claude/hooks/wakatime-heartbeat.sh

Шаг 4: Настройка хуков в settings.json

Прочитай ~/.claude/settings.json. Добавь в секцию hooks (не затирая существующие хуки):

UserPromptSubmit — добавь hook group:

{"hooks": [{"type": "command", "command": "~/.claude/hooks/wakatime-heartbeat.sh"}]}

PostToolUse — добавь:

{"hooks": [{"type": "command", "command": "~/.claude/hooks/wakatime-heartbeat.sh", "async": true}]}

Stop — добавь:

{"hooks": [{"type": "command", "command": "~/.claude/hooks/wakatime-heartbeat.sh", "async": true}]}

Шаг 5: WakaTime Desktop App (спроси пользователя)

Спроси: «Установить WakaTime Desktop App? Он трекает время фокуса окна (когда читаешь ответы, работаешь в браузере). Требует Accessibility-разрешение в macOS.»

Если да:

brew install --cask wakatime
open -a WakaTime

Скажи: «Разреши Accessibility доступ в System Settings → Privacy & Security → Accessibility.»

Шаг 6: Тест

echo '{"cwd": "'$(pwd)'", "hook_event_name": "UserPromptSubmit", "prompt": "test"}' | ~/.claude/hooks/wakatime-heartbeat.sh
sleep 3
~/.wakatime/wakatime-cli --today

Покажи результат пользователю. Скажи: «Хуки подхватятся при следующем запуске Claude Code (хуки загружаются при старте сессии).»

Шаг 7: Итог

Покажи таблицу:

Компонент	Статус
wakatime-cli	✅/❌
API key	✅/❌
Хук-скрипт	✅/❌
Хуки в settings.json	✅/❌
Desktop App	✅/❌/пропущен
Тест heartbeat	✅/❌

Скажи: «Дашборд: https://wakatime.com/dashboard. Данные появятся через 5-15 минут.»