A command-line interface skill that enables AI agents to view, create, and manage Hevy fitness app data including workouts, routines, and folders.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install hevy-workouts
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 hevy-workouts 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 is a specialized tool designed to bridge the gap between AI agents and personal fitness management. By leveraging the Hevy API through a command-line interface, this skill allows users to interact with their fitness data using structured commands. Whether you are building a custom fitness dashboard or automating workout logs, this integration within Openclaw Skills provides a developer-friendly way to handle exercise templates, routine organization, and historical progress data.
This skill is particularly valuable for users who want to move beyond manual mobile app entries and instead use automated workflows or agentic interactions to maintain their training logs. By utilizing Openclaw Skills, developers can ensure their AI agents have direct access to validated fitness schemas and robust data operations.
Hevy CLI Skill Use Cases
- Programmatically logging new workout sessions with specific set types and weights.
- Retrieving historical data for specific exercises to analyze strength progression.
- Automating the creation and organization of routine folders for periodized training programs.
- Batch updating existing routines or exercise templates via JSON payloads.
How Hevy CLI Skill Works
- The skill authenticates with the Hevy platform using a securely configured HEVY_API_KEY environment variable.
- Commands are issued through the hevy CLI to fetch data, such as workout lists or routine templates.
- For data entry, the skill processes JSON structures or local file references to define complex exercise sets (warmups, failure sets, dropsets).
- The skill returns either human-readable summaries or raw JSON output for seamless integration into other Openclaw Skills workflows.
Hevy CLI Skill Setup
To get started with the Hevy CLI, ensure you have your API key ready and follow these steps:
- Set your API key as an environment variable:
export HEVY_API_KEY='your_hevy_api_key_here'
- Verify the connection by counting your workouts:
hevy workouts count
- List your recent activities to ensure data is flowing correctly:
hevy workouts list --page-size 5
Hevy CLI Skill Data Schema & Taxonomy
The skill manages data across four primary domains, utilizing specific IDs and metadata for precise tracking:
| Entity | Key Data Points |
|---|---|
| Workouts | ID, Title, Start/End Time, Exercises Array |
| Exercises | Template ID, Set Type (normal, warmup, failure, dropset), Weight (kg), Reps |
| Routines | Title, Exercise JSON Schema, Folder ID |
| Folders | Folder Name, Routine List |
All list-based commands support pagination using the --page and --page-size flags to handle large datasets efficiently.
Hevy CLI Skill Advanced Features
- Raw JSON output mode using the -j flag for precise data extraction and multi-agent interoperability.
- Support for external JSON files using the @filepath syntax for complex exercise configurations.
- Granular date filtering for exercise history to support deep-dive data analytics.
- Full support for varied set types including failure and dropsets to capture high-intensity training data accurately within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
gblog
A comprehensive Command Line Interface for managing Google Blogger posts, schedules, and analytics.
Swift Programming
A comprehensive skill enabling AI agents to write, debug, and optimize Swift code for the entire Apple ecosystem.
Pine Editor Skill
A specialized development tool for creating TradingView Pine Script v6 indicators and automated trading strategies.
PM Visualizer
Transform unstructured product requirements and technical specs into structured, editable Excalidraw diagrams automatically.
Agent Browser
A high-performance Rust-based headless browser CLI that enables AI agents to navigate, click, and extract data from the web using Openclaw Skills.
Agent Browser
A high-performance Rust-based headless browser CLI designed for AI agents to navigate and interact with the web through structured commands.
Featured*
