Claude Gym

Reminds developers using Claude Code to perform deskside exercises during long-running tasks by watching local logs.

Reminds developers using Claude Code to perform deskside exercises during long-running tasks by watching local logs.

The gist

Claude Gym is a command-line exercise companion for developers using the Claude Code assistant. Created by 477-Studio as a community project, it solves the problem of physical strain from sitting during long coding sessions by prompting users to perform quick stretches at natural pauses in their workflow. A pixel-art character guides the experience from the terminal.

What it does

  • Monitors local Claude Code JSONL log files for activity.
  • Displays pixel-art animations prompting deskside exercises during natural pauses.
  • Triggers prompts when Claude Code enters planning mode, spawns agents, or runs multiple tools.
  • Automatically dismisses exercise prompts when the user's attention is required again.
  • Notifies the user with an animation when a long-running task is complete.

How it works

The user installs the open-source tool globally via npm and runs it from a new terminal tab in their project directory. Claude Gym operates entirely locally, watching the file system for changes to Claude Code's logs. It requires no API keys or network access. When it detects a suitable pause, it displays a pixel-art exercise prompt directly in the terminal.

Best for

Developers who use the Claude Code assistant for extended periods and want automated, non-intrusive reminders to stretch and move.

Watch out for

The animated exercises are illustrative, not instructional, and do not demonstrate proper form. The creators also note that while it should work on Windows, it has not been thoroughly tested on that platform.