Omahub
← All plugins
L

Zen

by Luo Tao <luotao@hey.com>

Guided-breathing meditation for the Omarchy shell: a fullscreen visual breathing pacer (box, 4-7-8, coherent) with session tracking and a daily streak in the bar.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
babe648
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
babe648
Reviewed
1 month ago

This is a benign meditation plugin that reads/writes a local stats file, plays sounds, and uses DND. No dangerous operations or injection vectors found.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/ya-luotao/omarchy-zen --enable
Other #bar

Zen for Omarchy

Guided-breathing meditation as a native Omarchy shell plugin (Omarchy 4 "Quattro" or later). A fullscreen visual pacer — a circle that grows as you breathe in and shrinks as you breathe out — so the eyes lead the breath and the mind has one thing to come back to.

<p align="center"> <img src="screenshots/breathe.png" alt="Fullscreen breathing pacer" width="46%" /> <img src="screenshots/panel.png" alt="Bar panel with weekly practice view" width="26%" /> </p>
  • Breathing pacer (fullscreen overlay) — pick a pattern, pick a length, breathe. Phase name and a countdown digit ride along; the desktop is fully hidden for the duration.
  • Bar widget — an ensō in the bar: click to choose pattern and length, middle-click to start your usual session immediately. The tooltip carries your daily streak, the panel a seven-day practice view.
  • Session tracking — minutes per day in ~/.local/state/omarchy/zen/stats.json. Ending early still logs the minutes you actually practiced: a streak kept by a short session beats one lost to perfectionism.
  • Session comforts — a soft bell at start and end, and do-not-disturb engaged for the duration (borrowed, not owned: your previous DND state is restored afterwards). Both on by default, both optional.

Patterns

Key Pattern Rhythm Good for
box Box breathing in 4 · hold 4 · out 4 · hold 4 steady focus
478 4-7-8 in 4 · hold 7 · out 8 winding down
coherent Coherent in 5.5 · out 5.5 balance, ~5.5 breaths/min

Install

omarchy plugin add https://github.com/ya-luotao/omarchy-zen.git --enable

Keybinding

Add to ~/.config/hypr/bindings.lua:

o.bind("SUPER + SHIFT + B", "Breathe",
  [[omarchy-shell shell summon luotao.zen '{"pattern": "box", "minutes": 10}']])

Omit the payload keys to use the defaults ({} works too).

Usage

  • Left-click the ensō → panel: pattern, length, Begin (1–3 picks a pattern, Enter begins)
  • Middle-click the ensō → start immediately with your saved defaults
  • During a session: Esc ends early (practice up to that point still counts)
  • Session complete → a notification with your updated streak

From scripts:

omarchy-shell luotao.zen start 478 5   # pattern, minutes
omarchy-shell luotao.zen status        # {"streakDays":3,"todayMinutes":15,...}

Pattern and length chosen in the panel are written back to shell.json, so your last choice is the default next time.

Settings

omarchy bar set luotao.zen bell false   # no bells
omarchy bar set luotao.zen dnd false    # leave notifications alone

Per-summon overrides work too: '{"pattern": "box", "minutes": 10, "bell": false, "dnd": false}'.

Uninstall

omarchy plugin remove luotao.zen

Remove any keybindings you added to ~/.config/hypr/bindings.lua. Your practice history in ~/.local/state/omarchy/zen/ is left in place; delete it by hand if you want it gone.

Roadmap

  • Soundscapes (rain, brown noise) during sessions
  • Interval chimes ("mindful bell every 5 minutes")

License

MIT