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 happens to your data
The essentials in plain words. How it works technically follows below.
- Your playlists are kept on your device, in your browser. There is no account and no password with us.
- So that your other devices and your friends can find a playlist, a go-between on the internet may keep a copy of it.
- A playlist is not secret: anyone who has its link can look at it. Only you, and friends you allow, can change it. So put nothing private in it.
- The videos come from YouTube, Vimeo or Instagram. Those services see that you watch, just as on their own pages. When you paste a link, the app also asks them for the title and the length.
- We show no ads and do not track you.
- The mod in Claude Code does not go on the internet. It only reads your list of clips and opens a clip in your browser when you ask it to.
For the technically curious
How the app does without an account, and who learns what, and when. The app shows the full notice on first start, under “Technical”. Open Yoga Clips
The app, Yoga Clips
- The app is delivered through a public IPFS gateway, which sees that you loaded it. With your own IPFS node (Kubo) or the IPFS Companion extension, you fetch it from the network instead.
- Playlists and clips are kept in the browser (IndexedDB), there offline and after a reload. Which clips you did, and when, stays on this device.
- Devices synchronise a playlist peer-to-peer (OrbitDB over libp2p). Relay nodes introduce them to each other and may keep a copy, so that another device can collect it later.
- A playlist decides who may write to it: you, and any identity you let in. Anyone who has its address can read it. None of it is encrypted.
- With a passkey you identify yourself to the other devices, and nobody else can write as you. Without one, a random identity exists in this browser only; clear its storage and it is gone, along with the right to write to your playlists.
- No tracking cookies. Besides your data, the app saves only your language, your theme and whether the start notice still appears.
YouTube, Vimeo, Instagram
- When you paste a YouTube or Vimeo link, the browser asks youtube.com or vimeo.com for the title, the thumbnail and, at Vimeo, the length. Only YouTube’s player tells the length of a YouTube video, so the app loads it from youtube-nocookie.com out of sight, without playing, and it fetches its own parts from other Google servers.
- A playlist’s cards show preview images: YouTube’s come from i.ytimg.com, and Vimeo’s are asked of vimeo.com once per clip and remembered.
- Playing a clip loads it from youtube-nocookie.com, player.vimeo.com or instagram.com, and that service sees you watch. The player you watch in loads only when you press play. Instagram runs through its own embed page in a frame, with no Instagram script in the app.
- A clip link from the mod plays the clip without the app starting: no notice, no identity, no relay. Nobody is asked anything until you press Start, and then only the clip’s service.
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.
This page
- Loads everything from its own address, the fonts included; nothing from third parties.
- Sets no cookies. The browser keeps only your language and theme.
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.