summaryrefslogtreecommitdiff
path: root/SKILL.md
blob: b642bfbc5d74468672064ca0c211fea7a1f9749e (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
---
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
```