A pixel-art exercise companion that nudges you to move during long Claude Code runs
You ship code. Your body ships pain. Stand up. Stretch your back. Shake out your legs. It takes 30 seconds and your body will stop screaming at you by 6pm.
Claude Gym watches Claude Code's workflow and prompts quick deskside exercises at natural pauses — when CC enters plan mode, spawns agents, or goes on long tool streaks.
npm install -g claude-gymNew terminal tab, same project directory:
cgymThat's it. Luca (your pixel-art dev) appears in a cozy home office with Cookie the cat, waiting for the right moment to make you move.
If it saves your back even once, leave a star — it helps other CC users find this.
It reads Claude Code's local JSONL logs. No API keys. No network. No telemetry. Just file watching.
- CC enters plan mode or spawns a subagent → Luca waves, "time to exercise!"
- CC goes on a 3+ tool call streak → same thing, you're not needed anyway
- CC needs you back → prompt auto-dismisses, zero friction
- You're mid-squat and CC finishes? → Cookie the cat wakes up to let you know
More than ten exercises with pixel-art animations — squats, desk push-ups, wall sits, arm circles, and more.
npm (recommended)
npm install -g claude-gymDirect download
Download the latest archive from Releases and extract.
macOS (Apple Silicon)
curl -L https://github.com/477-Studio/claude-gym/releases/latest/download/claude-gym_latest_darwin_arm64.tar.gz | tar xz
sudo mv cgym-darwin-arm64 /usr/local/bin/cgymmacOS (Intel)
curl -L https://github.com/477-Studio/claude-gym/releases/latest/download/claude-gym_latest_darwin_amd64.tar.gz | tar xz
sudo mv cgym-darwin-amd64 /usr/local/bin/cgymLinux (x64)
curl -L https://github.com/477-Studio/claude-gym/releases/latest/download/claude-gym_latest_linux_amd64.tar.gz | tar xz
sudo mv cgym-linux-amd64 /usr/local/bin/cgymWindows — download the .zip from Releases, extract, and add cgym-windows-amd64.exe to your PATH.
Build from source
Requires Go 1.25+ with CGO enabled.
git clone https://github.com/477-Studio/claude-gym.git && cd claude-gym
go build -o cgym .Linux deps: sudo apt install libgl1-mesa-dev libxi-dev libxcursor-dev libxrandr-dev libxinerama-dev libxxf86vm-dev libwayland-dev libxkbcommon-dev
Run in a separate terminal tab, same directory as your CC session:
cgym # watch current project
cgym watch ~/other/dir # watch a different projectIs this an Anthropic product? Nope. Community project, not affiliated.
Does it phone home? No. Zero network. Reads local files only.
Why? Because git blame can't explain your herniated disc.
This thing is early. There's a lot of low-hanging fruit:
- New exercises (got a good stretch? add it)
- New biomes (tired of the home office? build a cafe, a park, a space station)
- New characters (want Sally the vibe coder? Luca the dog? make them, we'll ship them)
- Windows testing (we believe it works, "believe" doing a lot of heavy lifting here)
See CONTRIBUTING.md for setup. Good first issues if you want a starting point.
The pixel-art animations are for fun, not instruction. They do not demonstrate proper exercise form — please research correct technique before attempting any movement.
If you feel any pain or discomfort, stop immediately and consult a physiotherapist or doctor. Do not exercise through injury. The authors of this project accept no responsibility for harm resulting from improper exercise.
MIT — see LICENSE. Originally inspired by claude-quest by Michaelliv.
git blame won't explain your herniated disc. but a ★ might prevent one.
Star the repo if your future self would thank you.
Open an issue if something's broken or missing.

