blob: 403e43f7cf704285c02827a10116d0a7edbd7a7e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
---
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 only — only command that opens a window
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
```
`create` / `status` are **always headless** (no visible browser). Never pass flags
to force a window. Never run `login` unless the user must re-authenticate.
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` only. After that, `create` / `status`
use `~/.config/icloud-notes/storage-state.json` headlessly — no window.
|