hevy-rs 0.1.1

A command-line interface for the Hevy API
hevy-rs-0.1.1 is not a library.

hevy-rs

Give your AI coach safe, structured access to your Hevy workouts, routines, and progress. hevy-rs is a Rust CLI plus a bundled agent skill for accessing Hevy data—it is not a coaching product and does not provide fitness advice.

CI crates.io License

Use with your AI coach

An AI coach is a user-selected external agent that provides fitness guidance. The CLI and bundled hevy-rs skill give it structured access to Hevy data; choose and trust your own agent and model provider, and review their data practices before sharing data with them.

  1. Install Rust and Cargo if needed, then install the released CLI on the host where your agent runs:

    cargo install hevy-rs --locked

    The hevy-rs command must be on that host's PATH.

  2. Install the bundled skill with the agent-neutral skills installer:

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

  3. Configure your Hevy API key in the agent host's environment—not in a chat prompt:

    export HEVY_API_KEY='your-api-key'

  4. Restart, or open, your compatible agent so it can discover the CLI and skill.

Start safely with a read-only prompt:

Review my last four Hevy workouts and identify one progression opportunity. Do not make any changes to my Hevy account.

For a routine change, keep drafting separate from writing. First ask your AI coach:

Draft a routine for my stated goal using my recent Hevy workouts. Show the exact proposed routine and do not create or update anything yet.

Review the proposal. Only then give fresh, explicit approval of that exact plan, for example:

I approve creating exactly the routine shown in your previous message: [paste the exact approved plan]. Create it now.

The bundled skill requires this fresh approval before a mutation.

Use the CLI directly

You can use hevy-rs without an agent skill. Set the key in your environment, then make a safe first read:

export HEVY_API_KEY='your-api-key'
hevy-rs user get

Use JSON for scripts and other machine consumers:

hevy-rs --format json user get

The command tree is resource-first; inspect help before using an unfamiliar operation:

hevy-rs --help
hevy-rs workouts --help
hevy-rs workouts create --help

Documentation

Compatibility

hevy-rs is pre-1.0: verify your installed command contract with hevy-rs --help. The public Hevy API may change.

License

Licensed under either of

at your option.