Project Structure

See CLAUDE.md for the full annotated file tree, key types, naming conventions, and notes for AI assistants.

Python source files (root level)

File	Purpose
`__init__.py`	Public API exports, `__version__`
`tea.py`	`Program` class, event loop, terminal setup
`model.py`	`Model` abstract base class
`messages.py`	All message types (`KeyMsg`, `MouseMsg`, `ClearScreenMsg`, etc.)
`keys.py`	Key parsing, `KeyType` enum
`mouse.py`	Mouse event parsing, `MouseButton`, `MouseAction`
`commands.py`	`Cmd`, `BatchMsg`, `SequenceMsg`, `batch()`, `sequence()`, `tick()`, `every()`, `window_size()`
`renderer.py`	FPS-capped, thread-safe `Renderer` and `NullRenderer`
`screen.py`	Screen control command factories (`enter_alt_screen`, `suspend`, etc.)
`exec.py`	`ExecCmd`, `exec_process()` — run external processes with terminal handoff
`log.py`	`log_to_file()` — attach a file handler to the root logger for TUI-safe debugging

File	Purpose
`README.md`	Project overview — describes the vibe-coding experiment
`MVP_TASKS.md`	Tracked task list: Go→Python feature parity gaps (all items complete)
`MVP_TEST_PLAN.md`	Manual + automated test plan for MVP sign-off
`PYTHON_FEASIBILITY.md`	Analysis of Go features that are hard/infeasible in Python
`CLAUDE.md`	Detailed guide for AI assistants working in this repo
`Contributing.md`	Developer workflow and contribution notes
`CHANGELOG.md`	Version history for the Python port
`ATTRIBUTION.md`	Credits — original Charm team, Elm Architecture, AI tooling