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
|
---
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 Apple Notes–shaped Markdown: `##` headings, `*` for bullets, `-` for
dashed lists, `- [ ]` checklists, `---` dividers, `>` quotes, short paragraphs.
The CLI reformats to Notes style (title, Heading/Subheading, • / – / ☐ / ☑).
See Apple: https://support.apple.com/guide/iphone/create-and-format-notes-iph1ac0b3a2/ios
4. Report the `created:` or `updated:` line.
## Setup (human / once)
```bash
"$HOME/Code/iphone-notes/scripts/setup.sh"
icloud-note login
```
|