---
id: t9
title: Script to run the local server for testing
status: Done
created: 2026-10-24
updated: 2026-10-24T23:25:51Z
order: 0
report: |
  (agent) New: python3 tools/serve.py builds the game, serves it at http://localhost:8000 and
  rebuilds by itself when anything in src/ changes. Pages aren't cached, so a normal refresh
  shows the new build. If 8000 is taken (an old server still running), it uses 8001 and says so.
  To check: stop your old server (Ctrl+C), run python3 tools/serve.py, open the address it
  prints, change something in src/, refresh. Ctrl+C stops it.
---

## Context

- i need a script to run the local server for testing.

## Subtasks

- [x] Add the server and update the command references and map.
- [x] Check serving, rebuilds, port fallback and shutdown; run the headless suites.