summaryrefslogtreecommitdiff
path: root/SKILL.md
diff options
context:
space:
mode:
authorChristopher Warner <cwarner@kernelcode.com>2026-10-10 18:47:24 -0400
committerChristopher Warner <cwarner@kernelcode.com>2026-10-10 18:47:24 -0400
commit5c61196f27b9342e5f25414c11df5710f956f406 (patch)
treec81f15f54c9baa35f61ce3c71b81f1c1e7b5f590 /SKILL.md
parent78862ba855c6e66cac64a86c25dca6149d8fb2fd (diff)
downloadiphone-notes-5c61196f27b9342e5f25414c11df5710f956f406.tar.gz
iphone-notes-5c61196f27b9342e5f25414c11df5710f956f406.tar.bz2
iphone-notes-5c61196f27b9342e5f25414c11df5710f956f406.tar.xz
iphone-notes-5c61196f27b9342e5f25414c11df5710f956f406.zip
feat!: rewrite icloud-note CLI in Rust with chromiumoxide
Replace the Node/Playwright driver with a single Rust binary so create/status stay headless without a visible browser. Move the previous implementation to legacy/nodejs for reference. BREAKING CHANGE: the supported CLI is the Rust `icloud-note` binary; the Node entrypoint is no longer installed by setup.sh. Co-authored-by: Cursor <cursoragent@cursor.com>
Diffstat (limited to 'SKILL.md')
-rw-r--r--SKILL.md59
1 files changed, 21 insertions, 38 deletions
diff --git a/SKILL.md b/SKILL.md
index c78f067..e83bf47 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -2,23 +2,24 @@
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.
+ Linux with the Rust icloud-note CLI (headless Chromium). 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
+# iPhone notes via icloud.com/notes (Rust)
## 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.
+real Apple Note** through the iCloud Notes web app using the **Rust**
+`icloud-note` binary. Do not use LocalSend unless the user wants file transfer.
## Source of truth
Repo: `~/Code/iphone-notes`
-Linked as: `~/.agents/skills/iphone-icloud-notes` → that repo
+Binary: `~/.local/bin/icloud-note` (from `cargo build --release`)
+Skill link: `~/.agents/skills/iphone-icloud-notes` → that repo
## Helper
@@ -30,42 +31,24 @@ 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:
+If missing from PATH:
```bash
-node "$HOME/Code/iphone-notes/scripts/icloud-note.mjs" …
+"$HOME/Code/iphone-notes/target/release/icloud-note" …
+# or: cargo run --manifest-path "$HOME/Code/iphone-notes/Cargo.toml" -- …
```
-Config / session (XDG): `~/.config/icloud-notes/`
-Browser profile: `~/.config/icloud-notes/browser-profile/`
-(Do not commit the browser profile or Apple credentials.)
-
-## Agent workflow
+`create` / `status` are **always headless**. Never run `login` unless the user
+must re-authenticate. Do **not** set `ICLOUD_NOTES_DRY_RUN=1` for real sends.
-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:
+Config: `~/.config/icloud-notes/` (browser profile; private)
- ```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
+## Agent workflow
-- 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.
+1. Prepare title + body.
+2. `icloud-note status` — if not logged in, ask the user to run `icloud-note login`.
+3. `icloud-note create --title "$TITLE" --body-file "$TMPFILE"`
+4. Report the `created:` line. Syncs to iPhone when iCloud Notes is enabled.
## Setup (human / once)
@@ -74,5 +57,5 @@ Browser profile: `~/.config/icloud-notes/browser-profile/`
icloud-note login
```
-Requires a graphical session for `login` only. After that, `create` / `status`
-use `~/.config/icloud-notes/storage-state.json` headlessly — no window.
+Requires Rust (`cargo`) and a Chromium binary (setup can install Playwright’s
+Chromium under `~/.cache/ms-playwright`).