Workout CLI for Openclaw

A high-performance command-line interface for logging workouts, managing exercise libraries, and tracking multi-user fitness progression.

gricha
v1.1.0
Jan 25, 2026
4
4.2k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install workout

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install workout 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 Workout CLI?

The Workout CLI is a comprehensive fitness management tool designed for users who prefer the efficiency of a terminal-based workflow. As a standout entry in the Openclaw Skills collection, it allows for granular tracking of sets, reps, and weights while maintaining a robust exercise library. It moves beyond simple logging by offering multi-user profile support, allowing different individuals to maintain independent histories and templates on a shared system.

This skill emphasizes data integrity for long-term analysis. By enforcing strict exercise definitions and accurate numerical logging, it enables users to generate meaningful insights into their Personal Records (PRs), weekly volume, and strength progression over time. It is an ideal solution for developers and power users who want to treat their fitness data with the same precision as their code.

Workout CLI Use Cases

  • Managing and logging real-time gym sessions using pre-defined workout templates.
  • Tracking strength progression and Personal Records across hundreds of unique exercises.
  • Supporting multiple athletes on a single machine with isolated user profiles.
  • Analyzing weekly training volume and muscle group distribution via CLI commands.
  • Maintaining a structured exercise library categorized by equipment and muscle groups.

How Workout CLI Works

  1. Select or create a user profile to ensure data isolation using the profile management commands.
  2. Add new exercises to the shared library, specifying muscle groups, exercise type, and equipment requirements.
  3. Initiate a workout session either from a saved template or as a freestyle empty session.
  4. Log sets in real-time by providing the weight and rep count, which the skill validates against the exercise library.
  5. Use editing commands like undo, swap, or delete to refine data during the session.
  6. Complete the session to commit the data to history and trigger PR and volume calculations.

Workout CLI Setup

To get started with this skill, ensure the workout binary is in your path and initialize your profile. This is a core requirement for many Openclaw Skills focused on personal data.

# Create a new user profile
workout profile create yourname

# Verify your exercise library
workout exercises list

# Start your first session
workout start --empty

Workout CLI Data Schema & Taxonomy

The Workout CLI organizes data into a structured hierarchy to facilitate deep analytics within the Openclaw Skills framework:

Component Data Managed Scope
Profiles User configuration, personal templates, and workout history User-Specific
Exercises Name, muscles (chest, back, etc.), type (isolation/compound), and equipment Global/Shared
Sessions Start/end times, exercise sequence, and session-wide notes User-Specific
Logs Set-by-set data including weight (lbs), reps, and RIR (Reps in Reserve) User-Specific
Analytics PR history, weekly volume, and progression trends User-Specific

Workout CLI Advanced Features

  • Multi-user profile support with independent data silos and shared exercise libraries.
  • High-fidelity logging with support for Reps in Reserve (RIR) and multiple sets in a single command.
  • Dynamic exercise swapping that migrates logged sets between movements during an active session.
  • Advanced analytics for tracking weekly volume and historical strength progression.
  • Full JSON output support for all commands, enabling integration with other automated workflows.

SKILL.md


Loading

Related Openclaw Skills

Featured*