A powerful command-line interface for the Hevy workout tracking API that enables AI agents to query and manage fitness data.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install hevy
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 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?
The Hevy CLI is a specialized tool designed to bridge the gap between your fitness journey and your development environment. By leveraging Openclaw Skills, developers and fitness enthusiasts can programmatically access their workout history, routines, and exercise metrics. It provides a robust interface for fetching detailed session data, searching through exercise templates, and even creating new routines through simple CLI commands or JSON inputs.
This skill transforms your AI agent into a personal fitness data scientist, allowing for deep analysis of your gym performance. Whether you are tracking progress on a specific lift or organizing your weekly splits, this Openclaw Skills integration provides the necessary endpoints to handle workout data with precision and ease.
Hevy CLI Use Cases
- Retrieving detailed summaries of recent gym sessions to track volume and intensity.
- Analyzing exercise-specific progression over time by fetching historical data for certain movements.
- Managing workout routines and folders to stay organized across different training phases.
- Querying the exercise database to find specific movements by muscle group or type.
- Automating the creation of new routines using JSON-formatted templates.
How Hevy CLI Works
- The user provides a natural language prompt to the AI agent regarding their workout data.
- The agent identifies the appropriate Hevy CLI command to execute based on the user's intent.
- The skill authenticates with the Hevy API using the provided environment variable and fetches the requested data.
- Results are returned in a human-readable format or JSON, which the agent parses to provide a concise answer.
- For write operations, the agent can generate JSON payloads to update routines or create new exercise templates.
Hevy CLI Setup
To get started with this addition to your Openclaw Skills library, ensure you have an active Hevy Pro subscription for API access.
- Obtain your API key from the Hevy Developer Settings.
- Set your environment variable:
export HEVY_API_KEY="your-key"
- Verify the connection and configuration:
hevy status
Hevy CLI Data Schema & Taxonomy
The skill interacts with several core data entities within the Hevy ecosystem. Data can be exported in JSON format using the --json flag for easy programmatic parsing.
| Entity | Description | Key Metadata |
|---|---|---|
| Workout | A completed gym session record | id, start_time, end_time, exercises |
| Routine | A saved template for future workouts | title, notes, folder_id, exercises |
| Exercise | A specific movement template | exercise_template_id, muscle_group, type |
| Set | Individual lift data within a workout | type, weight_kg, reps, rest_seconds |
| Folder | Organizational container for routines | id, name |
Hevy CLI Advanced Features
- Native support for JSON output across all major commands for easy integration with other Openclaw Skills.
- Intelligent duplicate prevention when creating custom exercises to maintain data integrity.
- Comprehensive muscle group filtering to search for specific movements like quadriceps or chest exercises.
- Flexible unit support allowing users to toggle between pounds (lbs) and kilograms (kg) via CLI flags.
- Ability to manage routine folders and bulk-update routines via stdin or file-based JSON inputs.
SKILL.md
Loading
Related Openclaw Skills
Fitbit Health Data Integration
A command-line interface for querying comprehensive health and fitness metrics from Fitbit wearables.
Beestat
A command-line interface for the Beestat API that enables detailed monitoring and analytics for ecobee smart thermostats.
AnyList CLI
A terminal-based interface for AnyList that enables users to manage grocery and shopping lists through an AI agent or command line.
YouTube AI Video Fetcher
Automates the retrieval and filtering of recent AI-related videos from specific YouTube channels using the Data API v3.
Paprika Recipe Manager CLI
A powerful command-line interface for the Paprika Recipe Manager that enables AI agents to query recipes, meal plans, and grocery lists.
Resend Inbound Email Manager
A specialized CLI tool for programmatically accessing, listing, and inspecting received emails and domain configurations via the Resend API.
METADATA
Featured*
