💫🎧 VibeMatrix

💻 A CLI tool that turns your moods into ASCII art, emojis, and data vibes. 🌈

A fun and expressive CLI tool that lets you track, visualize, and animate your moods — all from your terminal.
Because your CLI deserves to vibe too 💫
Perfect for developers, students, or anyone who wants a fun, lightweight way to track their daily mood while coding or working.

⚡ Installation

🟢 Option 1 — Run Instantly (No Install)

npx vibematrix

📦 Option 2 — Install Globally

npm install -g vibematrix

or

yarn global add vibematrix

or

pnpm add -g vibematrix

or

bun add -g vibematrix

Then run:

vibematrix

💡 Tip: Try using it at different times of the day — see how your vibe graph evolves!

🌟 Table of Contents

• 🚀 Features
• 🛠️ Tech Stack
• ⚡ Installation
• 💻 Usage
• 📂 Project Structure
• 🧠 Troubleshooting
• 💡 Tips
• 🤝 Contributing
• 🪪 License
• 🧑‍💻 Author
• 🔗 Important Links
• 📝 Footer

🚀 Features

• 😎 Log your mood with one simple command
• 📊 See your mood history as a cute emoji bar chart
• 💬 Receive motivational quotes or savage roasts each time you log
• ⏰ Optional mood reminders (feature not implemented in code but mentioned in the original README)
• 🪵 Git commit mood tracker (feature not implemented in code but mentioned in the original README)
• 💻 Interactive ASCII animations (feature not explicitly implemented in code but implied by the description)
• 💡 Cross-platform — works on Windows, macOS, and Linux

🛠️ Tech Stack

• Language: JavaScript
• Dependencies:
  • chalk
  • inquirer
• Environment: Node.js

💻 Usage

➕ Log a New Mood

vibematrix

This command will prompt you to select your current mood from a list of emojis and associated feelings. After selection, you'll receive a motivational quote or a savage roast. Your mood will be saved for future tracking.

📊 View Mood Stats

vibematrix stats

This command displays a summary of your mood history as an emoji bar chart in the terminal. It shows the frequency of each mood you've logged.

Example output:

Your Mood Summary:
😎 ▓▓▓▓▓▓ (5)
😂 ▓▓▓ (3)
😴 ▓ (1)

⏰ Reminder Mode (Not Implemented)

This feature is described in the original README but isn't present in the current code.

vibematrix remind 1h

It’s supposed to check in every hour to ask about your mood.

🪵 Git Commit Mood Mode (Not Implemented)

This feature is described in the original README but isn't present in the current code.

vibematrix git

Logs your mood automatically with your latest commit message — coding + emotions = art 🎨

🧠 Troubleshooting

If you get an error like:

“The term 'node.exe' is not recognized…”

✅ Fix:

1. Make sure Node.js is installed — run node -v
2. Restart VS Code or your terminal
3. Add C:\Program Files\nodejs\ to your PATH
4. Try using Command Prompt instead of PowerShell

💡 Tips

• Works instantly — no setup, no config files
• Add your own custom quotes in lib/quotes.js
• Perfect for adding fun to terminal sessions
• You can even pair it with a cron job or task scheduler to auto-check your mood daily! (Requires external setup)

🤝 Contributing

Contributions are welcome! Here's how you can contribute:

1. Fork the repository
2. Create a new branch for your feature or bug fix
3. Commit your changes
4. Push your branch to your fork
5. Create a pull request

🪪 License

MIT License © 2025 Mayank Kumar Vyas

🧑‍💻 Author

Mayank Kumar Vyas Full Stack Developer | 3D Web Designer | Cloud Architect 📧 [email protected]

🔗 Important Links

• Repository: https://github.com/Mayankvya/VibeMatrix

📝 Footer

Made with ❤️ by Mayank Kumar Vyas. Check out VibeMatrix on GitHub. Fork it, star it, raise issues - let's vibe together! 💫