app frame + storage

2026-11-04 16:33:26 +01:00
commit 21694908a3
16 changed files with 1198 additions and 0 deletions
@@ -0,0 +1,15 @@
+# TodoApp
+
+A terminal app for inspecting Pi project todos. The Bubble Tea UI currently shows the selected project's `.pi/todos` directory and a file count; browsing and editing in the UI are planned in later tickets. The `internal/todos` storage package already reads and writes Pi-compatible Markdown files, using `.lock` files and atomic replacements for edits.
+
+## Run
+
+Requires Go 1.24 or newer and a terminal.
+
+```bash
+go run .                         # inspect the current project
+go run . --project /path/to/repo # inspect another project
+go test ./...
+```
+
+If `.pi/todos` does not exist, the app shows an empty state without creating files. If the project path is invalid or the todo directory cannot be read, it exits with an error. Press `q` or `Ctrl+C` to exit the TUI.