wakatime
Query WakaTime coding statistics including time ranges, projects, languages, categories, editors, and machines. Use when the user asks about WakaTime, coding time, project breakdown, language breakdown, or specific daily/weekly/monthly summaries. Works with WakaTime cloud.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/chensoul/wakatime-skillWhat This Skill Does
The WakaTime skill for OpenClaw provides a powerful interface to query your coding activity metrics stored in the WakaTime cloud. Whether you are an individual developer or a team lead, this tool enables you to retrieve precise analytics regarding your time management, language usage, project progression, and editor activity. It acts as an abstraction layer over the official WakaTime API, allowing you to fetch summaries, project breakdowns, and historical data directly from your terminal or within the OpenClaw agent environment without needing to log into the web dashboard.
Installation
To integrate this skill into your environment, use the OpenClaw package manager:
clawhub install openclaw/skills/skills/chensoul/wakatime-skill
Ensure you have your WakaTime API Key ready, as it is required for authentication. Set this as an environment variable in your shell configuration:
export WAKATIME_API_KEY="your-api-key-here"
Use Cases
This skill is perfect for developers who need to generate activity reports, track productivity trends, or monitor time spent on specific feature branches. You can use it to justify billing for freelance projects based on concrete hourly data, identify which programming languages occupy most of your working hours, or compare performance across different code editors and development environments. It is particularly useful for automated daily stand-up reporting.
Example Prompts
- "How much time did I spend coding on the project 'backend-api' over the last 7 days?"
- "Show me a breakdown of my coding activity by language for yesterday, and please adjust for the Asia/Shanghai time zone."
- "Summarize my top projects and used editors for the current month so far."
Tips & Limitations
- Timezone Management: Always use the
--timezoneflag when querying relative ranges like 'yesterday' to ensure the date calculation aligns with your actual working hours rather than UTC. - Read-Only: This skill is strictly for data retrieval; it does not have permission to modify, delete, or inject data into your WakaTime account, making it a safe choice for audit purposes.
- API Rate Limiting: While the skill is efficient, avoid running loop-based queries for every file save. Use the
summariescommand for bulk data extraction to stay within API limits. - Debugging: If you encounter unexpected data or connection drops, append the
-dflag to your command to inspect the raw HTTP headers and JSON payload returned by the WakaTime server.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-chensoul-wakatime-skill": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, external-api