🐛 hyper-termibug

Bugs are invading your terminal! A fun and chaotic Hyper.js plugin that spawns pixel-art bugs in your terminal at random intervals. Squash them before they eat your text!

✨ Features

• 🪲 Pixel art bugs — Animated 16×16 sprite bugs crawling around your terminal
• 🖱️ Click to squash — Click on a bug to kill it instantly
• ⌨️ Space combo — Press space 5 times within 2 seconds to squash the nearest bug
• 🍽️ They eat your text! — After a configurable delay, bugs start consuming characters in your terminal
• 📊 Score HUD — Track active bugs, kills, and your score in a sleek overlay (toggleable)
• 🎮 Multi-bug chaos — Multiple bugs can appear simultaneously
• ⏸️ Pause/Resume — Press Ctrl+Shift+B to toggle the game on/off at any time
• ⚙️ Fully configurable — Customize spawn rates, eat delay, speed, size, HUD visibility, and more

📦 Installation

From npm (when published)

hyper i hyper-termibug

Local development

1. Clone or copy this directory to ~/.hyper_plugins/local/hyper-termibug/

   Or create a symlink:

   ln -s /path/to/termibug ~/.hyper_plugins/local/hyper-termibug

2. Add to your ~/.hyper.js:

module.exports = {
  localPlugins: ['hyper-termibug'],
  // ...
};

3. Restart Hyper (or press Ctrl+Shift+R / Cmd+Shift+R)

⚙️ Configuration

Add a termibug section to your ~/.hyper.js config:

module.exports = {
  config: {
    // ... other config
    termibug: {
      enabled: true,           // Enable/disable the plugin entirely
      showHUD: true,           // Show/hide the score panel in the top-right corner
      spawnIntervalMin: 15000, // Minimum time between bug spawns (ms)
      spawnIntervalMax: 45000, // Maximum time between bug spawns (ms)
      maxBugs: 10,             // Maximum simultaneous bugs
      eatDelay: 5000,          // Time before a bug starts eating characters (ms)
      bugSpeed: 1,             // Bug movement speed multiplier
      bugSize: 1,              // Bug visual size multiplier
    }
  }
};

Configuration Reference

Option	Type	Default	Description
enabled	boolean	true	Master switch — set to false to disable the plugin completely
showHUD	boolean	true	Show/hide the score panel (🐛 active │ 💀 killed │ 🏆 score)
spawnIntervalMin	number	15000	Minimum delay before next bug spawns (milliseconds)
spawnIntervalMax	number	45000	Maximum delay before next bug spawns (milliseconds)
maxBugs	number	10	Maximum number of bugs alive simultaneously
eatDelay	number	5000	How long a bug wanders before it starts eating text (milliseconds)
bugSpeed	number	1	Movement speed multiplier (2 = twice as fast)
bugSize	number	1	Visual size multiplier (2 = twice as large)

⌨️ Keyboard Shortcuts

Shortcut	Action
Ctrl+Shift+B	Toggle the game on/off (pause/resume)
Space × 5	Press space 5 times within 2 seconds to squash the nearest bug

When the game is paused, a notification appears in the top-right corner showing the shortcut to resume.

🎮 How to Play

1. Wait — Bugs will appear from the edges of your terminal at random intervals
2. Squash by clicking — Simply click on a bug to kill it
3. Squash by keyboard — Press Space 5 times quickly (within 2 seconds) to kill the nearest bug to your cursor
4. Don't let them eat! — After the eat delay (default: 5 seconds), a bug's eyes turn red and it starts eating characters from your terminal
5. Score — Earn 100 points per kill, lose 10 points per eaten character
6. Pause — Press Ctrl+Shift+B to pause if you need a break

🏗️ Architecture

hyper-termibug/
├── index.js              # Hyper plugin hooks (decorateTerm, middleware)
├── package.json          # npm package config (zero dependencies)
├── README.md
└── lib/
    ├── Bug.js            # Single bug entity (movement, eating, state)
    ├── BugManager.js     # Bug spawning, killing, pause/resume, stats
    ├── BugRenderer.js    # Canvas pixel-art rendering engine
    ├── HUD.js            # Score overlay + toggle notifications
    └── SpriteData.js     # Pixel art sprite definitions (walk, eat, death)

🐞 Debugging

Open Hyper DevTools with Ctrl+Shift+I and check the Console tab for messages prefixed with [termibug]:

[termibug] Found terminal container: DIV xterm
[termibug] Canvas appended. Container size: 800 x 400
[termibug] Plugin initialized! Toggle with Ctrl+Shift+B

🤝 Contributing

PRs welcome! Some ideas for improvements:

• Sound effects on squash
• Different bug species with unique behaviors
• Boss bugs that require more hits
• Leaderboard
• Bug trails / slime effects

📄 License

MIT