demo-1-terminal-arcade

Build a playable, colorful game of Snake that runs in the terminal, as a single self-contained Python file .decode/outputs/snake.py (unless the human named a different path).

Constraints

• Pure standard library only — use the built-in curses module for rendering and input. Add zero third-party dependencies (nothing that would need uv add or pip install).
• Keep it small and readable: roughly 250 lines. This is a demo people will read, not just play.

Plan first

Before writing any code, lay out your steps with todo_write (draw field → snake movement → food and growth → color + HUD → game over → smoke checks) and tick them off as you go.

Gameplay to implement

• A bordered play field drawn with curses.
• A snake that moves continuously and is steered with W, A, S, D (arrow keys as a fallback).
• q (or Q) and ESC quit the game at any moment.
• Food that spawns at a random empty cell; eating it grows the snake and increases the score.
• Game over when the snake hits a wall or itself; show a centered "GAME OVER — score N" screen and wait for a keypress to exit.
• Restore the terminal cleanly on exit (use curses.wrapper so a crash never leaves the terminal garbled).

Make it flashy

• Color (guard with curses.has_colors()): green snake, red food, yellow score bar, white borders — set up curses.init_pair pairs once at start and fall back to plain text when colors are unsupported.
• Score HUD: a top status line like SCORE 7 · SPEED 3 that updates live.
• Speed ramp: every 3 pieces of food eaten, shorten the tick timeout a little so the game gets faster — cap it so it stays playable.
• Eat animation: a short, non-blocking flourish when the snake eats food — e.g. flash the snake's head or pulse the score in the HUD for a few ticks. It must not pause the game loop.
• Death animation: on game over, a brief sequence before the "GAME OVER" screen — e.g. flash the snake a few times or make it disintegrate tail-to-head. Keep it under ~a second so quitting never feels sluggish.