# iphone-notes Create real **Apple Notes** on an iPhone from Linux by driving [icloud.com/notes](https://www.icloud.com/notes/) with Playwright and a saved Apple ID browser session. Also packaged as a Cursor/Goose agent skill (`SKILL.md`) so agents can forward prompt results to your phone as Notes. ## Quick start ```bash ./scripts/setup.sh icloud-note login # Apple ID + 2FA once (graphical session) icloud-note create --title "Hello" --body "From Linux" ``` ## CLI | Command | Purpose | |---|---| | `icloud-note setup` | Install Playwright Chromium + `~/.local/bin` wrapper | | `icloud-note login` | **Only** command that opens a visible browser (one-time Apple ID) | | `icloud-note status` | Headless check that the saved session can open Notes | | `icloud-note create` | Headless create (`--title`, `--body` / `--body-file`) — no window | ## Layout ```text SKILL.md Agent instructions scripts/icloud-note.mjs CLI scripts/setup.sh One-time install + skill symlinks tests/cli.test.sh Smoke tests (no Apple network required) ``` Runtime config (not in git): ```text ~/.config/icloud-notes/ storage-state.json Cookies/session for headless create (private) browser-profile/ Used only during `login` (private) node_modules/ Playwright install ``` ## Tests ```bash npm test # or ./tests/run.sh ``` Covers: - Pure helpers (`tests/helpers.test.mjs`) — note formatting, auth heuristics, argv, Conventional Commits subjects - CLI dry-run (`tests/cli.test.sh`) — help, create/status/login without a browser (`ICLOUD_NOTES_DRY_RUN=1`) - Git history (`tests/conventional-commits.test.sh`) — every commit subject matches Conventional Commits 1.0.0 Live Apple create/status (real headless Chromium) is manual after `icloud-note login`. ## License MIT