jsnake 0.2.0

A clean, arcade-style Snake game for the terminal with level-based progression.

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