hevy

What This Skill Does

The Hevy skill for OpenClaw integrates your AI agent with the Hevy workout tracking ecosystem via the command line interface. It empowers users to query their personal training data directly through natural language requests. Whether you are checking your training history, reviewing specific exercise performance, or organizing your training routines, this skill acts as a bridge between the Hevy Pro API and your AI assistant. It supports fetching historical workout data, inspecting specific routine structures, searching through the exercise library, and even programmatic creation of new routines and custom exercises.

Installation

To begin using this skill, you must have an active Hevy Pro subscription. First, retrieve your API key from the developer settings page at https://hevy.com/settings?developer. Once obtained, set this as an environment variable in your system configuration: export HEVY_API_KEY="your-key". After the environment is prepared, install the skill into OpenClaw by executing the command: clawhub install openclaw/skills/skills/mjrussell/hevy.

Use Cases

This skill is ideal for fitness enthusiasts who want to analyze their progress without manually digging through the app. Common use cases include:

• Tracking progress: Quickly pull data on specific exercises to see how your strength has increased over time.
• Routine management: Generate, update, or reorganize your gym sessions via JSON files to keep your training plan fresh.
• History review: Instantly answer questions about when you last performed a specific lift or what the total volume of your last session was.
• Exercise discovery: Search the full database of exercises or filter by specific muscle groups (e.g., chest, back, legs) to add variety to your training.

Example Prompts

1. "What was my most recent gym session, and what exercises did I perform?"
2. "Show me the history of my bench press progress over the last 20 sessions."
3. "Create a new routine titled 'Leg Day' using the exercises I previously saved in my routine template folder."

Tips & Limitations

• Data Accuracy: Always verify data when performing batch updates to routines to avoid overwriting existing data unexpectedly.
• Duplicate Prevention: The create-exercise command includes safety checks to prevent duplicates. If you are certain you wish to create a duplicate, use the --force flag, though this is discouraged for general data hygiene.
• Formatting: Note that the default weight unit is lbs, but you can append the --kg flag to any workout command to retrieve data in kilograms if you prefer international standards.