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 /SKILL.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 'SKILL.md')
| -rw-r--r-- | SKILL.md | 73 |
1 files changed, 73 insertions, 0 deletions
diff --git a/SKILL.md b/SKILL.md new file mode 100644 index 0000000..c4acb87 --- /dev/null +++ b/SKILL.md @@ -0,0 +1,73 @@ +--- +name: iphone-icloud-notes +description: >- + Create real Apple Notes on the user's iPhone by driving icloud.com/notes from + Linux (Playwright + saved Apple ID session). Use when the user asks to create + a note, send/forward results to their iPhone, push text to Apple Notes, or + mentions icloud.com/notes / iCloud Notes from Linux. +--- + +# iPhone notes via icloud.com/notes + +## Goal + +When asked to create a note or forward prompt results to the iPhone, **create a +real Apple Note** through the iCloud Notes web app. Do not use LocalSend for this +unless the user explicitly wants file transfer instead of Notes. + +## Source of truth + +Repo: `~/Code/iphone-notes` +Linked as: `~/.agents/skills/iphone-icloud-notes` → that repo + +## Helper + +```bash +icloud-note status +icloud-note login # one-time / when session expired (headed browser) +icloud-note create --title "Title" --body "Body text" +icloud-note create --title "Title" --body-file /path/to.txt +icloud-note create --title "Title" --body-file - # stdin +``` + +If `icloud-note` is missing from PATH: + +```bash +node "$HOME/Code/iphone-notes/scripts/icloud-note.mjs" … +``` + +Config / session (XDG): `~/.config/icloud-notes/` +Browser profile: `~/.config/icloud-notes/browser-profile/` +(Do not commit the browser profile or Apple credentials.) + +## Agent workflow + +1. **Prepare content** — title (short) + body (full text to send). +2. **`icloud-note status`** — if not logged in, tell the user to run + `icloud-note login` once (Apple ID + 2FA in a browser window), then retry. + Do not invent note creation; do not claim success without a successful create. +3. **Create** — write body to a temp file if long, then: + + ```bash + icloud-note create --title "$TITLE" --body-file "$TMPFILE" + ``` + +4. **Report** — quote the script’s success line (title). Note syncs to iPhone + Notes when iCloud Notes is enabled on the device. + +## Rules + +- Prefer this skill over LocalSend / email for “send a note to my iPhone.” +- Never store Apple ID passwords in the skill, repo, or chat logs. +- Session cookies live only under `~/.config/icloud-notes/browser-profile/` (mode keep private). +- First-line-as-title matches Apple Notes; the helper already formats title + body. + +## Setup (human / once) + +```bash +"$HOME/Code/iphone-notes/scripts/setup.sh" +icloud-note login +``` + +Requires a graphical session for `login` (DISPLAY/Wayland). After that, `create` +can run headed or headless using the saved profile. |
