pitodo/README.md

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.

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.