first commit

README.md

@@ -0,0 +1,33 @@
+# Python TUI Checklist
+
+A minimal terminal checklist app with no dependencies — just the Python standard library.
+
+## Usage
+
+Run with the built-in sample tasks:
+
+```bash
+python checklist.py
+```
+
+Or pass your own items as arguments:
+
+```bash
+python checklist.py "Task one" "Task two" "Task three"
+```
+
+## Controls
+
+| Key | Action |
+|-----|--------|
+| `↑` / `↓` | Move cursor |
+| `Space` | Toggle checkbox |
+| `+` or `i` | Add a new task |
+| `A` | Check all |
+| `N` | Uncheck all |
+| `q` | Quit and show final state |
+
+## Requirements
+
+- Python 3.6+
+- No third-party packages — works out of the box on Windows, macOS, and Linux