Short yoga clips for the time Claude is working — chosen to fit the wait.
While Claude works on something long, the yoga-break mod estimates how long you will wait and suggests a clip from your own playlist that fits into it. You make, share and play the playlist in Yoga Clips, in the browser, without an account.
- open source, MIT
- no account
- the mod stays off the network
An estimate, not a promise: until three long turns have been measured, the mod assumes five minutes.
Claude works, you take a break that fits
Three steps, all inside Claude Code. The mod measures durations; it reads nothing of what you or Claude write.
- 1
Claude works on something long
An agent, a build, a test suite, a web search. The mod looks at the whole turn and at each long tool call.
agent · build · research - 2
The mod estimates the wait
From the median of earlier waits of the same kind. From 90 seconds of expected remaining time, the status line counts down.
status line: ~3:40 - 3
It suggests a clip that fits
The longest one that ends 20 seconds before the wait does, at most once every ten minutes. A band above the prompt offers Open, Done and Later.
[Open] [Done] [Later]
Install yoga-break in Claude
The mod comes from its own marketplace, the public repository NiKrause/yoga-break on GitHub, not from Anthropic’s plugin directory. Two ways, depending on where you use Claude Code.
In the terminal
Type this line at the prompt of a Claude Code session:
/plugin install yoga-break --marketplace NiKrause/yoga-break Answer y when asked to add the marketplace, then choose where the mod applies (the scope).
In the desktop app
/plugin does not run there. Instead:
- 1 The + next to the prompt box, then Plugins
+ → Plugins - 2 Add marketplace
NiKrause/yoga-break - 3 Add plugin
yoga-break
Then
/yoga help- five steps from a playlist in Yoga Clips to suggestions here
/yoga- the clip that fits now, and today’s yoga minutes
/yoga lang de- switches the mod’s texts to German; English is the default
/yoga skip- no suggestions for 60 minutes
Until you have a playlist of your own, the mod suggests three made-up sample clips, so that it has something to show.
Make, share and play playlists
Yoga Clips runs in the browser. A playlist is kept in your browser and synchronised peer-to-peer with the devices that open it (OrbitDB, libp2p); a relay introduces the devices to each other and keeps a copy.
Make a playlist
With a passkey, which carries your playlists to your other devices, or anonymously in this one browser. No account, no password.
Add clips by link
From YouTube, Vimeo or Instagram. For YouTube and Vimeo the title and length fill themselves in; for Instagram you type them.
Share by link or QR code
Anyone with the link can see the playlist. The QR code carries it to a phone.
Let friends write
Add a friend’s DID under write permissions and they can add clips too. You can take it back.
Play in the cinema
The clip alone on a dark page; one press starts it in fullscreen. Instagram plays in a plain frame and decides itself whether the video plays there.
Done marks and minutes
Mark a clip done and the app counts your minutes, in this browser only.
Connect the mod
Once the playlist has clips, bring it into Claude Code. /yoga help walks through the same steps.
- 1
Export
In the playlist, under clips.json:
Export clips.json - 2
Put the file in place
The mod reads its clips from there and from nowhere else. Export again after adding clips.
~/.yoga/clips.json - 3
Set the playlist link
Copy the link under “Share this playlist”. Open then plays the clip in Yoga Clips’ cinema instead of at its own address.
/yoga playlist <link>
A clip you add with /yoga add is in clips.json only, until you import the file in the app.
What stays with you, and who is asked when
No account, no advertising, no tracking. What leaves your computer, and when, is all listed here.
The mod, yoga-break
- Makes no network request and opens no socket.
- Reads and writes ~/.yoga/clips.json, and no other file.
- Keeps durations (seconds only, nothing of a turn’s text), suggestions, done clips and settings in Claude Code’s own plugin store.
- Runs one command when you press Open: open (macOS) or xdg-open (Linux) with the clip’s link.
The app, Yoga Clips
- Playlists are kept in the browser (IndexedDB) and synchronised peer-to-peer; the relay that introduces the devices keeps a copy.
- A playlist is not encrypted: whoever has its link can read its links, titles, teachers and tags.
- Which clips you did, and when, never leaves your browser.
- Nothing connects before you accept the consent screen.
Third parties, and when
- When you paste a YouTube or Vimeo link, the app asks the service for its title and length; for the length it loads YouTube’s player out of sight, without playing.
- Thumbnails come from YouTube’s and Vimeo’s image servers.
- The YouTube, Vimeo or Instagram player loads only after you press play. Instagram runs in a plain frame, with no Instagram script on the page.
- This site sets no cookies and loads nothing from third parties, the film included.
Frequently asked questions
What does it cost?
Nothing. The mod and the app are open source under the MIT licence. The clips themselves come from YouTube, Vimeo or Instagram, on their terms.
Do I need an account?
No, neither for the mod nor for the app. In the app you start with a passkey or anonymously. A passkey brings your playlists to your other devices; anonymous ones stay in the browser you made them in.
Where does the mod come from?
From its own marketplace, the public repository NiKrause/yoga-break on GitHub, where you can read every line before you install it. It is not listed in Anthropic’s plugin directory.
Which systems does it run on?
Wherever Claude Code runs, in the terminal and in the desktop app. To open a clip it uses open on macOS and xdg-open on Linux; on Windows it shows the link instead.
Does the mod read what I work on?
No. It measures how long turns and tool calls take and sorts tool calls into agent, build, research and other. It keeps seconds, nothing of a turn’s text, and sends nothing anywhere.
How good is the estimate?
As good as your history. It is the median of earlier waits of the same kind; until three long turns have been measured, the mod assumes five minutes. If the work ends early, the band goes away; a clip you started keeps playing in the browser.
Do I need a playlist of my own?
Not to try it. The mod starts with three made-up sample clips, so that it has something to show. /yoga help shows how to replace them with your own.
Does the mod speak German?
Yes. Its texts are English by default; /yoga lang de switches them to German, /yoga lang en back. The app and this site speak both languages.