A powerful command-line interface for accessing and analyzing Hevy fitness tracking data including workouts, routines, and exercise templates.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install hevycli
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 hevycli 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 Hevy CLI Skill?
The Hevy CLI skill provides a professional-grade interface for fitness enthusiasts and developers to interact with their Hevy workout data. By integrating this capability into Openclaw Skills, users can seamlessly transition from manual mobile tracking to sophisticated terminal-based data analysis. It allows for deep inspection of workout history, detailed set-by-set breakdowns, and comprehensive routine management.
This skill is designed for those who want more control over their fitness metrics. Whether you are building a custom dashboard or simply want a faster way to check your PRs, this tool bridges the gap between the Hevy mobile ecosystem and your local development environment using high-performance Openclaw Skills integration.
Hevy CLI Skill Use Cases
- Reviewing recent workout history and total session counts via the command line.
- Extracting detailed exercise templates and routine structures for planning.
- Exporting fitness data to JSON for custom analytics and progress visualization.
- Checking specific workout details using short IDs for rapid terminal navigation.
- Auditing training frequency and volume trends over time.
How Hevy CLI Skill Works
- The skill interfaces with the hevycli tool to communicate with the Hevy API.
- User requests are translated into specific subcommands for workouts, routines, or exercises.
- The CLI fetches data in either table format for human readability or JSON for machine processing.
- Openclaw Skills logic parses the output to provide insights like volume calculations or frequency patterns.
- Structured data is returned to the user or piped into local files for further use.
Hevy CLI Skill Setup
To get started with this skill, ensure you have the necessary CLI tools and a Hevy Pro subscription.
# Install the Hevy CLI tool
go install github.com/nsampre/hevycli@latest
# Configure your Hevy API key (requires Hevy Pro)
hevycli config set-api-key <your-api-key-uuid>
# Verify the configuration
hevycli config show
Hevy CLI Skill Data Schema & Taxonomy
The skill organizes fitness data into three primary taxonomies to ensure clean data management within Openclaw Skills:
| Category | Data Points | ID Format |
|---|---|---|
| Workouts | Volume, sets, reps, timestamps, distance | UUID or 8-char Short ID |
| Routines | Planned exercises, rest intervals, titles | UUID |
| Exercises | Templates, muscle groups, equipment type | UUID |
All weight data is standardized to kilograms, distances to meters, and durations to seconds.
Hevy CLI Skill Advanced Features
- Multi-format output support allowing seamless switching between table and JSON for automated workflows.
- Intelligent pagination handling for navigating large workout histories with a 10-item page limit.
- Support for 8-character short IDs to simplify data retrieval without copying full UUIDs.
- Debug mode for auditing API requests and troubleshooting connectivity issues.
- Data transformation capabilities to calculate total training volume (weight x reps x sets) directly from raw output.
SKILL.md
Loading
Related Openclaw Skills
Nosi Publishing Skill
A streamlined publishing utility that allows AI agents to push text and markdown to the web, returning a permanent shareable URL.
Travel Agent by BonBook
A full-service AI travel agent that enables flight discovery, booking, and management through simple email commands.
Huangli Almanac Query
A professional-grade interface for AI agents to query the traditional Chinese Almanac (Huangli) for auspicious dates and daily activity guidance.
Ferrari Business Strategy & Market Intelligence
A specialized analytical skill for studying the high-margin business model, Formula 1 heritage, and luxury market dynamics of Ferrari N.V.
Exa Neural Web Search & Research
A neural search engine that enables AI agents to perform semantic web research and extract clean, LLM-ready content without scraping.
DomainKits MCP Server
A powerful domain intelligence toolset for searching newly registered domains and performing reverse nameserver lookups through MCP-compatible AI clients.
Featured*
