Skip to content

shikhr/clawdash

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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!

Clawdash Demo

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! 🚀

About

Play clawdash instead of getting bored while Claude does the work!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors