summaryrefslogtreecommitdiff
path: root/SKILL.md
diff options
context:
space:
mode:
Diffstat (limited to 'SKILL.md')
-rw-r--r--SKILL.md73
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.