From ef0165cc6cbe001997e5d05af5de6d4849481d7a Mon Sep 17 00:00:00 2001 From: Christopher Warner Date: Sat, 10 Oct 2026 18:28:43 -0400 Subject: feat: add icloud.com/notes helper and agent skill Send real Apple Notes from Linux via a Playwright session so agents can forward results to an iPhone without LocalSend. Co-authored-by: Cursor --- README.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..b90b8f0 --- /dev/null +++ b/README.md @@ -0,0 +1,52 @@ +# iphone-notes + +Create real **Apple Notes** on an iPhone from Linux by driving +[icloud.com/notes](https://www.icloud.com/notes/) with Playwright and a saved +Apple ID browser session. + +Also packaged as a Cursor/Goose agent skill (`SKILL.md`) so agents can forward +prompt results to your phone as Notes. + +## Quick start + +```bash +./scripts/setup.sh +icloud-note login # Apple ID + 2FA once (graphical session) +icloud-note create --title "Hello" --body "From Linux" +``` + +## CLI + +| Command | Purpose | +|---|---| +| `icloud-note setup` | Install Playwright Chromium + `~/.local/bin` wrapper | +| `icloud-note login` | Headed sign-in; saves session under `~/.config/icloud-notes/` | +| `icloud-note status` | Check whether the saved session can open Notes | +| `icloud-note create` | Create a note (`--title`, `--body` / `--body-file`) | + +## Layout + +```text +SKILL.md Agent instructions +scripts/icloud-note.mjs CLI +scripts/setup.sh One-time install + skill symlinks +tests/cli.test.sh Smoke tests (no Apple network required) +``` + +Runtime config (not in git): + +```text +~/.config/icloud-notes/ + browser-profile/ Playwright persistent profile (private) + node_modules/ Playwright install +``` + +## Tests + +```bash +./tests/cli.test.sh +``` + +## License + +MIT -- cgit v1.2.3