Wakapi Coding Stats for Openclaw

A professional Python-driven interface for retrieving detailed coding metrics, project lists, and language breakdowns from Wakapi instances.

chensoul
v0.0.3
Mar 19, 2026
0
807
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install wakapi-skill

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install wakapi-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 Coding Stats?

The Wakapi skill is a specialized technical tool designed to bridge the gap between AI coding agents and self-hosted or managed Wakapi instances. By utilizing this integration within the Openclaw Skills ecosystem, developers can programmatically access their coding history, monitor daily progress, and analyze project-specific time allocations. It provides a read-only gateway to your development data, ensuring that your productivity metrics are always available for analysis or reporting without compromising the security of your primary data store.

Wakapi Coding Stats Use Cases

  • Generating automated daily or weekly coding summaries to monitor personal development goals.
  • Retrieving a list of all active projects to help an AI agent understand your current workspace context.
  • Analyzing time spent on specific branches or languages to optimize your technical focus.
  • Verifying the health and connectivity of a self-hosted Wakapi server directly from the terminal.
  • Exporting all-time coding totals for long-term career tracking and portfolio building.

How Wakapi Coding Stats Works

  1. The user provides a WAKAPI_URL and a WAKAPI_API_KEY via environment variables to authorize the connection.
  2. The Openclaw Skills runner executes the Python script, which acts as a lightweight wrapper for the Wakapi and Wakatime-compatible APIs.
  3. The script translates user commands (like projects or stats) into authenticated HTTP Basic requests.
  4. The Wakapi instance processes the request and returns structured data regarding coding duration, projects, and metadata.
  5. The skill outputs the raw JSON response, which can then be interpreted or summarized by an AI agent for the end-user.

Wakapi Coding Stats Setup

To use this integration, ensure you have Python 3 installed. Configure your environment variables in your terminal or agent configuration:

export WAKAPI_URL="https://your-wakapi.example"
export WAKAPI_API_KEY="your_secret_api_key"

Run the basic health check to verify your setup:

python3 scripts/wakapi_query.py health

Access help documentation for specific subcommands:

python3 scripts/wakapi_query.py summaries --help

Wakapi Coding Stats Data Schema & Taxonomy

The skill returns structured JSON data representing your coding activity. The primary data points include:

Data Type Description
Projects An array of active project names registered in your Wakapi account.
Stats Aggregated time metrics, including total seconds and percentage of time per language.
Summaries Detailed daily breakdowns with support for project and branch filters.
Status Bar A concise snapshot of today's coding time and current activity status.
Health A simple boolean check indicating if the Wakapi instance and database are operational.

Wakapi Coding Stats Advanced Features

  • Support for complex date range queries using both semantic aliases (last_7_days) and specific ISO start/end dates.
  • Granular filtering capabilities allowing users to isolate stats by specific projects or git branches.
  • Timezone-aware data retrieval to ensure coding summaries match the user's local time accurately.
  • Adjustable API and socket timeouts to handle large datasets or slower self-hosted server environments within Openclaw Skills.
  • Debug mode for verbose logging of HTTP requests and authentication headers to simplify troubleshooting.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Github Stars: 0
forks: 0

Featured*