diff options
| author | Christopher Warner <cwarner@kernelcode.com> | 2026-10-10 18:28:43 -0400 |
|---|---|---|
| committer | Christopher Warner <cwarner@kernelcode.com> | 2026-10-10 18:28:43 -0400 |
| commit | ef0165cc6cbe001997e5d05af5de6d4849481d7a (patch) | |
| tree | 98b10c875c012a6b18160f8897f444aceff60790 /README.md | |
| download | iphone-notes-ef0165cc6cbe001997e5d05af5de6d4849481d7a.tar.gz iphone-notes-ef0165cc6cbe001997e5d05af5de6d4849481d7a.tar.bz2 iphone-notes-ef0165cc6cbe001997e5d05af5de6d4849481d7a.tar.xz iphone-notes-ef0165cc6cbe001997e5d05af5de6d4849481d7a.zip | |
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 <cursoragent@cursor.com>
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 52 |
1 files changed, 52 insertions, 0 deletions
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 |
