🏋️ exercises-cli

899+ fitness exercises in your terminal. Search, filter, and export — completely offline, multilingual (EN/ES).

Also available as: exercisedb · exercises-db · fitkit

Quick Start

# No install needed — just run
npx exercises-cli search "bench press"

# Or install globally
npm install -g exercises-cli
exercises search "squat"

Commands

search <query> — Search by name or instructions

exercises search "bench press"
exercises search "curl" --muscle biceps
exercises search "sentadilla" --locale es

list — List exercises with filters

exercises list --muscle chest
exercises list --muscle chest --equipment dumbbell --level beginner
exercises list --category cardio --limit 10
exercises list --force pull --mechanics compound

get <id> — Get exercise details

exercises get "Barbell Bench Press"
exercises get d586b5aa-c2f4-4cb5-8038-d10b03c3b763

muscles — List all muscle groups

exercises muscles
exercises muscles --format json

equipment — List all equipment

exercises equipment
exercises equipment --format csv

categories — List categories

exercises categories

stats — Dataset statistics

exercises stats

export — Export to JSON or CSV

# Export all chest exercises to CSV
exercises export --muscle chest --format csv > chest_exercises.csv

# Export everything as JSON
exercises export --format json > all_exercises.json

# Export beginner dumbbell exercises
exercises export --level beginner --equipment dumbbell --format json

Options

| Flag | Short | Description | Default | |------|-------|-------------|---------| | --locale | -l | Language: en or es | en | | --format | -f | Output: table, json, or csv | table | | --limit | -n | Max results | 20 | | --muscle | -m | Filter by muscle group (fuzzy) | — | | --equipment | -e | Filter by equipment (fuzzy) | — | | --level | -d | Filter by difficulty | — | | --category | -c | Filter by category | — | | --force | | Filter by force type | — | | --mechanics | | Filter by mechanics | — |

Fuzzy Matching

Muscle and equipment filters use substring matching, so you don't need to type exact names:

exercises list --muscle back        # → lower back, middle back, lats
exercises list --equipment bar      # → Barbell, Parallel Bars
exercises list --equipment band     # → Bands, Resistance Band

Dataset

• 899 exercises with step-by-step instructions
• 17 muscle groups with primary/secondary/tertiary targeting
• 36 equipment types
• 7 categories: strength, cardio, stretching, plyometrics, powerlifting, olympicWeightlifting, strongman
• 2 locales: English (en) and Spanish (es)

All data is bundled in the package — no internet connection required.

Also Available As

This package is published under multiple names for convenience:

npx exercises-cli search "squat"
npx exercisedb search "squat"
npx exercises-db search "squat"
npx fitkit search "squat"

Related

• @kinetic-place/exercises-json — Raw JSON dataset
• @kinetic-place/exercises-db — Database-ready format
• @kinetic-place/exercises-api — Self-hostable REST API

License

MIT © Kinetic.place