Skip to content

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

JSNAKE

A clean, arcade-style Snake game for the terminal. Built with Python and Textual, featuring level-based progression and persistent high scores.

Installation

pip install jsnake
jsnake

Or using uv (recommended):

uv tool install jsnake
jsnake

Using uv tool install or pipx install ensures the jsnake command is always available globally without PATH issues.

Alternative — run without installing:

uvx jsnake

Controls

Key Action
W / ↑ Move up
A / ← Move left
S / ↓ Move down
D / → Move right
P Pause / Resume
R Restart
Q Quit

Features

  • Level-based speed progression (every 50 points)
  • Persistent high score (saved to ~/.jsnake/scores.json)
  • Square aspect-ratio grid rendering
  • Neon arcade aesthetic

Development

# Clone and set up
git clone https://github.com/Jithi/jsnake.git
cd jsnake

# Install with dev dependencies using uv
uv sync --extra dev

# Run locally
uv run jsnake

# Run tests
uv run pytest

# Lint
uv run ruff check src/ tests/

# Type check
uv run mypy src/

Building & Publishing

uv run python -m build
uv run twine upload dist/*

License

MIT

About

Snake game for the terminal

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages