A synchronization tool that fetches daily WakaTime-compatible coding statistics from Wakapi and saves them as structured local CSV files.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install wakapi-sync-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install wakapi-sync-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is wakapi-sync?
The wakapi-sync utility is designed for developers who want to maintain a local, portable history of their coding productivity. By leveraging Openclaw Skills, this tool interfaces with any Wakapi-compatible instance to retrieve daily summaries including total active time, project-specific metrics, and language usage.
Instead of relying solely on a web interface, this skill converts your technical activity into structured data, allowing for private data ownership, custom dashboarding, and long-term trend analysis. It acts as a bridge between your automated time-tracking server and your local filesystem, ensuring your productivity data is always accessible in a standard format.
wakapi-sync Use Cases
- Creating a self-hosted backup of your coding history for data sovereignty.
- Generating local datasets for custom data visualization and productivity dashboards.
- Tracking daily coding progress across multiple projects and languages in a version-controlled repository.
- Automating the collection of time-tracking metrics without manual exports.
How wakapi-sync Works
- The skill initiates a connection to the specified Wakapi instance using your unique API key via Basic Authentication.
- It fetches the summary statistics for the current date, retrieving granular details about projects and languages.
- The raw JSON response is processed and mapped into three specific categories: totals, top projects, and top languages.
- The logic checks for the existence of local CSV files and either appends new data or updates existing rows for the current day to ensure data accuracy.
- The finalized data is saved to the local directory defined in your environment configuration.
wakapi-sync Setup
To deploy this skill within your environment, ensure you are running Node.js 18 or higher. Configure the required environment variables to point to your instance:
# Required Configuration
export WAKAPI_URL="https://your-wakapi-instance.com"
export WAKAPI_API_KEY="your_secret_api_key"
export WAKAPI_OUT_DIR="/path/to/your/storage"
# Optional: Customize the amount of data captured
export WAKAPI_TOP_N_PROJECTS=10
export WAKAPI_TOP_N_LANGUAGES=10
Execute the sync process with the following command:
node scripts/wakapi-daily-summary.mjs
wakapi-sync Data Schema & Taxonomy
The skill organizes data into three distinct CSV files with the following structures:
daily-total.csv
date: The log date (YYYY-MM-DD).total_seconds/total_hours: Cumulative time spent coding.projects_count/languages_count: Variety of work performed.
daily-top-projects.csv
rank: Order by time spent.project: Name of the specific project.seconds/hours/percent: Duration and relative weight of the project.
daily-top-languages.csv
language: The programming language detected.rank/seconds/hours/percent: Usage metrics per language.
wakapi-sync Advanced Features
- Support for configurable Top N filters to limit the noise in your project and language CSV logs.
- Idempotent updates that allow you to run the skill multiple times a day without duplicating entries.
- Native compatibility with the Openclaw Skills framework for automated, scheduled execution.
- Minimal footprint utilizing Node.js for high performance and low resource usage.
SKILL.md
Loading
Related Openclaw Skills
GitHub Star Manager
An AI-enhanced management tool for organizing, categorizing, and pruning GitHub stars using the GitHub CLI and GraphQL.
Douban Sync
A robust tool to export and incrementally sync your Douban library to local CSV files for personal archiving or Obsidian integration.
Taildrop
A command-line utility for retrieving files from the Tailscale Taildrop inbox to local Linux storage.
Phone Voice Integration
A comprehensive integration that turns your Openclaw instance into a voice-activated phone assistant using ElevenLabs and Twilio.
Irish Takeaway Finder
A smart automation tool for locating Irish takeaways and extracting real-time menu data from popular delivery platforms.
Arcane Docker Management Skill
A comprehensive Docker orchestration skill for managing containers, stacks, and system resources through the Arcane API.
METADATA
Featured*
