Mocha.sh is a minimalist, aesthetic CLI tool for developers —
bringing a cozy, stylish touch to your terminal while helping you stay productive.

Mocha.sh is available for all major platforms —
install it the way that fits your setup best.

Install globally with pipx:

pipx install mocha-sh

Or update:

pipx upgrade mocha-sh

Then run:

mocha

🍎 macOS (via Homebrew)

brew tap mocha-sh/mocha
brew install mocha-sh

To update:

brew upgrade mocha-sh

🐧 Ubuntu / Debian (.deb package)

sudo apt install ./mocha-sh_0.1.6_all.deb

Or build it yourself:

sudo apt install dpkg-dev debhelper dh-python python3-all python3-setuptools
dpkg-buildpackage -us -uc
sudo apt install ../mocha-sh_0.1.6_all.deb

🪟 Windows (via Scoop)

scoop bucket add mocha https://github.com/mocha-sh/scoop-mocha
scoop install mocha-sh

To update:

scoop update mocha-sh

• Quick Notes – jot down small snippets or ideas directly from the terminal
• Focus Timer – keep your workflow smooth and your coffee warm
• Stylish Output – color-coded messages, ASCII art, icons
• Hydration Tracker - add glasses to your Tracker
• Coffee Tracker - Track your Coffee
• Plugins - you can now create your own plugins for Mocha
• • New Note/ File System - i will add a new system for mocha files

• Themes & Prompts – cozy terminal themes for your shell
• Small Utilities – handy helper commands for everyday tasks
• Mocha.conf files - full customizable mocha.sh

mocha note "your note"

mocha note list

mocha note view <index>

mocha note edit <index>

mocha note delete <index>

mocha timer 25 -  for a 25 Minutes Timer

mocha hydrate add -adds one glass of water

mocha hydrate stats - shows your stats

mocha coffee add - adds on cup

mocha coffee stats  - same as hydrate stats

More commands and features will be added as Mocha.sh evolves ☕