Skip to main content

☕ Mocha.sh — your cozy terminal companion

Project description

☕ Mocha.sh

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


☕ Installation

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


🐍 Universal (Recommended for all systems)

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

🌱 Features

  • 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

MochaEditor_2025-10-20T20_51_10_297548 MochaEditor_2025-10-20T21_01_35_736691

🕖 Coming soon

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

How to use 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 ☕

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mocha_sh-1.0.3.tar.gz (9.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mocha_sh-1.0.3-py3-none-any.whl (10.7 kB view details)

Uploaded Python 3

File details

Details for the file mocha_sh-1.0.3.tar.gz.

File metadata

  • Download URL: mocha_sh-1.0.3.tar.gz
  • Upload date:
  • Size: 9.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.13

File hashes

Hashes for mocha_sh-1.0.3.tar.gz
Algorithm Hash digest
SHA256 e7da7fe95a0c7a90f2c1fb44263eff774ea79c17440748de06863d4eeaad66c6
MD5 2ccfd1591117b030f54ceeebe41a8ea5
BLAKE2b-256 a7a3571417f32866495eb934885096d59e93c6816a4ffebd9cec95f354feffe5

See more details on using hashes here.

File details

Details for the file mocha_sh-1.0.3-py3-none-any.whl.

File metadata

  • Download URL: mocha_sh-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 10.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.13

File hashes

Hashes for mocha_sh-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 5ac25475e2d9048198261dee1ebb54d35afa2f7e1e3cd6f7e32b09c6a5160738
MD5 d447b825f6473045232fab3e99f1da7e
BLAKE2b-256 e1bdc86369cbbf5c8997072aada8f2f0666a854b7ee8740d539de0ecfd5cf5cb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page