Howmoji

Caution

howmoji is satire. We highly recommend checking out gitmoji. Many thanks to gitmoji and the awesome carloscuesta for inspiring this fun take on commit emojis!

Setup

Installation

Since we are still in alpha. The only way to install is using bash.

curl -sSL https://raw.githubusercontent.com/Felix-Blom/howmoji/main/install.sh | bash

Note: The installer now uses ~/.local/bin by default (no admin required). Make sure this directory is in your PATH:

export PATH="$HOME/.local/bin:$PATH"

Add this line to your shell profile (.bashrc, .zshrc, etc.) to make it permanent.

Usage

To start howmoji in the cli use the following command:

howmoji -c

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. We welcome contributions!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes with howmoji (howmoji -c) or gitmoji gitmoji -c
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Asking for new emojis

Want to suggest a new emoji for how you code? We'd love to hear about it! Here's how:

1. Check the existing issues to make sure your emoji hasn't been suggested
2. Create a new issue with the following:

• Title: [Emoji Request] 🆕 Your emoji
• Description: How you use this emoji while coding
• Example: When do you feel like using this emoji?

Remember: Focus on the "how" not the "what". Tell us about your coding state of mind! 😎

Why howmoji?

This project started after a rejected gitmoji PR on gitmoji, in which I wanted the vibecoding emoji 😎, to indicate I was vibecoding.

Carloscuesta's response was thoughtful, friendly, and totally made sense :

Note

Hey! 👋🏼 This falls into the "how" category and we don't want to add emojis for that as the focus should be in the contents of the commit not how it was made.

We decided not to remove those emojis but we're not adding new ones that do not fall into the "what"

Thanks!

~ carloscuesta

---

However ✨, I still wanted to express my coding vibes! 🎮 Hence, howmoji - where "how" matters more than "what" 🌟. Because sometimes you're not just fixing bugs, you're vibing with your code 😎.