# astro-snake

Play **Astro Snake** inside pi.

```
/snake
```

Ships as part of [`@astrofoundry/pi-astro`](../../README.md). No extra install.

## What it is

A small, theme-aware Snake game rendered in pi's overlay UI. Always starts a fresh game — no saves, no resume, no high scores, no out-of-session state.

## Controls

| Key | Action |
|---|---|
| `↑ ↓ ← →` or `W A S D` | Steer |
| Press any direction key on launch | Starts the game |
| `Q` or `Esc` | Quit |
| `R` or `Space` (after game over / win) | Play again |

The first directional key launches the snake — until then the game waits, so you don't lose 2 seconds before you've focused the terminal.

## Features

- **Speed ramps with score** — tick interval shrinks linearly from 100 ms down to 40 ms by the time you reach 120 points (12 food).
- **Theme-aware colours** — uses your active pi theme: `success` for the snake, `accent` for the food and title, `error` for the game-over banner, `warning`/`muted`/`dim` for messages and chrome. No hardcoded ANSI.
- **Astro branding** — `★ ASTRO SNAKE ★` title, `✦` sparkle food, `Stardust` score label.
- **Win condition** — fill the entire 40×15 board (yes, it's possible) and the game ends with `Board cleared!`.
- **Wait-to-launch** — game starts paused, first arrow key sends the snake.

## Notes

State lives entirely in memory for the duration of the game; nothing is persisted.