Skip to content

e6a5/zenta

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

32 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

🧘 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 (one-liner)
curl -fsSL https://raw.githubusercontent.com/e6a5/zenta/main/install.sh | bash

# Set up zen aliases
echo "alias breath='zenta now --quick'" >> ~/.zshrc
echo "alias breathe='zenta now'" >> ~/.zshrc
echo "alias anchor='zenta anchor'" >> ~/.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)
anchor    # Find your rhythm β†’ interactive breathing anchor
reflect   # Evening β†’ gentle day review

🌸 Why zenta?

Fits Your Real Workflow

  1. Notice: "I'm stuck in planning thoughts"
  2. Return: breath
  3. Continue: Back to coding, more present

True Zen Approach

  • βœ… No tracking β†’ Awareness isn't data to optimize
  • βœ… No analytics β†’ The practice is the goal
  • βœ… No disruption β†’ 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
anchor User-led Interactive anchor to find your rhythm When you need to set your own pace
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 anchor User-led Interactive anchor to find your own rhythm
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
  • macOS Terminal.app: Auto-detects and uses simple line animation
  • tmux/screen: Works great with complex animations

Force simple mode: Add --simple to any command

breath --simple     # Force simple animation
zenta now --simple  # Works with any options

Why? Only macOS Terminal.app has 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

Option 1: Pre-built Binaries (Recommended)

macOS/Linux:

# Download and install the latest binary for your platform
curl -s https://api.github.com/repos/e6a5/zenta/releases/latest \
| grep "browser_download_url.*$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/')" \
| cut -d '"' -f 4 \
| xargs curl -L -o zenta.tar.gz \
&& tar -xzf zenta.tar.gz \
&& sudo mv zenta-* /usr/local/bin/zenta \
&& rm zenta.tar.gz

# Or download manually from GitHub Releases

Windows: Download the latest .zip file from GitHub Releases, extract it, and add the executable to your PATH.

Manual Download: GitHub Releases - Choose your platform

Option 2: Build from Source

Requires Go 1.23+ installed

git clone https://github.com/e6a5/zenta.git && cd zenta && make install-system

Install Go first: https://golang.org/dl/

Supports: Linux, macOS, Windows, FreeBSD (all architectures)


🧘 Join the Practice


πŸ“„ 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:

breath  # Just try it πŸ™

About

zenta - mindfulness for terminal users πŸ§˜β€β™‚οΈ

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 5