todo-app/README.md
Krzysztof kuhy Rudnicki 1f7c31357b
Some checks failed
dependency freshness / dependencies on newest stable (push) Has been cancelled
file-length / file length <= 250 lines (push) Has been cancelled
md-naming / markdown naming convention (push) Has been cancelled
release-apk / release (APK) (push) Has been cancelled
repo-contract / repo contract (push) Has been cancelled
Point at android_ui for phone UI driving
Tap and type by label via ~/src/testsAndMisc's android_ui CLI or its MCP server, instead of coordinates. No code copied.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 08:46:39 +01:00

55 lines
2.0 KiB
Markdown

# todo
A new Flutter project.
## Getting Started
This project is a starting point for a Flutter application.
A few resources to get you started if this is your first Flutter project:
- [Learn Flutter](https://docs.flutter.dev/get-started/learn-flutter)
- [Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
- [Flutter learning resources](https://docs.flutter.dev/reference/learning-resources)
For help getting started with Flutter development, view the
[online documentation](https://docs.flutter.dev/), which offers tutorials,
samples, guidance on mobile development, and a full API reference.
## Headless note CLI
`bin/todo_note.dart` adds, lists, reads and deletes notes from the PC without
the app, as one more sync node (own `node_id` and CRDT log under
`$XDG_DATA_HOME/todo-cli`, or `~/.local/share/todo-cli`). It needs the desktop
Firebase session at `~/.config/todo/firebase_auth.json` (seed it with
`python3 ~/src/utils/crdt-sync/tool/seed_session.py --app todo`).
```sh
dart run bin/todo_note.dart --text "Title
body" --priority high --status in_progress # prints the new note id
echo "Title" | dart run bin/todo_note.dart # text from stdin
dart run bin/todo_note.dart --list # id, priority, status, title
dart run bin/todo_note.dart --get <id> # full note
dart run bin/todo_note.dart --delete <id>
```
`--list` and `--get` never push; `--data-dir <dir>` selects a throwaway node.
Exit codes: 0 ok, 1 sync/auth failure or note not found, 2 bad arguments.
All logic is in `lib/cli/` (tested in `test/cli/`); `--help` lists every flag.
## Driving the app on the phone
Tap and type by label, never by coordinate, with `android_ui` from
`~/src/testsAndMisc` (not copied here):
```bash
cd ~/src/testsAndMisc && .venv/bin/python -m python_pkg.android_ui \
-s 23181JEGR08034 --display self dump
```
The same driver is the `android-ui` MCP server
(`.venv/bin/python -m python_pkg.android_ui.mcp_server`, in that repo's
`.mcp.json`). Tools and error contract:
`~/src/testsAndMisc/python_pkg/android_ui/README.md`.