hevy-rs

A Rust command-line interface for the Hevy API.

Status: Early development. The CLI supports the public authenticated-user, workout, routine, exercise-template, routine-folder, exercise-history, and body-measurement operations.

Install

Install Rust and Cargo with rustup, clone this repository, then install the binary:

git clone https://github.com/diegaccio/hevy-rs.git

cd hevy-rs

cargo install --path .

hevy-rs --help

To run directly from a checkout instead, replace hevy-rs below with cargo run --.

First safe read

Create an API key in Hevy, keep it out of shell history, and supply it through the environment:

export HEVY_API_KEY='your-api-key'

hevy-rs user get

Use JSON for scripts and agents:

hevy-rs --format json user get

Discover the resource-first command tree before using a new operation:

hevy-rs --help

hevy-rs workouts --help

hevy-rs workouts create --help

Agent skill

Install the bundled hevy-rs skill with the ecosystem installer:

npx skills add diegaccio/hevy-rs --skill hevy-rs

The skill is an operating guide for the CLI; see its entry guide.

Update the project-installed skill after a new release:

npx skills update hevy-rs --yes

If it was installed globally, update it with:

npx skills update hevy-rs --global --yes

Documentation

• Command, configuration, safety, recovery, and fixture reference
• Human command-discovery walkthrough
• Evidence-to-advice walkthrough
• Proposal-to-write walkthrough
• Ambiguous-write recovery walkthrough
• hevy-rs agent skill
• Release policy and maintainer procedure

License

Licensed under either of

• Apache License, Version 2.0, or
• MIT license

at your option.