🤣 Joking Terminal

Joking Terminal is a modern, stylish Node.js command-line interface (CLI) tool that delivers jokes straight to your terminal. Features colorful banners, animated spinners, category filtering, offline mode, interactive punchline reveals, and multi-joke output!

Powered by the Official Joke API with built-in offline fallback.

✨ Features

• 🎨 Beautiful UI: Vibrant colors, ASCII banners, and boxed joke cards.
• ⏱️ Interactive Punchlines: Pause on setup; press [Enter] or wait 3 seconds to reveal punchline.
• 📴 Offline Joke Bank: Built-in bank of 30+ jokes. Use -o or let it auto-fallback when offline.
• ⏳ Loading Spinner: Visual feedback while fetching jokes.
• 📦 Categories: Filter jokes by category (programming, general, knock-knock).
• 🔢 Multi-Joke Fetching: Request multiple jokes in a single command (--count).

🚀 Installation

Run joking-terminal directly using npx or install it globally:

# Run directly without installing
npx joking-terminal

# Or install globally
npm install -g joking-terminal

Once installed globally, run the joke command in your terminal:

joke

📖 Usage & Options

joke [options]

Options

| Option | Description | Example | |---|---|---| | -c, --category <type> | Choose joke category (programming, general, knock-knock) | joke -c programming | | -o, --offline | Force using built-in offline joke bank | joke -o | | -n, --count <number> | Fetch multiple jokes at once (max 10) | joke -n 3 | | -V, --version | Output current version | joke -V | | -h, --help | Display help text | joke -h |

💡 Examples

Fetch a single random joke:

joke

Fetch an offline programming joke:

joke -o -c programming

Fetch 3 random jokes:

joke -n 3

Fetch 5 general jokes offline:

joke -o -c general -n 5

📄 License

ISC © k10_here