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

2.0 KiB

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:

For help getting started with Flutter development, view the online documentation, 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).

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):

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.