--- 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.