← Back to Skills Marketplace
cosformula

Wakapi Sync

by cosformula · GitHub ↗ · v0.2.1
cross-platform ⚠ suspicious
773
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install wakapi-sync-skill
Description
Daily Wakapi (WakaTime-compatible) summary → local CSV files. Fetch today stats and append/update CSVs for totals, top projects, and top languages.
Usage Guidance
This skill appears to do what it says. Before installing, ensure WAKAPI_URL points to a trusted Wakapi server you control and keep WAKAPI_API_KEY secret. Provide an OUT_DIR you expect the skill to write to (it creates directories/files there). Confirm your agent environment has Node.js 18+ and that you are comfortable with the agent being able to invoke the script (autonomous invocation is allowed by default). If you want extra caution, run the script manually once in a sandboxed environment to verify behavior and outputs before enabling automated runs.
Capability Analysis
Type: OpenClaw Skill Name: wakapi-sync-skill Version: 0.2.1 The skill fetches Wakapi statistics and writes them to local CSV files. It is classified as suspicious due to a significant path traversal vulnerability in `scripts/wakapi-daily-summary.mjs`. The `WAKAPI_OUT_DIR` environment variable, which dictates the output directory for CSV files, is used directly with `path.join` without sufficient sanitization. This could allow an attacker to write files to arbitrary locations on the file system (e.g., `../../etc/malicious.csv`) if they can control this environment variable, potentially leading to unauthorized file modification or creation.
Capability Assessment
Purpose & Capability
Name/description, declared env vars, and bundled script all align: the script queries Wakapi endpoints and produces CSVs in the configured output directory. Nothing requested (binaries, extra envs, or config paths) is unrelated to the stated purpose.
Instruction Scope
SKILL.md instructs running the included Node script and documents the exact env vars used. The script only calls the Wakapi endpoints, processes JSON, and reads/writes CSVs under WAKAPI_OUT_DIR—no unexpected file reads, shell evals, or external endpoints are present.
Install Mechanism
This is an instruction-only skill with a bundled Node script; there is no install spec or external downloads. It requires Node.js 18+ in the runtime, which is reasonable for an .mjs script.
Credentials
Only three required env vars are declared and used: WAKAPI_URL, WAKAPI_API_KEY, and WAKAPI_OUT_DIR (plus optional TOP_N vars). These directly map to the script's behavior. The primaryEnv is set to WAKAPI_OUT_DIR (a non-secret path); the secret API key is requested and justified by the API calls.
Persistence & Privilege
always is false and the skill does not modify other skills or system-wide settings. It only writes CSV files under the specified output directory, which is expected for its function.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install wakapi-sync-skill
  3. After installation, invoke the skill by name or use /wakapi-sync-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.1
Release v0.2.1
v0.1.1
Release v0.1.1
v0.1.0
wakapi-sync-skill v0.1.0 - Initial release. - Fetches today's usage stats from Wakapi (WakaTime-compatible server). - Outputs or updates three CSV files: daily totals, top projects, and top languages. - Highly configurable via environment variables for API URL, key, output directory, and row limits. - Supports Node.js 18+ environments.
Metadata
Slug wakapi-sync-skill
Version 0.2.1
License
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Wakapi Sync?

Daily Wakapi (WakaTime-compatible) summary → local CSV files. Fetch today stats and append/update CSVs for totals, top projects, and top languages. It is an AI Agent Skill for Claude Code / OpenClaw, with 773 downloads so far.

How do I install Wakapi Sync?

Run "/install wakapi-sync-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Wakapi Sync free?

Yes, Wakapi Sync is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Wakapi Sync support?

Wakapi Sync is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Wakapi Sync?

It is built and maintained by cosformula (@cosformula); the current version is v0.2.1.

💬 Comments