🧘 zenta
Mindfulness that fits your coding flow
When your mind wanders while coding, simply return to breath. No tracking, no metrics, no disruption—just pure awareness in your terminal.
The noticing itself is the practice. ✨
⚡ Quick Start
# Install git clone https://github.com/e6a5/zenta.git && cd zenta && make install-system # Set up zen aliases echo " alias breath='zenta now --quick' " >> ~ /.zshrc echo " alias breathe='zenta now' " >> ~ /.zshrc echo " alias reflect='zenta reflect' " >> ~ /.zshrc source ~ /.zshrc # Use instantly breath # When mind wanders → return to breath (1 breath cycle) breathe # Need deeper centering → longer session (3 breath cycles) reflect # Evening → gentle day review
🌸 Why zenta?
Fits Your Real Workflow
Notice: "I'm stuck in planning thoughts" Return: breath Continue: Back to coding, more present
True Zen Approach
✅ No tracking → Awareness isn't data to optimize
→ Awareness isn't data to optimize ✅ No analytics → The practice is the goal
→ The practice is the goal ✅ No disruption → Stays in your terminal
→ Stays in your terminal ✅ Just breathing → Pure mindfulness
Built for Developers
Terminal-native (fits your workflow)
Single binary (no dependencies)
Private (no data collection)
Instant ( breath is one keystroke away)
🌊 Beautiful Breathing
$ breath Let ' s breathe 🌸 🌬️ Breathe in gently, let your body expand... ○ ○ · ○ ··· ○ · · · · · · ○ ··· ○ · ○ · Carry this calm with you throughout your day 🙏
Pure visual breathing guidance with gentle animations
💡 Commands
Essential Commands (with aliases)
Command Cycles What It Does Perfect For breath 1 cycle Quick breathing + wisdom quote Mind wandering moments breathe 3 cycles Standard breathing + wisdom quote Before difficult tasks reflect - Gentle evening review End of day contemplation
Full Commands
Command Cycles What It Does zenta now 3 cycles Standard breathing + wisdom quote zenta now --quick 1 cycle Quick breathing + wisdom quote zenta now --extended 5 cycles Extended breathing + wisdom quote zenta now --silent 3 cycles Breathing only, no quote zenta now --simple 3 cycles Simple line animation (terminal compatibility)
Mix options: zenta now --quick --silent (1 cycle, no quote)
🔧 Terminal Compatibility
Beautiful circles vs simple lines:
Most terminals : Gorgeous expanding/contracting breathing circles
: Gorgeous expanding/contracting breathing circles macOS Terminal.app : Auto-detects and uses simple line animation
: Auto-detects and uses simple line animation tmux/screen: Auto-detects and uses simple line animation
Force simple mode: Add --simple to any command
breath --simple # Force simple animation zenta now --simple # Works with any options
Why? Some terminals have ANSI escape sequence quirks. zenta auto-detects and adapts for the best experience.
🎯 Real vs Fake Mindfulness
✅ Real mindfulness (zenta's way):
Notice when mind wanders
Return to breath instantly
Continue work with awareness
No measurement needed
❌ Fake mindfulness:
Tracking meditation streaks
Optimizing awareness metrics
Quantifying inner peace
Making mindfulness productive
🌿 Philosophy
"The quieter you become, the more you are able to hear."
zenta believes:
Mindfulness tools should disappear into practice
The noticing itself is enlightenment
Developers need presence, not productivity hacks
True zen has no metrics
🚀 Installation
macOS/Linux:
git clone https://github.com/e6a5/zenta.git && cd zenta && make install-system
Pre-built binaries: GitHub Releases
Supports: Linux, macOS, Windows, FreeBSD (all architectures)
🧘 Join the Practice
🐛 Bug reports → Issues
→ Issues 💭 Mindful discussions → Discussions
→ Discussions 🔧 Contributions → CONTRIBUTING.md
📄 License
MIT License - LICENSE
"The best way to take care of the future is to take care of the present moment." — Thich Nhat Hanh
Start your mindful coding practice today: