summaryrefslogtreecommitdiff
path: root/SKILL.md
blob: c78f06791c9732c9215d9161339772e7d11892e4 (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
77
78
---
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.

Do **not** set `ICLOUD_NOTES_DRY_RUN=1` for real sends (tests only).

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.