--- name: iphone-icloud-notes description: >- Create or update real Apple Notes on the user's iPhone by driving icloud.com/notes from Linux with the Rust icloud-note CLI (headless Chromium). Use when the user asks to create/update 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 (Rust) ## Goal Drive real Apple Notes through the iCloud Notes web app using the **Rust** `icloud-note` binary. Do not use LocalSend unless the user wants file transfer. ## Create vs update (important) | User intent | Command | |---|---| | New note / first send | `icloud-note create …` | | Change / revise / refresh an existing note | `icloud-note update …` | **Never use `create` when the user asks to update** — that would add a duplicate note. `update` finds the note by title (case-insensitive) and replaces its content in place. If no matching note exists, report the error; do not fall back to `create` unless the user explicitly asks to create. ## Source of truth Repo: `~/Code/iphone-notes` Binary: `~/.local/bin/icloud-note` Skill link: `~/.agents/skills/iphone-icloud-notes` → that repo ## Helper ```bash icloud-note status icloud-note login # ONE-TIME only — only command that opens a window icloud-note create --title "Title" --body "Body text" icloud-note update --title "Title" --body "Revised body" icloud-note update --title "Title" --body-file /path/to.txt # optional: search under a different title than the new first line icloud-note update --match-title "Old Title" --title "New Title" --body "…" ``` `create` / `update` / `status` are **always headless**. Never run `login` unless re-auth is required. Do **not** set `ICLOUD_NOTES_DRY_RUN=1` for real sends. Config/session: `~/.config/icloud-notes/` (cookies / Chromium profile). **Private — never commit, paste into chat, or upload.** See `SECURITY.md`. ## Agent workflow 1. Decide **create** vs **update** from the user’s wording. 2. `icloud-note status` — if not logged in, ask for `icloud-note login`. 3. Run create or update with `--title` + `--body-file` for long text. Prefer clean Markdown (headings, lists, checklists, short paragraphs); the CLI reformats it to Apple Notes style (title, spacing, • lists, ☐/☑). 4. Report the `created:` or `updated:` line. ## Setup (human / once) ```bash "$HOME/Code/iphone-notes/scripts/setup.sh" icloud-note login ```