Skip to content

LEO20Debugger/byte-me

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

122 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

byte-me ๐Ÿš€

CI npm version npm downloads license

byte-me is a fun, interactive CLI for developers that delivers random geeky messages, coding jokes, and motivational quotes directly in your terminal. ๐Ÿ˜Ž It also provides playful error hints for uncaught exceptions, unhandled rejections, and runtime warnings โ€” perfect for keeping your terminal lively while coding. ๐Ÿ’ปโœจ


Features โœจ

  • ๐ŸŽฏ Random coding messages, jokes, and inspiration.
  • ๐Ÿ› ๏ธ Playful error hints for uncaught exceptions, unhandled rejections, and warnings.
  • ๐ŸŒˆ Bold, colorized output with an optional rainbow animation mode.
  • โฑ๏ธ Schedule messages with a cron-like syntax.
  • โšก Works in any Node.js project, from CLI tools to backend services.

Installation ๐Ÿ“ฆ

Install globally via npm:

npm install -g @brainergybyleo/byte-me

Usage ๐Ÿ’ป

# Start the scheduler (a message every 30 minutes)
byte-me

# Show one message and exit
byte-me --once        # -o

# Enable rainbow animated messages
byte-me --rainbow     # -r

# Run in test mode (a message every 5 seconds)
byte-me --test        # -t

# Show desktop/system notifications
byte-me --notify      # -n

# Show the banner plus an instant message
byte-me start

Hidden Games ๐ŸŽฎ

byte-me ships with a few interactive terminal games โ€” run any of them by name:

byte-me dungeon       # ๐Ÿฐ Explore an ASCII dungeon adventure
byte-me hack          # ๐Ÿ•น๏ธ  Launch a "secret hack" mini-game
byte-me adventure     # ๐ŸŒฒ Play a 10-level ASCII adventure
byte-me rps           # โœŠ Play Rock-Paper-Scissors against the terminal

Running locally from the repo (without a global install)? Use node dist/bin/cli.js <command>, e.g. node dist/bin/cli.js dungeon.


Configuration โš™๏ธ

Settings are customizable via a .byteme.json file in your project directory:

{
  "theme": "rainbow",
  "showBanner": true,
  "dailyTip": false
}
Option Values Description
theme "plain", "rainbow", "pastel" rainbow/pastel show colorful animated messages; plain cycles preset colors.
showBanner true / false Display an ASCII-art banner on start.
dailyTip true / false Show a random motivational tip once per day.

Support / Contact ๐Ÿ“ง

Need help or want to share feedback? Open an issue or PR on GitHub. ๐Ÿ› ๏ธ


License

MIT ยฉ Leonard Oba

About

A quirky CLI that spices up your terminal with geeky messages, coding humor, and error hints. Perfect for devs who like a little fun! ๐Ÿ˜

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors