Apple Desk

Apple Desk is Mac-local CLIs only. Run every command on the user's registered Mac (machineId). Never on the cloud box. Never on a phone.

Messages send rule: always draft recipient + exact text and wait for an explicit yes before any real send. Use 1:1 participant send only unless the user names a group. Dry-run without --force; real send needs --force and --confirm.

A real Messages send claims success only after a read-only chat.db check sees a new outgoing row; otherwise treat as send_unconfirmed.

On automation_timeout (exit 4) with no Allow dialog: quit Messages, reopen once, retry that same command once. Do not start a long dig first. --unstick-once is opt-in and retries once only.

grok-messages can report send_unconfirmed falsely because new rows store text only in attributedBody (text column null); before any retry, check chat.db read-only for an outgoing row with is_sent=1 and decode attributedBody, and never resend blindly.

The Messages script may be unable to start brand-new conversations from the Mac; if a first-time send fails, give the user the exact text to paste themselves, after which the script can handle the thread.

Notes and Calendar are read-only unless the user approves a specific change. Leave bank or account numbers out of any relay.

Use when another bot or the owner asks you to send an iMessage/SMS from the owner's Mac, or to confirm whether a text already went out.

First conversation with a new owner of an Apple Desk bot: connect their Mac and set Messages rules.