Clawdash 🎮

A fun terminal runner game featuring Claw'd (Claude's mascot) - Chrome Dino style endless runner in your terminal! Help Claw'd escape programming bugs and errors!

Features

• 🏃 Classic endless runner game mechanics with Claw'd
• 🐛 Programming-themed obstacles (TypeError, null, StackOverflow, and more!)
• 🎯 Increasing difficulty as you play
• 📊 Score tracking with bug death messages
• 🎨 Colorful ASCII art graphics
• 🌥️ Animated clouds with varied patterns
• 👁️ Eye blinking animation
• 🦶 3-frame running animation
• ⌨️ Simple keyboard controls
• 🚀 Smooth 60 FPS gameplay
• 🎨 Optional full-color mode with backgrounds

Installation

Prerequisites

• Node.js 18 or higher
• A terminal emulator with 256-color support

Install via NPM

npm install -g clawdash

Manual Installation

git clone https://github.com/yourusername/clawdash.git
cd clawdash
npm install
npm link

Usage

Run Clawdash from anywhere in your terminal:

clawdash

Or using npm:

npm start

Full-Color Mode

For an enhanced visual experience with colored backgrounds:

clawdash --full-color

or

npm start -- --full-color

This enables:

• Blue sky background
• Yellow/gold ground background
• Better visual contrast

Controls

• SPACE - Jump over obstacles
• R - Restart game (after game over)
• Q - Quit game
• Ctrl+C - Force quit

Gameplay

• Help Claw'd escape programming bugs and errors!
• Jump over obstacles like TypeError, null, StackOverflow, segfault, and more
• Your score increases based on distance traveled
• The game gets faster as your score increases
• When you crash, you'll see which bug caught you
• Try to beat your high score!

Development

Project Structure

clawdash/
├── bin/
│   └── clawdash.js          # CLI entry point
├── src/
│   ├── game.js              # Core game engine
│   └── index.js             # Game runner with input handling
└── package.json

Running Locally

npm start

Game Features

• Smooth Physics: Realistic jump arc with sine wave animation
• Animated Character: 3-frame running animation and natural eye blinking
• Layered Graphics:
  • Sky layer with animated clouds (3 cloud patterns)
  • Ground layer with obstacle blocks
  • Optional colored backgrounds with --full-color flag
• Dynamic Obstacles: Randomly generated blocks with variable heights
• Progressive Difficulty: Speed increases every 20 seconds

Contributing

Contributions welcome! Ideas:

• New obstacle types
• Power-ups
• Different character sprites
• Sound effects (terminal beep)
• Leaderboard system
• Themes/skins
• Two-player mode

License

MIT

Credits

Inspired by Chrome's offline dino game.

Claw'd is the mascot of Claude by Anthropic.

Have fun and happy gaming! 🚀