Using spark is a CLI for the Spark email client. Use it to query the user's mailbox, calendar, contacts, meetings, and team data. Running spark Environment: is a thin client that talks over IPC to the user's running Spark Desktop app - it does not ship its own mailbox, network stack, or credentials. Run it directly on the user's computer against the live Spark Desktop process. Do not try to execute it inside a sandbox, container, CI runner, or any environment isolated from the user's desktop session - it will fail to connect. If Spark Desktop is not running, ask the user to launch it instead…

Revenue is up:\\n\\n![Q3 revenue](chart.png)' --attach /path/to/chart.png # show an attached image in the text\nspark draft --reply-to 5678 --body \"Resending the file\" --attach-id 42 # attach a file from the original email\ncat report.pdf | spark draft --to \"[email protected]\" --subject \"Report\" --body \"See attached\" --attach-stream report.pdf # pipe a file the app can't read directly\nspark draft --to \"[email protected]\" --subject \"Proposal\" --body \"...\" --team \"Engineering\" --user [email protected] --user [email protected]\nspark draft --edit 1234 --team \"Engineering\" --user [email protected] --allow-send\nspark draft --edit 1234 --user [email protected] # invite carol on an already-shared draft\nspark draft --edit 1234 --allow-send # grant send-on-behalf permission on an already-shared draft\nspark draft --edit 1234 --no-allow-send # revoke previously-granted send-on-behalf permission\nspark draft --edit 1234 --remove-user [email protected] # kick alice from a shared draft (keeps share, comments, other collaborators)\nspark draft --edit 1234 --remove-user [email protected] --user [email protected] # swap collaborators: remove alice, invite dave\nspark draft --edit 1234 --unshare\nspark draft --delete 1234 # remove the draft for good (no Trash, no undo)\nspark draft --template \"Cold outbound v3\" --to \"[email protected]\" --placeholder \"Project name=Acme Q3\" --placeholder \"Deadline=Friday EOD\"\nspark draft --template 124 --edit 9821 --placeholder \"Project name=Acme Q3\" --placeholder \"Deadline=Friday EOD\"\n```\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `--to` | No | Recipient address (RFC822). Repeat for multiple. |\n| `--cc` | No | CC address. Repeat for multiple. |\n| `--bcc` | No | BCC address. Repeat for multiple. |\n| `--subject` | No | Subject line. |\n| `--body` | Yes (new, no `--template`) | Body content in markdown. Required for new drafts unless a template provides one. `![alt](file name)` shows an attached image in the text - see **Images in the body** below. |\n| `--edit` | No | Message ID of an existing draft to update. |\n| `--reply-to` | No | Message ID to reply to. Addresses the sender alone (or the `Reply-To:` address when the message carries one). |\n| `--reply-all` | No | Message ID to reply to, keeping everyone else on the thread: the other `To:` recipients land in To, the original `Cc:` in CC, minus your own address. Mutually exclusive with `--reply-to`; `--to` / `--cc` override the lists it builds. |\n| `--forward` | No | Message ID to forward. |\n| `--delete` | No | Message ID of a draft to delete **permanently**. Must be the only option on the command. Drafts have no Trash, so the deletion cannot be undone. A scheduled draft and a draft shared with teammates are both refused - `action unschedule` or `draft --edit \u003cpk> --unshare` first. |\n| `--account` | No | Account email to send from. Accepts a regular mail account, an alias, or a shared inbox email. |\n| `--attach` | No | Absolute path to a file to attach. Repeat for multiple. The Spark app must be able to read the path; in the sandboxed App Store build a path outside the app's container can't be read and is rejected with a clear error - pipe the file with `--attach-stream` instead. Max 25 MB per file. |\n| `--attach-id` | No | ID of an attachment on an existing email to copy onto this draft, from the Attachments table of `thread \u003cmessage-id>`. Repeat for multiple. Use this to re-send a file the user received - replies don't inherit attachments (only `--forward` does). |\n| `--attach-stream` | No | Attach a single file whose bytes are read from stdin, shown to recipients as `\u003cname>`. Use this when the file is outside the app's sandbox (the App Store build can't read arbitrary paths) - it's the inbound twin of `attachment --stream`. One streamed file per command; combine with `--attach` for paths the app can read. Max 25 MB. Example: `cat report.pdf \\| spark draft --edit 123 --attach-stream report.pdf`. Needs a real stdin, so it only works when you run the `spark` binary yourself - otherwise use `--attach-id` / `--attach`. |\n| `--team` | No | Team name. Required when you belong to multiple teams. When editing a draft that's already shared, must match the team that owns the share. |\n| `--user` | No | Teammate email to share with. Repeat for multiple. On an already-shared draft this **adds** collaborators without removing existing ones - use `--remove-user` to remove someone. |\n| `--remove-user` | No | Teammate email to **remove** from an already-shared draft. Repeat for multiple. The shared draft, its comments, and the remaining collaborators are preserved (unlike `--unshare`, which tears the whole share down). Requires `--edit \u003cshared-pk>`. Cannot remove yourself - use `--unshare` for that. Can be combined with `--user` in one command to swap collaborators; removals run before invites. |\n| `--allow-send` | No | Grant teammates permission to send the shared draft on your behalf. New share: defaults to off when omitted. Edit of a shared draft: leaves the current value alone when omitted. Mutually exclusive with `--no-allow-send`. |\n| `--no-allow-send` | No | Revoke teammates' permission to send the shared draft on your behalf. Useful when editing a shared draft whose allow-send is currently on. Mutually exclusive with `--allow-send`. |\n| `--unshare` | No | Revert an already-shared draft back to a personal draft. Requires `--edit` and is mutually exclusive with `--team` / `--user` / `--remove-user` / `--allow-send` / `--no-allow-send` **and** with content edits (`--to` / `--cc` / `--bcc` / `--subject` / `--body` / `--attach` / `--attach-id` / `--attach-stream`) - issue the edit (or per-user removal) and the unshare as separate commands. |\n| `--template` | No | Apply a saved template by ID or name. Combine with `--edit` to overlay onto an existing draft. |\n| `--placeholder` | When template has manual placeholders | Fill a manual template placeholder, format `\"\u003cname>=\u003cvalue>\"`. Repeat for each. Auto-fillable placeholders (recipient/self names) are not addressable here - control them via `--to` and `--account`. |\n| `--no-signature` | No | Send without a signature. Suppresses the account's per-mailbox default signature for this draft. On `--edit` it strips a signature already on the draft (the body and quoted thread are kept). Omit the flag to keep using the account default. |\n| `signatures` | No | Positional, not a flag: prints every mailbox you can draft from with the signature it appends. Must be the only argument. |\n\nExplicit flags always win over template fields. Use `template \u003cid|name>` to discover the template's manual placeholders before calling `draft --template` - missing manual placeholders cause a hard error before any draft is created. Auto-fillable placeholders that fail to resolve (e.g. recipient name with multiple `--to`) leave a localized label in the body and surface in the response as a warning.\n\n**Images in the body.** To put an image in the text instead of the attachment list, attach it and show it with markdown image syntax by its file name: `--attach /path/to/chart.png --body \"![Q3 revenue](chart.png)\"`. The file can come from `--attach`, `--attach-stream` or `--attach-id`, or already be on the draft. An `https://` image address is left as it is. A local image that matches no attached file, or a file that isn't an image, is an error, so a draft never goes out with a broken image. On `--edit` with `--body`, the new body decides which images stay: show an image already on the draft by its name (as `thread \u003cdraft-id>` lists it) to keep it, leave it out to remove it.\n\n**The signature is added for you - never write your own sign-off.** Spark appends the mailbox's default signature to the body of every draft. `spark draft signatures` prints what each mailbox you can draft from appends.\n\nWhen the user asks for a closing that differs from their signature, pass `--no-signature` and write the whole closing yourself.\n\nOn success the output includes the draft's `ID:` (use it with `--edit` and `action send`) and a `Link:` line with a Spark deep link (`https://sparkmailapp.com/dpl/bl?token=...`) that opens the draft directly in Spark. It also echoes the composed body under `Body:` - the whole message as the recipient will read it, signature included and quoted thread left out. Read it back to confirm the draft says what you meant, and to catch a sign-off of your own standing next to the account's.\n\n**Always give the user the deep link.** After creating or updating a draft, include the `Link:` URL in your response as a clickable markdown link (e.g. `[Open draft in Spark](https://sparkmailapp.com/dpl/bl?token=...)`) so the user can jump straight to the draft to review or send it. Do not tell the user to open Spark and hunt for the draft manually.\n\nUse `emails` to find message IDs for `--edit`, `--reply-to`, `--reply-all`, and `--forward`.\nUse `accounts` to find account emails for `--account` - personal accounts, their `Alias:` entries, and shared inboxes are all listed there, and any of them can be used as the from address when the account has draft & comment access.\nUse `teams` to find team names for `--team` and team member emails for `--user`.\n\n**Threading is critical.** Whenever a new message belongs to an existing conversation, you **must** pass `--reply-to` with the **last message in that thread**. This is what attaches the draft to the conversation (correct In-Reply-To / References headers, same thread in the recipient's mailbox). Without `--reply-to` the draft starts a brand new thread, which is almost always wrong when the user asked you to \"reply\", \"respond\", \"follow up\", \"answer\", or \"ping\" anyone in the context of an existing conversation. Use `thread \u003cid>` to inspect the conversation and pick the most recent message's ID as `--reply-to`. On a thread with several participants, use `--reply-all` unless the user wants a private answer to the sender.\n\n**Follow-ups (no response yet).** When the user asks to follow up with someone you already emailed and they haven't replied yet (e.g. \"send Alice a nudge - she never responded to my last email\", \"bump the proposal thread\"), the most recent message in that thread is your own outgoing one. Use that message's ID as `--reply-to` - the follow-up stays attached to the original outgoing message so the recipient sees it as a bump on the existing conversation rather than a new cold email.\n\nSharing is triggered by the presence of `--team` or `--user`; teams with exactly one other active member auto-share with everyone, otherwise `--user` is required.\nTo add collaborators or change the allow-send setting on an existing shared draft, use `--edit \u003cpk>` together with the sharing flags - the change is applied to the existing share instead of creating a new one.\nTo toggle allow-send off, pass `--no-allow-send`.\nTo remove a specific collaborator without tearing the share down, pass `--remove-user \u003cemail>`; the shared draft, its comments, and the remaining collaborators stay intact. Combine `--user` and `--remove-user` in one command to swap collaborators in a single operation - removals run before invites.\nContent edits (`--to`, `--cc`, `--bcc`, `--subject`, `--body`, `--attach`) and sharing updates (`--team`, `--user`, `--remove-user`, `--allow-send`, `--no-allow-send`) must be issued as separate `draft` commands.\n\n**Deleting a draft is final.** `--delete \u003cpk>` removes the draft outright - unlike a received email there is no Trash to recover it from, and neither `history --undo` nor Spark's own undo can bring it back. Only delete a draft the user asked you to discard, and say so plainly in your response rather than implying it can be restored. To throw away just the *text* of a draft while keeping the draft itself, edit it (`draft --edit \u003cpk> --body \"...\"`) instead.\n\n### templates\n\nList Spark message templates - the saved drafts users can apply via `draft --template`. Templates round-trip from desktop, so anything saved on the user's computer shows up here.\n\n```bash\nspark templates # all personal + team templates\nspark templates --personal # only personal templates\nspark templates --team \"Marketing\" # only that team's templates\nspark templates --page 2 --page-size 20 # pagination\n```\n\nOutput columns: `ID`, `Scope` (Personal / `\u003cteam name>`), `Name`, `Subject` (truncated to 40 chars), `Modified`. Use the `ID` or `Name` value with `template \u003cid|name>` and `draft --template`.\n\n### template\n\n**Read-only.** Show a single template's full contents and its placeholder requirements. Run this before `draft --template` so you know which `--placeholder \"\u003cname>=\u003cvalue>\"` arguments the template needs.\n\n```bash\nspark template 123 # by ID\nspark template \"Welcome reply\" # by name (case-insensitive)\n```\n\nOutput includes scope, recipients, subject, body (HTML stripped to text), attachments, and a `Placeholders:` section listing every placeholder in the template:\n\n- `[auto]` - auto-fillable (recipient/self name). Resolved from `--to` and `--account` when applied. **Not** overridable via `--placeholder`.\n- `[manual]` - free-form placeholder. Required: must be passed as `--placeholder \"\u003cname>=\u003cvalue>\"` to `draft --template`.\n\nIf a name matches more than one template, you'll get an error listing the matching IDs - disambiguate by ID.\n\n### comment\n\n**Requires: triage** access level.\n\nPost a team comment (chat message) on a thread. If the thread is not yet shared, it will be shared automatically. Supports text comments, file attachments, or both. Use `--edit` to update an existing comment.\n\n```bash\nspark comment 1234 --body \"Looks good, let's proceed.\"\nspark comment 1234 --body \"Please review this\" --team \"Engineering\"\nspark comment 1234 --body \"FYI\" --team \"Engineering\" --user [email protected] --user [email protected]\nspark comment 1234 --attach /path/to/screenshot.png\nspark comment 1234 --body \"See attached\" --attach /path/to/report.pdf --attach /path/to/data.csv\ncat screenshot.png | spark comment 1234 --attach-stream screenshot.png # pipe a file the app can't read directly\nspark comment --edit 5678 --body \"Updated comment text\"\n```\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `\u003cmessage-id>` | Yes (post) | Message ID of a message in the thread to comment on. |\n| `--body` | When no `--attach` | Comment text to post. Required when using `--edit`. |\n| `--attach` | When no `--body` | Absolute path to a file to attach. Repeat for multiple files. Each file is sent as a separate message. Cannot be used with `--edit`. The Spark app must be able to read the path; in the sandboxed App Store build a path outside the app's container can't be read and is rejected with a clear error - pipe the file with `--attach-stream` instead. Max 25 MB per file. |\n| `--attach-stream` | When no `--body` | Attach a single file whose bytes are read from stdin, shown as `\u003cname>`, sent as its own comment message. Use this when the file is outside the app's sandbox (the App Store build can't read arbitrary paths) - it's the inbound twin of `attachment --stream`. One streamed file per command; cannot be used with `--edit`. Max 25 MB. Example: `cat shot.png \\| spark comment 456 --attach-stream shot.png --team \"Engineering\"`. Needs a real stdin, so it only works when you run the `spark` binary yourself - otherwise use `--attach`. |\n| `--edit` | No | Message ID of an existing comment to edit. Requires `--body`. |\n| `--team` | When >1 team | Team name. Required when you belong to multiple teams. |\n| `--user` | When team >2 members | Teammate email to share with. Repeat for multiple. Only used when auto-sharing an unshared thread. For teams with 2 or fewer members, the whole team is shared with automatically. |\n\nUse `emails` to find message IDs. Use `thread` to see comment IDs in a conversation. Use `team` to list teams and their members.\n\n### events\n\nList calendar events for a time range.\n\n```bash\nspark events # today's remaining events\nspark events --tomorrow\nspark events --week\nspark events --week --in [email protected] # specific account\nspark events --week --in [email protected]:Work # specific calendar\nspark events --start 2026-03-16 --end 2026-03-20 # custom range\nspark events --week --include-hidden # hidden calendars too\n```\n\nDate formats: `yyyy-MM-dd`, `dd/MM/yyyy`, or `yyyy-MM-ddTHH:mm`.\n\nRun `accounts` to see available calendar accounts and calendar names.\n\n**Hidden calendars:** `accounts` marks a calendar `(hidden)` when the user switched it off in Spark's calendar view. `events` leaves hidden calendars out, the same way Spark's calendar view does. Pass `--include-hidden` to add them, or name one with `--in [email protected]:Name` to list just that calendar. If the user expects events that aren't listed, check `accounts` for hidden calendars before concluding the calendar is empty or unsupported.\n\n### event\n\n**Requires: send** access level on the target calendar's owning account. Every mode can emit mail through the calendar service (invitations on create / update, iTIP UPDATE / CANCEL on update / delete of attendee-bearing events, an iTIP REPLY on rsvp), and attaching attendees makes the event discoverable by the provider's invitation channel independent of email, so the whole command sits at `send`.\n\nCreate, update, delete, or RSVP to a calendar event, including managing its attendees. Use `--add` / `--remove` on `create` or `update` to attach or detach attendees and send invitations / cancellations through the calendar provider (CalDAV / Google / Exchange).\n\n```bash\nspark event create --title \"Sync\" --start 2026-07-01T12:00 --end 2026-07-01T13:00\nspark event create --title \"OOO\" --start 2026-07-01 --all-day\nspark event create --title \"Standup\" --start 2026-07-01T09:00 --end 2026-07-01T09:15 --video-conference auto\nspark event create --title \"Sync\" --start 2026-07-01T10:00 --end 2026-07-01T10:30 --video-conference zoom\nspark event create --title \"1:1\" --start 2026-07-01T14:00 --end 2026-07-01T14:30 --calendar \"[email protected]:Work\"\nspark event create --title \"Sync\" --start 2026-07-01T12:00 --add \"[email protected],[email protected]\" # create + invite\nspark event update ABC-123 --title \"New title\"\nspark event update ABC-123 --location \"Room 7\"\nspark event update ABC-123 --video-conference meet # add a meeting link\nspark event update ABC-123 --add [email protected] --remove [email protected] # swap attendees\nspark event delete ABC-123\nspark event rsvp ABC-123 accept # calendar event ID\nspark event rsvp ABC-123 decline\nspark event rsvp 44268 maybe # invitation email message ID\n```\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `mode` | Yes | `create`, `update`, `delete`, or `rsvp` (positional). |\n| `event_id` | For `update`/`delete`/`rsvp` | Positional, second arg. For `update`/`delete`: a calendar event ID (use `events`). For `rsvp`: either a calendar event ID **or** the message ID of the invitation email (use `emails` / `thread`). |\n| `status` | For `rsvp` | RSVP status (positional, third arg): `accept`, `decline`, or `maybe`. |\n| `--title` | No | Event title / summary. |\n| `--start` | Yes (for `create`) | Start date/time (`yyyy-MM-dd`, `dd/MM/yyyy`, `yyyy-MM-ddTHH:mm`, or `yyyy-MM-ddTHH:mm:ssXXX`). |\n| `--end` | No | End date/time. |\n| `--all-day` | No | Mark the event as all-day. |\n| `--description` | No | Event description / notes. |\n| `--alerts` | No | Comma-separated alert offsets (`Ns` for N seconds before, e.g. `300s,600s`) or absolute dates. |\n| `--location` | No | Event location text. |\n| `--video-conference` | No | Attach a video conference (value required). `auto` auto-picks the account's type (recently used, else default); `meet`, `zoom`, or `teams` selects a specific one and errors if the account doesn't support it. |\n| `--calendar` | No | Target calendar for `create`. Format: `[email protected]` (account's default calendar) or `[email protected]:Name` (specific named calendar). Hidden calendars work too, and saving an event in one switches it back on in Spark's calendar view. |\n| `--add` | No | Attendee email address(es) to invite (create / update only). Repeat the flag or pass a comma-separated list. New attendees receive an iTIP REQUEST (invitation). |\n| `--remove` | No | Attendee email address(es) to remove (update only). Repeat the flag or pass a comma-separated list. Removed attendees receive an iTIP CANCEL. The organizer cannot be removed. |\n\n**Attendees (`--add` / `--remove`):**\n- Only valid on `create` and `update`; passing them to `delete` or `rsvp` is refused. Combine both in one `update` to swap attendees - removals run before additions.\n- Adding or removing attendees always emits iTIP mail (REQUEST / CANCEL). An event with no attendees stays invisible to the calendar service's invitation channel.\n- Attaching attendees makes the event discoverable by the calendar provider's invitation channel (including Google Calendar's same-provider auto-add behavior), independent of email delivery - which is why the whole command requires `send`.\n\n**`event update` semantics:**\n- `--video-conference` attaches a meeting link (`meet` / `zoom` / `teams`, or `auto`) to an existing event, generated through the same path as `create`. On an event with attendees this is a shared change, so it sends the iTIP UPDATE.\n- Event with **no attendees** → local update, no mail goes out.\n- Event **with attendees** → update + iTIP UPDATE sent to all attendees so their calendars reflect the new state. Output reports the attendee count.\n- An alerts-only edit is a personal reminder and notifies nobody, even on an event with attendees.\n\n**`event delete` semantics:**\n- Event with **no attendees** → local delete, no mail goes out.\n- Event **with attendees** → delete + iTIP CANCEL sent to all attendees so their calendars get cleaned up too. Output reports the attendee count. Deleting without the cancellation would orphan the invitation on attendees' calendars (most visibly on Google's same-provider auto-add channel).\n\n**`event rsvp` semantics:**\n- Sets *your own* attending status on an invitation: `accept`, `decline`, or `maybe` (alias for tentative). Responding emits an iTIP REPLY back to the organizer.\n- The id can be **either** a calendar event ID **or** the message ID of the invitation email. Many providers (Google included) leave an unanswered invite sitting in the inbox without adding it to the calendar, so when the user asks you to respond to an invitation, look it up with `emails` / `thread` and pass that **message ID** - you do not need a calendar event. When the invite *has* been auto-added to the calendar, a calendar event ID works too.\n- For a message ID, the reply mirrors Spark Desktop: it updates the matching calendar event if one is synced, otherwise it mails the iTIP REPLY straight to the organizer (and, on `accept`, adds the event to your calendar).\n- Errors if the target is not an invitation you can respond to (a plain email, your own organized event with no RSVP, or a provider that does not allow responding).\n- For a calendar event, re-RSVPing to the status you already hold is a no-op and reported as such.\n\nTypical flow when scheduling a new meeting: call `event create ...` to lay down the event first, confirm the time and details with the user, then call `event update \u003cevent-id> --add ...` to push invitations - so the user can review (or you can revise) the event before any external email goes out. When you already have the attendees, `event create ... --add ...` does both in one step.\n\nRun `accounts` to see writable calendars and the access level on each account.\n\n### availability\n\nFind free time slots. Without `--attendees`, shows the user's own availability. With `--attendees`, computes mutual free windows.\n\n```bash\nspark availability # today\nspark availability --tomorrow\nspark availability --week --attendees [email protected]\nspark availability --start 2026-03-16 --end 2026-03-20 --attendees [email protected],[email protected]\n```\n\nFree slots are within working hours (08:00-20:00), skip weekends, and ignore events marked \"free\".\n\n### contacts\n\nSearch contacts by name or email. Strict match first, then fuzzy fallback. Without a query, lists the contacts the user writes to most, most-used first. `--limit` caps the list (1-1000, default 25).\n\n```bash\nspark contacts \"john\"\nspark contacts \"example.com\"\nspark contacts --limit 500 --json # most-used contacts; \"query\" is null, \"match\" is \"top\"\n```\n\n### contact\n\nShow one contact's details: name, other addresses, and each setting `contact-action` changes. Check a sender's state before changing it - e.g. whether they are already Priority or blocked. An unknown address is an error.\n\n```bash\nspark contact [email protected]\nspark contact [email protected] --json\n```\n\n| Field | Changed by |\n|-------|-----------|\n| `category` (`personal` / `notification` / `newsletter`) | `changeCategory*` |\n| `is_priority` | `markContactAsPrimary` / `unmarkContactAsPrimary` |\n| `notifications` | `markContactAsImportant` / `unmarkContactAsImportant` |\n| `blocked` / `accepted` (GateKeeper; neither for a new sender) | `blockContact` / `acceptContact` |\n| `grouped`, `grouped_in_inbox` | `groupEmailsFromContact[AndShowInInbox]` / `ungroupEmailsFromContact` |\n| `auto_summary` | `enableAutosummaryForContact` / `disableAutosummaryForContact` |\n\n### team\n\nShow team info - metadata, shared inboxes with members, full member list, assigned emails, assignment summary.\n\n```bash\nspark team # list available teams\nspark team \"Readdle\" # specific team\n```\n\n### meetings\n\nList meeting transcripts with optional filters and pagination.\n\n```bash\nspark meetings\nspark meetings --filter \"newer_than:30d\"\nspark meetings --filter \"subject:standup\" --page-size 10\n```\n\nFilter operators: `subject:\u003ctext>`, `before:yyyy/MM/dd`, `after:yyyy/MM/dd`, `newer_than:Xd`, `older_than:Xd`.\n\n### meeting\n\nRead a single meeting transcript's summary. Optionally include the full transcript and/or notes.\n\n```bash\nspark meeting 42 # summary only\nspark meeting --transcript 42 # include transcript\nspark meeting --notes 42 # include notes\nspark meeting --transcript --notes 42 # everything\nspark meeting \"https://sparkmailapp.com/dpl/bl?token=ABC...\" # by Spark deep link\n```\n\nThe positional argument accepts either a numeric meeting message ID or a Spark deep link.\n\nUse `meetings` to find meeting IDs.\n\n### action\n\n**Requires: triage** access level.\n\nPerform an action on one or more emails. Supports standard email actions and team actions.\n\n```bash\nspark action \u003caction-name> \u003cmessage-id...> [options]\n```\n\nSupported actions:\n- `pin` - Pin the message to keep it at the top of the list\n- `unpin` - Remove the pin from the message\n- `mute` - Mute the thread to stop receiving notifications\n- `unmute` - Unmute a previously muted thread\n- `snooze` - Snooze the message until a specific date (requires `--date`)\n- `unsnooze` - Remove the snooze and return the message to the inbox\n- `changeReminder` - Set a follow-up reminder if no reply by the date (requires `--date`)\n- `clearReminder` - Remove the follow-up reminder from the message\n- `setAside` - Set the message aside for later review\n- `archive` - Archive the message, removing it from the inbox\n- `moveToInbox` - Move the message back to the inbox\n- `moveToTrash` - Move the message to trash\n- `moveToFolder` - Move the message to a specific folder (requires `--folder`)\n- `attachLabel` - Attach a Gmail or Spark Team label without removing other labels (requires `--folder`)\n- `detachLabel` - Remove a Gmail or Spark Team label from the message (requires `--folder`)\n- `markAsDone` - Mark the message as done\n- `markAsUndone` - Mark the message as not done\n- `markAsSeen` - Mark the message as read\n- `markAsUnseen` - Mark the message as unread\n- `markAsSpam` - Mark the message as spam\n- `markThreadAsPriority` - Mark the thread as priority\n- `unmarkThreadAsPriority` - Remove the priority mark from the thread\n- `unsubscribe` - Unsubscribe from the sender or mailing list\n- `changeCategoryPersonal` - Change the email category to Personal\n- `changeCategoryNotification` - Change the email category to Notification\n- `changeCategoryNewsletters` - Change the email category to Newsletter\n- `shareInTeam` - Share the thread with teammates (requires `--team` when multiple teams)\n- `assign` - Assign the email to a teammate (requires `--assignee`)\n- `delegationComplete` - Mark the delegation as complete\n- `delegationReopen` - Reopen a completed delegation\n\n**`send` verb (requires send access):**\n\nSends an existing draft (created with `spark draft` or in Spark Desktop) through the owning account's outbound mail pipeline. Same validation as the desktop composer: the draft must live on an account whose access level is **send** (Settings -> AI Agents), have at least one recipient, a non-empty subject, all attachments uploaded, and no unresolved manual template placeholders.\n\n```bash\nspark action send 1234\n```\n\nOutput reports the original draft ID and the PK of the sent message:\n\n`Draft 1234 sent. Sent message ID: 5678.`\n\nTypical flow: `spark draft ...` to compose, review the draft, then `spark action send \u003cpk>` to commit. Splitting the two operations means you (or the user) can edit the draft before any external mail is emitted - `spark draft` alone never sends.\n\n`send` accepts multiple draft IDs in one call (each runs through validation independently and the response reports per-draft success/failure), but the common case is a single id.\n\n**Scheduled send (\"Send Later\"):** pass an optional `--date` to schedule the draft instead of sending it now. The date must be in the future (formats: `yyyy-MM-dd`, `dd/MM/yyyy`, `yyyy-MM-ddTHH:mm`); a past or malformed date is rejected before anything is sent.\n\n```bash\nspark action send 1234 --date 2026-04-10T09:00\n```\n\nOutput confirms the schedule: `Draft 1234 scheduled to send on 2026-04-10 09:00. Message ID: 5678.` The message sits in the outbox and is delivered at that time.\n\n**Manage an already-scheduled (\"Send Later\") message** by targeting its message ID with `send`:\n\n- **Reschedule:** `send` with a new `--date` updates the existing schedule (it is no longer a plain draft, so this does not create a new message):\n\n```bash\nspark action send 5678 --date 2026-04-12T15:00\n```\n\nOutput: `Message 5678 rescheduled to send on 2026-04-12 15:00. Message ID: 5678.`\n\n- **Send now:** `send` with no `--date` drops the schedule and sends it immediately:\n\n```bash\nspark action send 5678\n```\n\nOutput: `Scheduled message 5678 sent now. Message ID: 5678.`\n\n- **Unschedule:** `unschedule` cancels the schedule and returns the message to drafts (so you can edit it or send it later):\n\n```bash\nspark action unschedule 5678\n```\n\nOutput: `Message 5678 unscheduled - returned to drafts. Find it in the Drafts folder.` Clearing the schedule mints a fresh draft, so the original ID (5678) no longer resolves - re-list the Drafts folder to get the new draft ID before editing or sending it.\n\nBoth `send` (with or without `--date`) on a scheduled message and `unschedule` require send access on the owning account.\n\nOptions:\n- `--date` - required for `snooze` and `changeReminder`, optional for `assign` as due date (formats: `yyyy-MM-dd`, `dd/MM/yyyy`, `yyyy-MM-ddTHH:mm`)\n- `--folder` - required for `moveToFolder`, `attachLabel`, and `detachLabel` (qualified name: `[email protected]:FolderName`; use `folders` to list labels including shared inboxes)\n- `--team` - team name for team actions; required when you belong to multiple teams\n- `--user` - teammate email to share with for `shareInTeam`; repeat for multiple users; required when team has more than 2 members\n- `--assignee` - teammate email to assign the email to for `assign`\n- `--comment` - comment text for the `assign` action\n\n```bash\nspark action pin 12345 # pin a message\nspark action archive 100 200 300 # archive multiple messages\nspark action markAsSeen 100 200 # mark as read\nspark action snooze 12345 --date 2026-04-10T09:00 # snooze until date/time\nspark action snooze 12345 --date 2026-04-10 # snooze until date\nspark action moveToFolder 12345 --folder \"[email protected]:Archive\" # move to folder\nspark action attachLabel 12345 --folder \"[email protected]:MyLabel\" # add Gmail/Team label\nspark action detachLabel 12345 --folder \"[email protected]:SomeLabel\" # remove label\nspark action changeReminder 12345 --date 2026-04-15 # set reminder\nspark action shareInTeam 1234 --team \"Engineering\" --user [email protected] # share with teammate\nspark action shareInTeam 1234 --user [email protected] --user [email protected] # share with multiple\nspark action assign 1234 --assignee [email protected] # assign to teammate\nspark action assign 1234 --assignee [email protected] --date 2026-04-15 --comment \"Please review\"\nspark action delegationComplete 1234 # mark delegation done\nspark action delegationComplete 100 200 300 # complete multiple delegations\nspark action delegationReopen 1234 # reopen delegation\n```\n\nUse the `emails` command to find message IDs. Use `folders` to resolve qualified names for `moveToFolder`, `attachLabel`, and `detachLabel`. Use `team` to list teams and members for team actions.\n\n### contact-action\n\n**Requires: triage** access level.\n\nPerform an action on one or more contacts by email address.\n\n```bash\nspark contact-action \u003caction-name> \u003cemail...>\n```\n\nSupported actions:\n\n| Action | Description |\n|--------|-------------|\n| `changeCategoryPersonal` | Change the contact's email category to Personal |\n| `changeCategoryNotification` | Change the contact's email category to Notification |\n| `changeCategoryNewsletters` | Change the contact's email category to Newsletter |\n| `groupEmailsFromContact` | Group emails from the contact by category |\n| `groupEmailsFromContactAndShowInInbox` | Group emails from the contact and show in inbox |\n| `ungroupEmailsFromContact` | Ungroup emails from the contact |\n| `markContactAsImportant` | Enable notifications for the contact |\n| `unmarkContactAsImportant` | Disable notifications for the contact |\n| `markContactAsPrimary` | Mark the contact as priority (auto-prioritize emails) |\n| `unmarkContactAsPrimary` | Remove priority mark from the contact |\n| `acceptContact` | Accept or unblock the contact (bypass Gatekeeper) |\n| `blockContact` | Block the contact |\n| `acceptDomain` | Accept or unblock the contact's entire domain |\n| `blockDomain` | Block the contact's entire domain |\n| `enableAutosummaryForContact` | Enable auto-summary for emails from the contact |\n| `disableAutosummaryForContact` | Disable auto-summary for emails from the contact |\n\nExamples:\n\n```bash\nspark contact-action blockContact [email protected]\nspark contact-action acceptContact [email protected] [email protected]\nspark contact-action changeCategoryPersonal [email protected]\nspark contact-action markContactAsPrimary [email protected]\nspark contact-action enableAutosummaryForContact [email protected]\n```\n\nUse the `contacts` command to look up email addresses.\n\n## Smart Categories\n\nSpark automatically classifies incoming email into six categories. Use the `category:` filter operator with `emails` and `search` to view mail by category, and use `action` / `contact-action` to reclassify and tune.\n\n| Category | Filter | Typical Content |\n|----------|--------|-----------------|\n| Priority | `category:priority` | Auto-prioritized or manually marked as priority |\n| People | `category:personal` | Direct person-to-person email |\n| Notifications | `category:notification` | Service notifications, alerts, receipts |\n| Newsletters | `category:newsletter` | Subscriptions, digests, marketing |\n| Invites | `category:invitation` | Calendar invitations |\n| Invite Responses | `category:invitation_response` | RSVPs, accepts, declines |\n\n**Browse by category** (read-only):\n\n```bash\nspark emails Inbox --filter \"category:priority is:unread\" # unread priority mail\nspark emails Inbox --filter \"category:personal is:unread\" # unread people mail\nspark emails Inbox --filter \"category:invitation\" # pending invites\nspark emails Inbox --filter \"category:notification is:unread\" # unread notifications\nspark emails Inbox --filter \"category:newsletter newer_than:7d\" # recent newsletters\n```\n\n**Reclassify a message** (triage):\n\n```bash\nspark action changeCategoryPersonal \u003cid> # move to People\nspark action changeCategoryNotification \u003cid> # move to Notifications\nspark action changeCategoryNewsletters \u003cid> # move to Newsletters\n```\n\n**Tune per-contact category rules** (triage) - changes apply to all future mail from the sender:\n\n```bash\nspark contact-action changeCategoryPersonal [email protected] # reclassify as People\nspark contact-action changeCategoryNewsletters [email protected] # reclassify as Newsletters\nspark contact-action groupEmailsFromContact [email protected] # group by category\nspark contact-action markContactAsImportant [email protected] # enable notifications\nspark contact-action markContactAsPrimary [email protected] # auto-prioritize\nspark contact-action enableAutosummaryForContact [email protected] # AI summaries\n```\n\n**Category-first triage pattern:** Process inbox in priority order - priority first, then people, then invites, then notifications, then newsletters. This ensures the most important messages get attention first.\n\n## Typical Workflows\n\n**Answer a question about emails:**\n1. `spark search \"topic\"` - find relevant emails with bodies\n2. Read the output and answer the user's question\n\n**Find and read a specific email:**\n1. `spark emails --filter \"from:sender subject:keyword\"` - locate the email\n2. `spark thread \u003cID>` - read the full conversation\n\n**Draft a reply:**\n1. `spark emails --filter \"from:sender\"` - find the email\n2. `spark draft --reply-to \u003cID> --body \"Thanks for the update!\"`\n3. Give the user the `Link:` from the output as a clickable markdown link so they can review the draft in Spark\n\n**Send an email from a saved template:**\n1. `spark templates` - list templates (or `spark templates --personal` / `--team \"\u003cname>\"`)\n2. `spark template \"\u003cname>\"` - inspect placeholders before applying\n3. `spark draft --template \"\u003cname>\" --to \u003crecipient> --placeholder \"\u003cmanual>=\u003cvalue>\"` - create the draft (repeat `--placeholder` for each manual one)\n\n**Check someone's schedule for a meeting:**\n1. `spark availability --tomorrow --attendees [email protected],[email protected]`\n2. Suggest a time from the free slots\n\n**Comment on a shared thread:**\n1. `spark emails --filter \"from:sender\"` - find the email\n2. `spark comment \u003cID> --body \"Looks good, approved!\"`\n\n**Get team workload overview:**\n1. `spark team \"Team Name\"` - see members and assigned emails\n\n**Look up a contact:**\n1. `spark contacts \"name or domain\"` - find their email address\n\n**Perform an action on emails:**\n1. `spark emails --filter \"from:sender\"` - find the email\n2. `spark action archive \u003cID>` - archive it (or pin, snooze, etc.)\n\n**Share an email with your team:**\n1. `spark emails --filter \"subject:keyword\"` - find the email\n2. `spark action shareInTeam \u003cID> --user [email protected]` - share with a teammate\n\n**Delegate an email to a teammate:**\n1. `spark emails --filter \"subject:keyword\"` - find the email\n2. `spark action assign \u003cID> --assignee [email protected] --date 2026-04-15 --comment \"Please handle this\"`\n\n**Mark delegated emails as done:**\n1. `spark emails --filter \"subject:keyword\"` - find the email(s)\n2. `spark action delegationComplete \u003cID1> \u003cID2>` - mark multiple as complete\n\n**Find unassigned shared inbox emails:**\n1. `spark emails [email protected]:Inbox --filter \"assigned_to:unassigned\"` - list unassigned items\n2. `spark action assign \u003cID> --assignee [email protected]` - assign to a teammate\n\n**Review what's assigned to a teammate:**\n1. `spark emails --filter \"assigned_to:[email protected]\"` - see their assignments\n2. `spark emails --filter \"is:shared_inbox_open\"` - all open shared inbox items\n3. `spark emails --filter \"is:shared_inbox_done\"` - completed items\n\n**Manage a contact:**\n1. `spark contacts \"name or domain\"` - find the contact email\n2. `spark contact-action blockContact [email protected]` - block them (or accept, change category, etc.)\n\n## Keeping this skill up to date\n\nThe CLI and this skill share a single version (`metadata.version` in the front-matter above). New features in newer Spark Desktop releases ship with an updated embedded skill. Backward compatibility is guaranteed within a major version, so the commands and flags documented here keep working - but newly added features won't appear in this file until it is reinstalled.\n\nCheck for an update when - and only when - you hit one of these signals:\n\n- The user asks about a Spark feature, command, or flag that isn't documented here.\n- A `spark` command fails with an \"unknown command\" or \"unknown option\" error you didn't expect.\n- The user explicitly says they upgraded Spark or that the skill is out of date.\n\nIn those cases:\n\n```bash\nspark --version\n```\n\nIf the printed version is greater than `metadata.version` above, refresh this file before answering. `spark skill` prints SKILL.md to stdout - capture it and write it back over the file you're reading right now (the path is in your context). For example:\n\n```bash\nmkdir -p \u003cparent-of-use-spark>/use-spark\nspark skill > \u003cparent-of-use-spark>/use-spark/SKILL.md\n```\n\n`\u003cparent-of-use-spark>` is the directory containing the `use-spark/` folder this `SKILL.md` lives in. If you have a file-write tool, you can also pipe `spark skill` output directly through it - the CLI itself does not write any files.\n\nDo not check on every session or before every command - this skill is the source of truth unless one of the signals above tells you otherwise.\n\n## Tips\n\n- Always quote multi-word arguments: `spark search \"project update\"`\n- Combine filter operators in a single `--filter` string: `--filter \"from:[email protected] is:unread newer_than:7d\"`\n- Use `folders` to discover exact folder identifiers before passing them to `emails` or `search --in`\n- Use `accounts` to discover calendar names before passing them to `events --in`\n- The `search` command is best for topic-based queries; `emails` is best for browsing/filtering by metadata\n- `thread` returns the full conversation - use it when you need the complete email text, not just metadata\n- Use `draft` to compose emails - it supports new drafts, replies, forwards, and editing existing drafts\n- After creating a draft, always share its `Link:` deep link with the user as a clickable markdown link instead of asking them to open Spark\n- `draft --delete \u003cpk>` discards a draft permanently - there is no Trash and no undo, so use it only when the user asked for it\n- Never end a draft body with a sign-off: Spark appends the account's signature itself (`draft signatures` shows it)\n- Use `comment` to post team chat messages on threads - it auto-shares the thread if needed\n- Use `action` to perform email actions like pin, archive, snooze, move to folder, and more\n- Use `contact-action` to manage contacts - block, accept, change category, toggle auto-summary, and more","attachment_filenames":[],"attachments":[],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Using spark","type":"text"}]},{"type":"paragraph","content":[{"text":"spark","type":"text","marks":[{"type":"code_inline"}]},{"text":" is a CLI for the Spark email client. Use it to query the user's mailbox, calendar, contacts, meetings, and team data.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Running spark","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark \u003ccommand> [options]","type":"text"}]},{"type":"paragraph","content":[{"text":"Environment:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code_inline"}]},{"text":" is a thin client that talks over IPC to the user's running Spark Desktop app - it does not ship its own mailbox, network stack, or credentials. Run it directly on the user's computer against the live Spark Desktop process. Do not try to execute it inside a sandbox, container, CI runner, or any environment isolated from the user's desktop session - it will fail to connect. If Spark Desktop is not running, ask the user to launch it instead of retrying.","type":"text"}]},{"type":"paragraph","content":[{"text":"JSON output:","type":"text","marks":[{"type":"strong"}]},{"text":" add ","type":"text"},{"text":"--json","type":"text","marks":[{"type":"code_inline"}]},{"text":" to any command to get its result as JSON instead of text - the same data, with full (untruncated) values, snake_case keys, and ISO 8601 dates. A failure prints ","type":"text"},{"text":"{\"error\": {\"message\": \"…\"}}","type":"text","marks":[{"type":"code_inline"}]},{"text":" on stdout and exits non-zero. Prefer the default text when you only need to read the result; use ","type":"text"},{"text":"--json","type":"text","marks":[{"type":"code_inline"}]},{"text":" when you need to process it (e.g. ","type":"text"},{"text":"spark emails --json | jq '.emails[].id'","type":"text","marks":[{"type":"code_inline"}]},{"text":"). Fields are only ever added, never renamed or removed.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Commands","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Command","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"accounts","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"List accounts, calendars, teams, shared inboxes, and access levels","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"folders","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"List folders/labels with message counts","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"emails","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"List emails with filters and pagination","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"search","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Hybrid keyword + semantic search with full bodies","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"thread","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Read full thread - headers, bodies, attachments","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"attachment","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Read a single email attachment by its ID (auto-downloads)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"draft","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Create, edit, or delete an email draft (new, reply, forward, from template), or list account signatures","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"templates","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"List saved message templates (personal and team)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"template","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Show a single template by ID or name with its placeholders","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"comment","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Post a team comment on a thread","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"events","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"List calendar events for a time range","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"event","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Create, update, delete, or RSVP to a calendar event, including managing attendees / invitations","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"availability","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Find free time slots, optionally with attendees","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"contacts","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Search contacts by name or email, or list the most-used ones","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"contact","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Show one contact's details and settings","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"team","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Show team info, members, shared inboxes, assignments","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"meetings","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"List meeting transcripts","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"meeting","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Read a single meeting transcript","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"action","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Perform actions on emails (archive, pin, snooze, assign, etc.)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"contact-action","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Perform actions on contacts (block, accept, categorize, etc.)","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"accounts","type":"text"}]},{"type":"paragraph","content":[{"text":"List all configured accounts with their aliases, calendars, teams, and shared inboxes. Each account and shared inbox shows its ","type":"text"},{"text":"access level","type":"text","marks":[{"type":"strong"}]},{"text":" in parentheses, which controls what operations Spark can perform.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark accounts","type":"text"}]},{"type":"paragraph","content":[{"text":"Run this first to discover what accounts, calendars, and teams are available, and to check their access levels.","type":"text"}]},{"type":"paragraph","content":[{"text":"Access levels:","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Level","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Allowed operations","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"read-only","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"List, search, and read emails, threads, folders, events, contacts, meetings, teams","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"triage","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Everything in read-only plus all write operations: drafts, team comments, email actions (archive, move, pin, snooze, assign, etc.), contact actions (block, accept, categorize, etc.)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"send","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Everything in triage plus mail-emitting operations: sending drafts (","type":"text"},{"text":"action send","type":"text","marks":[{"type":"code_inline"}]},{"text":", including scheduled \"Send Later\"), and the entire ","type":"text"},{"text":"event","type":"text","marks":[{"type":"code_inline"}]},{"text":" command: ","type":"text"},{"text":"event create","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"event update","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"event delete","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"event rsvp","type":"text","marks":[{"type":"code_inline"}]},{"text":", including attaching or detaching attendees via ","type":"text"},{"text":"--add","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--remove","type":"text","marks":[{"type":"code_inline"}]},{"text":" and the iTIP REQUEST / UPDATE / CANCEL / REPLY mail that goes with them.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Access levels are configured separately for each account and each shared inbox in Spark Desktop under Settings -> AI Agents. Shared inboxes can have a different access level than the parent account - for example, a personal account may have triage access while a shared inbox under the same team is read-only or disabled.","type":"text"}]},{"type":"paragraph","content":[{"text":"If a command requires a higher access level than the account or shared inbox has, it returns an error with instructions on how to change the level.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"folders","type":"text"}]},{"type":"paragraph","content":[{"text":"List folders with message counts. Output includes folder identifiers in parentheses - use these as arguments to ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"search","type":"text","marks":[{"type":"code_inline"}]},{"text":". Mailboxes backed by a Google account show ","type":"text"},{"text":"(Gmail labels)","type":"text","marks":[{"type":"code_inline"}]},{"text":" on the ","type":"text"},{"text":"Email Account","type":"text","marks":[{"type":"strong"}]},{"text":" or ","type":"text"},{"text":"Shared Inbox","type":"text","marks":[{"type":"strong"}]},{"text":" header. Teams show the team name as a usable identifier for ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark folders # all accounts\nspark folders [email protected] # single account","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"emails","type":"text"}]},{"type":"paragraph","content":[{"text":"List emails with metadata (ID, From, Date, Subject, Flags). Supports pagination and Gmail-style filters.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark emails # Unified Inbox\nspark emails [email protected]:Archive # specific folder\nspark emails \"My Team\" # all shared threads in a team\nspark emails --filter \"from:[email protected] is:unread\" # filtered\nspark emails --filter \"newer_than:7d has:attachment\" # recent with attachments\nspark emails --page 2 --page-size 20 # pagination\nspark emails --order ascending # oldest first\nspark emails --new-senders # show only new sender emails","type":"text"}]},{"type":"paragraph","content":[{"text":"GateKeeper filtering:","type":"text","marks":[{"type":"strong"}]},{"text":" When viewing the Inbox with GateKeeper in explicit mode, new sender emails are automatically filtered out and a \"New Senders\" count is shown at the top. Use ","type":"text"},{"text":"--new-senders","type":"text","marks":[{"type":"code_inline"}]},{"text":" to view those emails. Use ","type":"text"},{"text":"contact-action acceptContact \u003cemail>","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"contact-action blockContact \u003cemail>","type":"text","marks":[{"type":"code_inline"}]},{"text":" to accept or block a sender.","type":"text"}]},{"type":"paragraph","content":[{"text":"Folder identifier formats","type":"text","marks":[{"type":"strong"}]},{"text":" (run ","type":"text"},{"text":"folders","type":"text","marks":[{"type":"code_inline"}]},{"text":" to see available ones):","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Format","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Example","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Meaning","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Bare name","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Inbox","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"Archive","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Unified folder (cross-account)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"email","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"[email protected]","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Account inbox shorthand","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"email:Folder","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"[email protected]:Archive","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Specific account folder","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\"Team Name\"","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\"My Team\"","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"All shared threads in a team (quote if spaces)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"shared@email:Inbox","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"[email protected]:Inbox","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Shared inbox open items (conversation view, matches Desktop)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"shared@email:Archive","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"[email protected]:Archive","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Shared inbox done/archived items (conversation view)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"shared@email:Folder","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"[email protected]:Label","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Other shared inbox folder / label","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Filter operators","type":"text","marks":[{"type":"strong"}]},{"text":" (combinable, Gmail-style):","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Operator","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Example","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"from:\u003caddr>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"from:[email protected]","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"to:\u003caddr>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"to:[email protected]","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"cc:\u003caddr>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"cc:[email protected]","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"subject:\u003ctext>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"subject:\"quarterly report\"","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"before:yyyy/MM/dd","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"before:2026/03/01","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"after:yyyy/MM/dd","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"after:2026/01/01","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"newer_than:Xd","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"newer_than:7d","type":"text","marks":[{"type":"code_inline"}]},{"text":" (also ","type":"text"},{"text":"w","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"m","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"y","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"older_than:Xd","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"older_than:30d","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"has:attachment","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"also ","type":"text"},{"text":"document","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"spreadsheet","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"presentation","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"reminder","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"is:unread","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"also ","type":"text"},{"text":"read","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"starred","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"pinned","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"unreplied","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"is:shared","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"emails shared to any team (alias for ","type":"text"},{"text":"is:shared_email","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"is:shared_inbox_open","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"open items in shared inbox","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"is:shared_inbox_done","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"completed/closed items in shared inbox","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"category:personal","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"also ","type":"text"},{"text":"priority","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"notification","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"newsletter","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"invitation","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"invitation_response","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"assigned_to:me","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"emails assigned to current user","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"assigned_to:\u003cemail>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"emails assigned to specific teammate","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"assigned_to:unassigned","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"shared inbox items with no assignee","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"assigned_to:other","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"emails assigned to someone else (not me)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"assigned_by:me","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"emails delegated by current user","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"filename:\u003cname>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"filename:report.pdf","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"search","type":"text"}]},{"type":"paragraph","content":[{"text":"Two modes:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"With a topic (keyword mode):","type":"text","marks":[{"type":"strong"}]},{"text":" Hybrid keyword + semantic search returning up to 20 emails with full bodies, sorted by relevance.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Without a topic (list mode):","type":"text","marks":[{"type":"strong"}]},{"text":" Paged compact table of every email matching ","type":"text"},{"text":"--filter","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--in","type":"text","marks":[{"type":"code_inline"}]},{"text":" across all folders and all accounts, sorted newest first. Same output as ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":", but the default scope is \"all folders\" instead of the Unified Inbox. Trash, Spam, and Blocked are excluded (matching Spark's search field) unless ","type":"text"},{"text":"--in","type":"text","marks":[{"type":"code_inline"}]},{"text":" explicitly targets one of those folders.","type":"text"}]}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark search \"quarterly report\"\nspark search \"API integration\" --filter \"from:[email protected]\"\nspark search \"budget\" --in [email protected]:Archive\nspark search \"vacation\" --in [email protected] # all folders in account\n\n# Keywordless list mode - filter across every folder\nspark search --filter \"from:[email protected]\" # every email from alice, all folders\nspark search --filter \"from:[email protected]\" --in [email protected]\nspark search --filter \"is:unread newer_than:7d\" --page 2","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\u003cabout>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Search topic (positional). Omit to switch to list mode.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--filter","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Gmail-style filter (same operators as ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--in","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Scope: account, team, folder, or shared inbox. All folders if omitted.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--page","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Page number, 1-based (default: 1). List mode only.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--page-size","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Emails per page (default: 50). List mode only.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--order","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Sort order: ","type":"text"},{"text":"ascending","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"descending","type":"text","marks":[{"type":"code_inline"}]},{"text":". List mode only.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Use ","type":"text","marks":[{"type":"strong"}]},{"text":"search","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" with a topic when the user asks about content","type":"text","marks":[{"type":"strong"}]},{"text":" - it returns email bodies so you can answer questions. ","type":"text"},{"text":"Use ","type":"text","marks":[{"type":"strong"}]},{"text":"search","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" without a topic when you need to filter emails (especially by ","type":"text","marks":[{"type":"strong"}]},{"text":"from:","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":") across every folder","type":"text","marks":[{"type":"strong"}]},{"text":" - ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":" only sees the Unified Inbox so it can't answer questions like \"every email from [email protected], anywhere\". Use ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":" for plain browsing of Inbox / one folder.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"thread","type":"text"}]},{"type":"paragraph","content":[{"text":"Print every message in a thread - headers, full plain-text bodies, and attachment info. After the thread summary line, lists ","type":"text"},{"text":"custom (non-system) folder labels","type":"text","marks":[{"type":"strong"}]},{"text":" once for the whole thread, using qualified names like ","type":"text"},{"text":"[email protected]:MyLabel","type":"text","marks":[{"type":"code_inline"}]},{"text":" (same style as ","type":"text"},{"text":"folders","type":"text","marks":[{"type":"code_inline"}]},{"text":").","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark thread 1114 # by message ID from emails/search output\nspark thread --download-attachments 1114 # also fetch attachments via IMAP\nspark thread \"https://sparkmailapp.com/dpl/bl?token=ABC...\" # by Spark deep link","type":"text"}]},{"type":"paragraph","content":[{"text":"The positional argument accepts either a numeric message ID (the ","type":"text"},{"text":"ID:","type":"text","marks":[{"type":"code_inline"}]},{"text":" line) or a Spark deep link (the ","type":"text"},{"text":"Link:","type":"text","marks":[{"type":"code_inline"}]},{"text":" line) printed by a previous run - ","type":"text"},{"text":"https://sparkmailapp.com/dpl/bl?token=...","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"readdle-spark://bl=...","type":"text","marks":[{"type":"code_inline"}]},{"text":", or ","type":"text"},{"text":"readdlespark://bl=...","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"A ","type":"text"},{"text":"Reply-To:","type":"text","marks":[{"type":"code_inline"}]},{"text":" line appears only when that header points somewhere other than ","type":"text"},{"text":"From","type":"text","marks":[{"type":"code_inline"}]},{"text":" - mailing lists and website contact forms carry the real correspondent there. ","type":"text"},{"text":"draft --reply-to","type":"text","marks":[{"type":"code_inline"}]},{"text":" already addresses the reply to it, so don't pass ","type":"text"},{"text":"--to","type":"text","marks":[{"type":"code_inline"}]},{"text":" yourself.","type":"text"}]},{"type":"paragraph","content":[{"text":"Each message's ","type":"text"},{"text":"Attachments:","type":"text","marks":[{"type":"code_inline"}]},{"text":" block is a table with columns ","type":"text"},{"text":"ID","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"Name","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"Size","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"MIME Type","type":"text","marks":[{"type":"code_inline"}]},{"text":", and ","type":"text"},{"text":"Path","type":"text","marks":[{"type":"code_inline"}]},{"text":". The ","type":"text"},{"text":"ID","type":"text","marks":[{"type":"code_inline"}]},{"text":" column is the attachment's stable pk - feed it to ","type":"text"},{"text":"attachment","type":"text","marks":[{"type":"code_inline"}]},{"text":" to read the file contents (auto-downloads if necessary). The ","type":"text"},{"text":"Path","type":"text","marks":[{"type":"code_inline"}]},{"text":" column shows the local file or ","type":"text"},{"text":"(not downloaded, ...)","type":"text","marks":[{"type":"code_inline"}]},{"text":" for attachments not yet fetched.","type":"text"}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"search","type":"text","marks":[{"type":"code_inline"}]},{"text":" to find message IDs (the ID column), then ","type":"text"},{"text":"thread","type":"text","marks":[{"type":"code_inline"}]},{"text":" to read the full conversation. Use ","type":"text"},{"text":"folders","type":"text","marks":[{"type":"code_inline"}]},{"text":" to list valid label identifiers for ","type":"text"},{"text":"action attachLabel","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"detachLabel","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"attachment","type":"text"}]},{"type":"paragraph","content":[{"text":"Read a single email attachment by its ID (pk) from the ","type":"text"},{"text":"thread","type":"text","marks":[{"type":"code_inline"}]},{"text":" Attachments table. The file is auto-downloaded if it isn't cached locally yet.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark attachment 42 # print metadata (ID, Name, Size, MIME Type, Path, Message ID)\nspark attachment 42 --stream > report.pdf # write raw file bytes to stdout","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\u003cid>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Attachment ID (pk) from the ","type":"text"},{"text":"thread","type":"text","marks":[{"type":"code_inline"}]},{"text":" Attachments table.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--stream","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Write the raw file bytes to stdout instead of metadata text. Useful inside sandboxed agents that can read the CLI's stdout but not local filesystem paths. The CLI streams the file in 64 KB chunks, so there is no practical size limit. To go the other way - attach a file the app can't read - pipe it into ","type":"text"},{"text":"draft","type":"text","marks":[{"type":"code_inline"}]},{"text":"/","type":"text"},{"text":"comment","type":"text","marks":[{"type":"code_inline"}]},{"text":" with ","type":"text"},{"text":"--attach-stream","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"thread","type":"text","marks":[{"type":"code_inline"}]},{"text":" to find attachment IDs (the ","type":"text"},{"text":"ID","type":"text","marks":[{"type":"code_inline"}]},{"text":" column in the ","type":"text"},{"text":"Attachments:","type":"text","marks":[{"type":"code_inline"}]},{"text":" table). The default text output is one ","type":"text"},{"text":"Key: value","type":"text","marks":[{"type":"code_inline"}]},{"text":" per line, easy to parse from scripts.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"draft","type":"text"}]},{"type":"paragraph","content":[{"text":"Requires: triage","type":"text","marks":[{"type":"strong"}]},{"text":" access level.","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a new email draft or edit an existing one. The body is written in markdown and converted to HTML.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark draft --to \"[email protected]\" --subject \"Hello\" --body \"Hi Alice, ...\"\nspark draft --to \"[email protected]\" --to \"[email protected]\" --cc \"[email protected]\" --subject \"Meeting\" --body \"...\"\nspark draft --edit 1234 --subject \"Updated subject\" --body \"Updated body\"\nspark draft --reply-to 5678 --body \"Thanks for the update!\"\nspark draft --reply-all 5678 --body \"Thanks everyone!\" # keeps the other recipients and the CCs\nspark draft --forward 5678 --to \"[email protected]\" --body \"FYI\"\nspark draft --account \"[email protected]\" --to \"[email protected]\" --subject \"Hi\" --body \"...\"\nspark draft signatures # the signature each account appends\nspark draft --to \"[email protected]\" --subject \"Quick note\" --body \"...\" --no-signature # send without a signature\nspark draft --edit 1234 --no-signature # strip the signature from an existing draft\nspark draft --to \"[email protected]\" --subject \"Report\" --body \"See attached\" --attach /path/to/report.pdf\nspark draft --to \"[email protected]\" --subject \"Files\" --body \"Two files\" --attach /path/to/a.pdf --attach /path/to/b.xlsx\nspark draft --to \"[email protected]\" --subject \"Q3\" --body

Using spark is a CLI for the Spark email client. Use it to query the user's mailbox, calendar, contacts, meetings, and team data. Running spark Environment: is a thin client that talks over IPC to the user's running Spark Desktop app - it does not ship its own mailbox, network stack, or credentials. Run it directly on the user's computer against the live Spark Desktop process. Do not try to execute it inside a sandbox, container, CI runner, or any environment isolated from the user's desktop session - it will fail to connect. If Spark Desktop is not running, ask the user to launch it instead…

Revenue is up:\\n\\n![Q3 revenue](chart.png)' --attach /path/to/chart.png # show an attached image in the text\nspark draft --reply-to 5678 --body \"Resending the file\" --attach-id 42 # attach a file from the original email\ncat report.pdf | spark draft --to \"[email protected]\" --subject \"Report\" --body \"See attached\" --attach-stream report.pdf # pipe a file the app can't read directly\nspark draft --to \"[email protected]\" --subject \"Proposal\" --body \"...\" --team \"Engineering\" --user [email protected] --user [email protected]\nspark draft --edit 1234 --team \"Engineering\" --user [email protected] --allow-send\nspark draft --edit 1234 --user [email protected] # invite carol on an already-shared draft\nspark draft --edit 1234 --allow-send # grant send-on-behalf permission on an already-shared draft\nspark draft --edit 1234 --no-allow-send # revoke previously-granted send-on-behalf permission\nspark draft --edit 1234 --remove-user [email protected] # kick alice from a shared draft (keeps share, comments, other collaborators)\nspark draft --edit 1234 --remove-user [email protected] --user [email protected] # swap collaborators: remove alice, invite dave\nspark draft --edit 1234 --unshare\nspark draft --delete 1234 # remove the draft for good (no Trash, no undo)\nspark draft --template \"Cold outbound v3\" --to \"[email protected]\" --placeholder \"Project name=Acme Q3\" --placeholder \"Deadline=Friday EOD\"\nspark draft --template 124 --edit 9821 --placeholder \"Project name=Acme Q3\" --placeholder \"Deadline=Friday EOD\"","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--to","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Recipient address (RFC822). Repeat for multiple.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--cc","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"CC address. Repeat for multiple.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--bcc","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"BCC address. Repeat for multiple.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--subject","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Subject line.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--body","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes (new, no ","type":"text"},{"text":"--template","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Body content in markdown. Required for new drafts unless a template provides one. ","type":"text"},{"text":"![alt](file name)","type":"text","marks":[{"type":"code_inline"}]},{"text":" shows an attached image in the text - see ","type":"text"},{"text":"Images in the body","type":"text","marks":[{"type":"strong"}]},{"text":" below.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--edit","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Message ID of an existing draft to update.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--reply-to","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Message ID to reply to. Addresses the sender alone (or the ","type":"text"},{"text":"Reply-To:","type":"text","marks":[{"type":"code_inline"}]},{"text":" address when the message carries one).","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--reply-all","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Message ID to reply to, keeping everyone else on the thread: the other ","type":"text"},{"text":"To:","type":"text","marks":[{"type":"code_inline"}]},{"text":" recipients land in To, the original ","type":"text"},{"text":"Cc:","type":"text","marks":[{"type":"code_inline"}]},{"text":" in CC, minus your own address. Mutually exclusive with ","type":"text"},{"text":"--reply-to","type":"text","marks":[{"type":"code_inline"}]},{"text":"; ","type":"text"},{"text":"--to","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--cc","type":"text","marks":[{"type":"code_inline"}]},{"text":" override the lists it builds.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--forward","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Message ID to forward.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--delete","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Message ID of a draft to delete ","type":"text"},{"text":"permanently","type":"text","marks":[{"type":"strong"}]},{"text":". Must be the only option on the command. Drafts have no Trash, so the deletion cannot be undone. A scheduled draft and a draft shared with teammates are both refused - ","type":"text"},{"text":"action unschedule","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"draft --edit \u003cpk> --unshare","type":"text","marks":[{"type":"code_inline"}]},{"text":" first.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--account","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Account email to send from. Accepts a regular mail account, an alias, or a shared inbox email.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--attach","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Absolute path to a file to attach. Repeat for multiple. The Spark app must be able to read the path; in the sandboxed App Store build a path outside the app's container can't be read and is rejected with a clear error - pipe the file with ","type":"text"},{"text":"--attach-stream","type":"text","marks":[{"type":"code_inline"}]},{"text":" instead. Max 25 MB per file.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--attach-id","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"ID of an attachment on an existing email to copy onto this draft, from the Attachments table of ","type":"text"},{"text":"thread \u003cmessage-id>","type":"text","marks":[{"type":"code_inline"}]},{"text":". Repeat for multiple. Use this to re-send a file the user received - replies don't inherit attachments (only ","type":"text"},{"text":"--forward","type":"text","marks":[{"type":"code_inline"}]},{"text":" does).","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--attach-stream","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Attach a single file whose bytes are read from stdin, shown to recipients as ","type":"text"},{"text":"\u003cname>","type":"text","marks":[{"type":"code_inline"}]},{"text":". Use this when the file is outside the app's sandbox (the App Store build can't read arbitrary paths) - it's the inbound twin of ","type":"text"},{"text":"attachment --stream","type":"text","marks":[{"type":"code_inline"}]},{"text":". One streamed file per command; combine with ","type":"text"},{"text":"--attach","type":"text","marks":[{"type":"code_inline"}]},{"text":" for paths the app can read. Max 25 MB. Example: ","type":"text"},{"text":"cat report.pdf | spark draft --edit 123 --attach-stream report.pdf","type":"text","marks":[{"type":"code_inline"}]},{"text":". Needs a real stdin, so it only works when you run the ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code_inline"}]},{"text":" binary yourself - otherwise use ","type":"text"},{"text":"--attach-id","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--attach","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--team","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Team name. Required when you belong to multiple teams. When editing a draft that's already shared, must match the team that owns the share.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--user","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Teammate email to share with. Repeat for multiple. On an already-shared draft this ","type":"text"},{"text":"adds","type":"text","marks":[{"type":"strong"}]},{"text":" collaborators without removing existing ones - use ","type":"text"},{"text":"--remove-user","type":"text","marks":[{"type":"code_inline"}]},{"text":" to remove someone.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--remove-user","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Teammate email to ","type":"text"},{"text":"remove","type":"text","marks":[{"type":"strong"}]},{"text":" from an already-shared draft. Repeat for multiple. The shared draft, its comments, and the remaining collaborators are preserved (unlike ","type":"text"},{"text":"--unshare","type":"text","marks":[{"type":"code_inline"}]},{"text":", which tears the whole share down). Requires ","type":"text"},{"text":"--edit \u003cshared-pk>","type":"text","marks":[{"type":"code_inline"}]},{"text":". Cannot remove yourself - use ","type":"text"},{"text":"--unshare","type":"text","marks":[{"type":"code_inline"}]},{"text":" for that. Can be combined with ","type":"text"},{"text":"--user","type":"text","marks":[{"type":"code_inline"}]},{"text":" in one command to swap collaborators; removals run before invites.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--allow-send","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Grant teammates permission to send the shared draft on your behalf. New share: defaults to off when omitted. Edit of a shared draft: leaves the current value alone when omitted. Mutually exclusive with ","type":"text"},{"text":"--no-allow-send","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--no-allow-send","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Revoke teammates' permission to send the shared draft on your behalf. Useful when editing a shared draft whose allow-send is currently on. Mutually exclusive with ","type":"text"},{"text":"--allow-send","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--unshare","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Revert an already-shared draft back to a personal draft. Requires ","type":"text"},{"text":"--edit","type":"text","marks":[{"type":"code_inline"}]},{"text":" and is mutually exclusive with ","type":"text"},{"text":"--team","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--user","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--remove-user","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--allow-send","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--no-allow-send","type":"text","marks":[{"type":"code_inline"}]},{"text":" ","type":"text"},{"text":"and","type":"text","marks":[{"type":"strong"}]},{"text":" with content edits (","type":"text"},{"text":"--to","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--cc","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--bcc","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--subject","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--body","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--attach","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--attach-id","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--attach-stream","type":"text","marks":[{"type":"code_inline"}]},{"text":") - issue the edit (or per-user removal) and the unshare as separate commands.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--template","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Apply a saved template by ID or name. Combine with ","type":"text"},{"text":"--edit","type":"text","marks":[{"type":"code_inline"}]},{"text":" to overlay onto an existing draft.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--placeholder","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"When template has manual placeholders","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Fill a manual template placeholder, format ","type":"text"},{"text":"\"\u003cname>=\u003cvalue>\"","type":"text","marks":[{"type":"code_inline"}]},{"text":". Repeat for each. Auto-fillable placeholders (recipient/self names) are not addressable here - control them via ","type":"text"},{"text":"--to","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"--account","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--no-signature","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Send without a signature. Suppresses the account's per-mailbox default signature for this draft. On ","type":"text"},{"text":"--edit","type":"text","marks":[{"type":"code_inline"}]},{"text":" it strips a signature already on the draft (the body and quoted thread are kept). Omit the flag to keep using the account default.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"signatures","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Positional, not a flag: prints every mailbox you can draft from with the signature it appends. Must be the only argument.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Explicit flags always win over template fields. Use ","type":"text"},{"text":"template \u003cid|name>","type":"text","marks":[{"type":"code_inline"}]},{"text":" to discover the template's manual placeholders before calling ","type":"text"},{"text":"draft --template","type":"text","marks":[{"type":"code_inline"}]},{"text":" - missing manual placeholders cause a hard error before any draft is created. Auto-fillable placeholders that fail to resolve (e.g. recipient name with multiple ","type":"text"},{"text":"--to","type":"text","marks":[{"type":"code_inline"}]},{"text":") leave a localized label in the body and surface in the response as a warning.","type":"text"}]},{"type":"paragraph","content":[{"text":"Images in the body.","type":"text","marks":[{"type":"strong"}]},{"text":" To put an image in the text instead of the attachment list, attach it and show it with markdown image syntax by its file name: ","type":"text"},{"text":"--attach /path/to/chart.png --body \"![Q3 revenue](chart.png)\"","type":"text","marks":[{"type":"code_inline"}]},{"text":". The file can come from ","type":"text"},{"text":"--attach","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"--attach-stream","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"--attach-id","type":"text","marks":[{"type":"code_inline"}]},{"text":", or already be on the draft. An ","type":"text"},{"text":"https://","type":"text","marks":[{"type":"code_inline"}]},{"text":" image address is left as it is. A local image that matches no attached file, or a file that isn't an image, is an error, so a draft never goes out with a broken image. On ","type":"text"},{"text":"--edit","type":"text","marks":[{"type":"code_inline"}]},{"text":" with ","type":"text"},{"text":"--body","type":"text","marks":[{"type":"code_inline"}]},{"text":", the new body decides which images stay: show an image already on the draft by its name (as ","type":"text"},{"text":"thread \u003cdraft-id>","type":"text","marks":[{"type":"code_inline"}]},{"text":" lists it) to keep it, leave it out to remove it.","type":"text"}]},{"type":"paragraph","content":[{"text":"The signature is added for you - never write your own sign-off.","type":"text","marks":[{"type":"strong"}]},{"text":" Spark appends the mailbox's default signature to the body of every draft. ","type":"text"},{"text":"spark draft signatures","type":"text","marks":[{"type":"code_inline"}]},{"text":" prints what each mailbox you can draft from appends.","type":"text"}]},{"type":"paragraph","content":[{"text":"When the user asks for a closing that differs from their signature, pass ","type":"text"},{"text":"--no-signature","type":"text","marks":[{"type":"code_inline"}]},{"text":" and write the whole closing yourself.","type":"text"}]},{"type":"paragraph","content":[{"text":"On success the output includes the draft's ","type":"text"},{"text":"ID:","type":"text","marks":[{"type":"code_inline"}]},{"text":" (use it with ","type":"text"},{"text":"--edit","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"action send","type":"text","marks":[{"type":"code_inline"}]},{"text":") and a ","type":"text"},{"text":"Link:","type":"text","marks":[{"type":"code_inline"}]},{"text":" line with a Spark deep link (","type":"text"},{"text":"https://sparkmailapp.com/dpl/bl?token=...","type":"text","marks":[{"type":"code_inline"}]},{"text":") that opens the draft directly in Spark. It also echoes the composed body under ","type":"text"},{"text":"Body:","type":"text","marks":[{"type":"code_inline"}]},{"text":" - the whole message as the recipient will read it, signature included and quoted thread left out. Read it back to confirm the draft says what you meant, and to catch a sign-off of your own standing next to the account's.","type":"text"}]},{"type":"paragraph","content":[{"text":"Always give the user the deep link.","type":"text","marks":[{"type":"strong"}]},{"text":" After creating or updating a draft, include the ","type":"text"},{"text":"Link:","type":"text","marks":[{"type":"code_inline"}]},{"text":" URL in your response as a clickable markdown link (e.g. ","type":"text"},{"text":"[Open draft in Spark](https://sparkmailapp.com/dpl/bl?token=...)","type":"text","marks":[{"type":"code_inline"}]},{"text":") so the user can jump straight to the draft to review or send it. Do not tell the user to open Spark and hunt for the draft manually.","type":"text"}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":" to find message IDs for ","type":"text"},{"text":"--edit","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"--reply-to","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"--reply-all","type":"text","marks":[{"type":"code_inline"}]},{"text":", and ","type":"text"},{"text":"--forward","type":"text","marks":[{"type":"code_inline"}]},{"text":". Use ","type":"text"},{"text":"accounts","type":"text","marks":[{"type":"code_inline"}]},{"text":" to find account emails for ","type":"text"},{"text":"--account","type":"text","marks":[{"type":"code_inline"}]},{"text":" - personal accounts, their ","type":"text"},{"text":"Alias:","type":"text","marks":[{"type":"code_inline"}]},{"text":" entries, and shared inboxes are all listed there, and any of them can be used as the from address when the account has draft & comment access. Use ","type":"text"},{"text":"teams","type":"text","marks":[{"type":"code_inline"}]},{"text":" to find team names for ","type":"text"},{"text":"--team","type":"text","marks":[{"type":"code_inline"}]},{"text":" and team member emails for ","type":"text"},{"text":"--user","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Threading is critical.","type":"text","marks":[{"type":"strong"}]},{"text":" Whenever a new message belongs to an existing conversation, you ","type":"text"},{"text":"must","type":"text","marks":[{"type":"strong"}]},{"text":" pass ","type":"text"},{"text":"--reply-to","type":"text","marks":[{"type":"code_inline"}]},{"text":" with the ","type":"text"},{"text":"last message in that thread","type":"text","marks":[{"type":"strong"}]},{"text":". This is what attaches the draft to the conversation (correct In-Reply-To / References headers, same thread in the recipient's mailbox). Without ","type":"text"},{"text":"--reply-to","type":"text","marks":[{"type":"code_inline"}]},{"text":" the draft starts a brand new thread, which is almost always wrong when the user asked you to \"reply\", \"respond\", \"follow up\", \"answer\", or \"ping\" anyone in the context of an existing conversation. Use ","type":"text"},{"text":"thread \u003cid>","type":"text","marks":[{"type":"code_inline"}]},{"text":" to inspect the conversation and pick the most recent message's ID as ","type":"text"},{"text":"--reply-to","type":"text","marks":[{"type":"code_inline"}]},{"text":". On a thread with several participants, use ","type":"text"},{"text":"--reply-all","type":"text","marks":[{"type":"code_inline"}]},{"text":" unless the user wants a private answer to the sender.","type":"text"}]},{"type":"paragraph","content":[{"text":"Follow-ups (no response yet).","type":"text","marks":[{"type":"strong"}]},{"text":" When the user asks to follow up with someone you already emailed and they haven't replied yet (e.g. \"send Alice a nudge - she never responded to my last email\", \"bump the proposal thread\"), the most recent message in that thread is your own outgoing one. Use that message's ID as ","type":"text"},{"text":"--reply-to","type":"text","marks":[{"type":"code_inline"}]},{"text":" - the follow-up stays attached to the original outgoing message so the recipient sees it as a bump on the existing conversation rather than a new cold email.","type":"text"}]},{"type":"paragraph","content":[{"text":"Sharing is triggered by the presence of ","type":"text"},{"text":"--team","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"--user","type":"text","marks":[{"type":"code_inline"}]},{"text":"; teams with exactly one other active member auto-share with everyone, otherwise ","type":"text"},{"text":"--user","type":"text","marks":[{"type":"code_inline"}]},{"text":" is required. To add collaborators or change the allow-send setting on an existing shared draft, use ","type":"text"},{"text":"--edit \u003cpk>","type":"text","marks":[{"type":"code_inline"}]},{"text":" together with the sharing flags - the change is applied to the existing share instead of creating a new one. To toggle allow-send off, pass ","type":"text"},{"text":"--no-allow-send","type":"text","marks":[{"type":"code_inline"}]},{"text":". To remove a specific collaborator without tearing the share down, pass ","type":"text"},{"text":"--remove-user \u003cemail>","type":"text","marks":[{"type":"code_inline"}]},{"text":"; the shared draft, its comments, and the remaining collaborators stay intact. Combine ","type":"text"},{"text":"--user","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"--remove-user","type":"text","marks":[{"type":"code_inline"}]},{"text":" in one command to swap collaborators in a single operation - removals run before invites. Content edits (","type":"text"},{"text":"--to","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"--cc","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"--bcc","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"--subject","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"--body","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"--attach","type":"text","marks":[{"type":"code_inline"}]},{"text":") and sharing updates (","type":"text"},{"text":"--team","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"--user","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"--remove-user","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"--allow-send","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"--no-allow-send","type":"text","marks":[{"type":"code_inline"}]},{"text":") must be issued as separate ","type":"text"},{"text":"draft","type":"text","marks":[{"type":"code_inline"}]},{"text":" commands.","type":"text"}]},{"type":"paragraph","content":[{"text":"Deleting a draft is final.","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"--delete \u003cpk>","type":"text","marks":[{"type":"code_inline"}]},{"text":" removes the draft outright - unlike a received email there is no Trash to recover it from, and neither ","type":"text"},{"text":"history --undo","type":"text","marks":[{"type":"code_inline"}]},{"text":" nor Spark's own undo can bring it back. Only delete a draft the user asked you to discard, and say so plainly in your response rather than implying it can be restored. To throw away just the ","type":"text"},{"text":"text","type":"text","marks":[{"type":"em"}]},{"text":" of a draft while keeping the draft itself, edit it (","type":"text"},{"text":"draft --edit \u003cpk> --body \"...\"","type":"text","marks":[{"type":"code_inline"}]},{"text":") instead.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"templates","type":"text"}]},{"type":"paragraph","content":[{"text":"List Spark message templates - the saved drafts users can apply via ","type":"text"},{"text":"draft --template","type":"text","marks":[{"type":"code_inline"}]},{"text":". Templates round-trip from desktop, so anything saved on the user's computer shows up here.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark templates # all personal + team templates\nspark templates --personal # only personal templates\nspark templates --team \"Marketing\" # only that team's templates\nspark templates --page 2 --page-size 20 # pagination","type":"text"}]},{"type":"paragraph","content":[{"text":"Output columns: ","type":"text"},{"text":"ID","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"Scope","type":"text","marks":[{"type":"code_inline"}]},{"text":" (Personal / ","type":"text"},{"text":"\u003cteam name>","type":"text","marks":[{"type":"code_inline"}]},{"text":"), ","type":"text"},{"text":"Name","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"Subject","type":"text","marks":[{"type":"code_inline"}]},{"text":" (truncated to 40 chars), ","type":"text"},{"text":"Modified","type":"text","marks":[{"type":"code_inline"}]},{"text":". Use the ","type":"text"},{"text":"ID","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"Name","type":"text","marks":[{"type":"code_inline"}]},{"text":" value with ","type":"text"},{"text":"template \u003cid|name>","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"draft --template","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"template","type":"text"}]},{"type":"paragraph","content":[{"text":"Read-only.","type":"text","marks":[{"type":"strong"}]},{"text":" Show a single template's full contents and its placeholder requirements. Run this before ","type":"text"},{"text":"draft --template","type":"text","marks":[{"type":"code_inline"}]},{"text":" so you know which ","type":"text"},{"text":"--placeholder \"\u003cname>=\u003cvalue>\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" arguments the template needs.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark template 123 # by ID\nspark template \"Welcome reply\" # by name (case-insensitive)","type":"text"}]},{"type":"paragraph","content":[{"text":"Output includes scope, recipients, subject, body (HTML stripped to text), attachments, and a ","type":"text"},{"text":"Placeholders:","type":"text","marks":[{"type":"code_inline"}]},{"text":" section listing every placeholder in the template:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"[auto]","type":"text","marks":[{"type":"code_inline"}]},{"text":" - auto-fillable (recipient/self name). Resolved from ","type":"text"},{"text":"--to","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"--account","type":"text","marks":[{"type":"code_inline"}]},{"text":" when applied. ","type":"text"},{"text":"Not","type":"text","marks":[{"type":"strong"}]},{"text":" overridable via ","type":"text"},{"text":"--placeholder","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"[manual]","type":"text","marks":[{"type":"code_inline"}]},{"text":" - free-form placeholder. Required: must be passed as ","type":"text"},{"text":"--placeholder \"\u003cname>=\u003cvalue>\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" to ","type":"text"},{"text":"draft --template","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If a name matches more than one template, you'll get an error listing the matching IDs - disambiguate by ID.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"comment","type":"text"}]},{"type":"paragraph","content":[{"text":"Requires: triage","type":"text","marks":[{"type":"strong"}]},{"text":" access level.","type":"text"}]},{"type":"paragraph","content":[{"text":"Post a team comment (chat message) on a thread. If the thread is not yet shared, it will be shared automatically. Supports text comments, file attachments, or both. Use ","type":"text"},{"text":"--edit","type":"text","marks":[{"type":"code_inline"}]},{"text":" to update an existing comment.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark comment 1234 --body \"Looks good, let's proceed.\"\nspark comment 1234 --body \"Please review this\" --team \"Engineering\"\nspark comment 1234 --body \"FYI\" --team \"Engineering\" --user [email protected] --user [email protected]\nspark comment 1234 --attach /path/to/screenshot.png\nspark comment 1234 --body \"See attached\" --attach /path/to/report.pdf --attach /path/to/data.csv\ncat screenshot.png | spark comment 1234 --attach-stream screenshot.png # pipe a file the app can't read directly\nspark comment --edit 5678 --body \"Updated comment text\"","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\u003cmessage-id>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes (post)","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Message ID of a message in the thread to comment on.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--body","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"When no ","type":"text"},{"text":"--attach","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Comment text to post. Required when using ","type":"text"},{"text":"--edit","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--attach","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"When no ","type":"text"},{"text":"--body","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Absolute path to a file to attach. Repeat for multiple files. Each file is sent as a separate message. Cannot be used with ","type":"text"},{"text":"--edit","type":"text","marks":[{"type":"code_inline"}]},{"text":". The Spark app must be able to read the path; in the sandboxed App Store build a path outside the app's container can't be read and is rejected with a clear error - pipe the file with ","type":"text"},{"text":"--attach-stream","type":"text","marks":[{"type":"code_inline"}]},{"text":" instead. Max 25 MB per file.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--attach-stream","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"When no ","type":"text"},{"text":"--body","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Attach a single file whose bytes are read from stdin, shown as ","type":"text"},{"text":"\u003cname>","type":"text","marks":[{"type":"code_inline"}]},{"text":", sent as its own comment message. Use this when the file is outside the app's sandbox (the App Store build can't read arbitrary paths) - it's the inbound twin of ","type":"text"},{"text":"attachment --stream","type":"text","marks":[{"type":"code_inline"}]},{"text":". One streamed file per command; cannot be used with ","type":"text"},{"text":"--edit","type":"text","marks":[{"type":"code_inline"}]},{"text":". Max 25 MB. Example: ","type":"text"},{"text":"cat shot.png | spark comment 456 --attach-stream shot.png --team \"Engineering\"","type":"text","marks":[{"type":"code_inline"}]},{"text":". Needs a real stdin, so it only works when you run the ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code_inline"}]},{"text":" binary yourself - otherwise use ","type":"text"},{"text":"--attach","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--edit","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Message ID of an existing comment to edit. Requires ","type":"text"},{"text":"--body","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--team","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"When >1 team","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Team name. Required when you belong to multiple teams.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--user","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"When team >2 members","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Teammate email to share with. Repeat for multiple. Only used when auto-sharing an unshared thread. For teams with 2 or fewer members, the whole team is shared with automatically.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":" to find message IDs. Use ","type":"text"},{"text":"thread","type":"text","marks":[{"type":"code_inline"}]},{"text":" to see comment IDs in a conversation. Use ","type":"text"},{"text":"team","type":"text","marks":[{"type":"code_inline"}]},{"text":" to list teams and their members.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"events","type":"text"}]},{"type":"paragraph","content":[{"text":"List calendar events for a time range.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark events # today's remaining events\nspark events --tomorrow\nspark events --week\nspark events --week --in [email protected] # specific account\nspark events --week --in [email protected]:Work # specific calendar\nspark events --start 2026-03-16 --end 2026-03-20 # custom range\nspark events --week --include-hidden # hidden calendars too","type":"text"}]},{"type":"paragraph","content":[{"text":"Date formats: ","type":"text"},{"text":"yyyy-MM-dd","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"dd/MM/yyyy","type":"text","marks":[{"type":"code_inline"}]},{"text":", or ","type":"text"},{"text":"yyyy-MM-ddTHH:mm","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Run ","type":"text"},{"text":"accounts","type":"text","marks":[{"type":"code_inline"}]},{"text":" to see available calendar accounts and calendar names.","type":"text"}]},{"type":"paragraph","content":[{"text":"Hidden calendars:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"accounts","type":"text","marks":[{"type":"code_inline"}]},{"text":" marks a calendar ","type":"text"},{"text":"(hidden)","type":"text","marks":[{"type":"code_inline"}]},{"text":" when the user switched it off in Spark's calendar view. ","type":"text"},{"text":"events","type":"text","marks":[{"type":"code_inline"}]},{"text":" leaves hidden calendars out, the same way Spark's calendar view does. Pass ","type":"text"},{"text":"--include-hidden","type":"text","marks":[{"type":"code_inline"}]},{"text":" to add them, or name one with ","type":"text"},{"text":"--in [email protected]:Name","type":"text","marks":[{"type":"code_inline"}]},{"text":" to list just that calendar. If the user expects events that aren't listed, check ","type":"text"},{"text":"accounts","type":"text","marks":[{"type":"code_inline"}]},{"text":" for hidden calendars before concluding the calendar is empty or unsupported.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"event","type":"text"}]},{"type":"paragraph","content":[{"text":"Requires: send","type":"text","marks":[{"type":"strong"}]},{"text":" access level on the target calendar's owning account. Every mode can emit mail through the calendar service (invitations on create / update, iTIP UPDATE / CANCEL on update / delete of attendee-bearing events, an iTIP REPLY on rsvp), and attaching attendees makes the event discoverable by the provider's invitation channel independent of email, so the whole command sits at ","type":"text"},{"text":"send","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Create, update, delete, or RSVP to a calendar event, including managing its attendees. Use ","type":"text"},{"text":"--add","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--remove","type":"text","marks":[{"type":"code_inline"}]},{"text":" on ","type":"text"},{"text":"create","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"update","type":"text","marks":[{"type":"code_inline"}]},{"text":" to attach or detach attendees and send invitations / cancellations through the calendar provider (CalDAV / Google / Exchange).","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark event create --title \"Sync\" --start 2026-07-01T12:00 --end 2026-07-01T13:00\nspark event create --title \"OOO\" --start 2026-07-01 --all-day\nspark event create --title \"Standup\" --start 2026-07-01T09:00 --end 2026-07-01T09:15 --video-conference auto\nspark event create --title \"Sync\" --start 2026-07-01T10:00 --end 2026-07-01T10:30 --video-conference zoom\nspark event create --title \"1:1\" --start 2026-07-01T14:00 --end 2026-07-01T14:30 --calendar \"[email protected]:Work\"\nspark event create --title \"Sync\" --start 2026-07-01T12:00 --add \"[email protected],[email protected]\" # create + invite\nspark event update ABC-123 --title \"New title\"\nspark event update ABC-123 --location \"Room 7\"\nspark event update ABC-123 --video-conference meet # add a meeting link\nspark event update ABC-123 --add [email protected] --remove [email protected] # swap attendees\nspark event delete ABC-123\nspark event rsvp ABC-123 accept # calendar event ID\nspark event rsvp ABC-123 decline\nspark event rsvp 44268 maybe # invitation email message ID","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Parameter","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"mode","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"create","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"update","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"delete","type":"text","marks":[{"type":"code_inline"}]},{"text":", or ","type":"text"},{"text":"rsvp","type":"text","marks":[{"type":"code_inline"}]},{"text":" (positional).","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"event_id","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"For ","type":"text"},{"text":"update","type":"text","marks":[{"type":"code_inline"}]},{"text":"/","type":"text"},{"text":"delete","type":"text","marks":[{"type":"code_inline"}]},{"text":"/","type":"text"},{"text":"rsvp","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Positional, second arg. For ","type":"text"},{"text":"update","type":"text","marks":[{"type":"code_inline"}]},{"text":"/","type":"text"},{"text":"delete","type":"text","marks":[{"type":"code_inline"}]},{"text":": a calendar event ID (use ","type":"text"},{"text":"events","type":"text","marks":[{"type":"code_inline"}]},{"text":"). For ","type":"text"},{"text":"rsvp","type":"text","marks":[{"type":"code_inline"}]},{"text":": either a calendar event ID ","type":"text"},{"text":"or","type":"text","marks":[{"type":"strong"}]},{"text":" the message ID of the invitation email (use ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"thread","type":"text","marks":[{"type":"code_inline"}]},{"text":").","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"status","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"For ","type":"text"},{"text":"rsvp","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"RSVP status (positional, third arg): ","type":"text"},{"text":"accept","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"decline","type":"text","marks":[{"type":"code_inline"}]},{"text":", or ","type":"text"},{"text":"maybe","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--title","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Event title / summary.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--start","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Yes (for ","type":"text"},{"text":"create","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Start date/time (","type":"text"},{"text":"yyyy-MM-dd","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"dd/MM/yyyy","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"yyyy-MM-ddTHH:mm","type":"text","marks":[{"type":"code_inline"}]},{"text":", or ","type":"text"},{"text":"yyyy-MM-ddTHH:mm:ssXXX","type":"text","marks":[{"type":"code_inline"}]},{"text":").","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--end","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"End date/time.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--all-day","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Mark the event as all-day.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--description","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Event description / notes.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--alerts","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Comma-separated alert offsets (","type":"text"},{"text":"Ns","type":"text","marks":[{"type":"code_inline"}]},{"text":" for N seconds before, e.g. ","type":"text"},{"text":"300s,600s","type":"text","marks":[{"type":"code_inline"}]},{"text":") or absolute dates.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--location","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Event location text.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--video-conference","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Attach a video conference (value required). ","type":"text"},{"text":"auto","type":"text","marks":[{"type":"code_inline"}]},{"text":" auto-picks the account's type (recently used, else default); ","type":"text"},{"text":"meet","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"zoom","type":"text","marks":[{"type":"code_inline"}]},{"text":", or ","type":"text"},{"text":"teams","type":"text","marks":[{"type":"code_inline"}]},{"text":" selects a specific one and errors if the account doesn't support it.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--calendar","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Target calendar for ","type":"text"},{"text":"create","type":"text","marks":[{"type":"code_inline"}]},{"text":". Format: ","type":"text"},{"text":"[email protected]","type":"text","marks":[{"type":"code_inline"}]},{"text":" (account's default calendar) or ","type":"text"},{"text":"[email protected]:Name","type":"text","marks":[{"type":"code_inline"}]},{"text":" (specific named calendar). Hidden calendars work too, and saving an event in one switches it back on in Spark's calendar view.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--add","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Attendee email address(es) to invite (create / update only). Repeat the flag or pass a comma-separated list. New attendees receive an iTIP REQUEST (invitation).","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"--remove","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Attendee email address(es) to remove (update only). Repeat the flag or pass a comma-separated list. Removed attendees receive an iTIP CANCEL. The organizer cannot be removed.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Attendees (","type":"text","marks":[{"type":"strong"}]},{"text":"--add","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" / ","type":"text","marks":[{"type":"strong"}]},{"text":"--remove","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":"):","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Only valid on ","type":"text"},{"text":"create","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"update","type":"text","marks":[{"type":"code_inline"}]},{"text":"; passing them to ","type":"text"},{"text":"delete","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"rsvp","type":"text","marks":[{"type":"code_inline"}]},{"text":" is refused. Combine both in one ","type":"text"},{"text":"update","type":"text","marks":[{"type":"code_inline"}]},{"text":" to swap attendees - removals run before additions.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Adding or removing attendees always emits iTIP mail (REQUEST / CANCEL). An event with no attendees stays invisible to the calendar service's invitation channel.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Attaching attendees makes the event discoverable by the calendar provider's invitation channel (including Google Calendar's same-provider auto-add behavior), independent of email delivery - which is why the whole command requires ","type":"text"},{"text":"send","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"event update","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" semantics:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"--video-conference","type":"text","marks":[{"type":"code_inline"}]},{"text":" attaches a meeting link (","type":"text"},{"text":"meet","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"zoom","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"teams","type":"text","marks":[{"type":"code_inline"}]},{"text":", or ","type":"text"},{"text":"auto","type":"text","marks":[{"type":"code_inline"}]},{"text":") to an existing event, generated through the same path as ","type":"text"},{"text":"create","type":"text","marks":[{"type":"code_inline"}]},{"text":". On an event with attendees this is a shared change, so it sends the iTIP UPDATE.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Event with ","type":"text"},{"text":"no attendees","type":"text","marks":[{"type":"strong"}]},{"text":" → local update, no mail goes out.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Event ","type":"text"},{"text":"with attendees","type":"text","marks":[{"type":"strong"}]},{"text":" → update + iTIP UPDATE sent to all attendees so their calendars reflect the new state. Output reports the attendee count.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"An alerts-only edit is a personal reminder and notifies nobody, even on an event with attendees.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"event delete","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" semantics:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Event with ","type":"text"},{"text":"no attendees","type":"text","marks":[{"type":"strong"}]},{"text":" → local delete, no mail goes out.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Event ","type":"text"},{"text":"with attendees","type":"text","marks":[{"type":"strong"}]},{"text":" → delete + iTIP CANCEL sent to all attendees so their calendars get cleaned up too. Output reports the attendee count. Deleting without the cancellation would orphan the invitation on attendees' calendars (most visibly on Google's same-provider auto-add channel).","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"event rsvp","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" semantics:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Sets ","type":"text"},{"text":"your own","type":"text","marks":[{"type":"em"}]},{"text":" attending status on an invitation: ","type":"text"},{"text":"accept","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"decline","type":"text","marks":[{"type":"code_inline"}]},{"text":", or ","type":"text"},{"text":"maybe","type":"text","marks":[{"type":"code_inline"}]},{"text":" (alias for tentative). Responding emits an iTIP REPLY back to the organizer.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"The id can be ","type":"text"},{"text":"either","type":"text","marks":[{"type":"strong"}]},{"text":" a calendar event ID ","type":"text"},{"text":"or","type":"text","marks":[{"type":"strong"}]},{"text":" the message ID of the invitation email. Many providers (Google included) leave an unanswered invite sitting in the inbox without adding it to the calendar, so when the user asks you to respond to an invitation, look it up with ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"thread","type":"text","marks":[{"type":"code_inline"}]},{"text":" and pass that ","type":"text"},{"text":"message ID","type":"text","marks":[{"type":"strong"}]},{"text":" - you do not need a calendar event. When the invite ","type":"text"},{"text":"has","type":"text","marks":[{"type":"em"}]},{"text":" been auto-added to the calendar, a calendar event ID works too.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"For a message ID, the reply mirrors Spark Desktop: it updates the matching calendar event if one is synced, otherwise it mails the iTIP REPLY straight to the organizer (and, on ","type":"text"},{"text":"accept","type":"text","marks":[{"type":"code_inline"}]},{"text":", adds the event to your calendar).","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Errors if the target is not an invitation you can respond to (a plain email, your own organized event with no RSVP, or a provider that does not allow responding).","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"For a calendar event, re-RSVPing to the status you already hold is a no-op and reported as such.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Typical flow when scheduling a new meeting: call ","type":"text"},{"text":"event create ...","type":"text","marks":[{"type":"code_inline"}]},{"text":" to lay down the event first, confirm the time and details with the user, then call ","type":"text"},{"text":"event update \u003cevent-id> --add ...","type":"text","marks":[{"type":"code_inline"}]},{"text":" to push invitations - so the user can review (or you can revise) the event before any external email goes out. When you already have the attendees, ","type":"text"},{"text":"event create ... --add ...","type":"text","marks":[{"type":"code_inline"}]},{"text":" does both in one step.","type":"text"}]},{"type":"paragraph","content":[{"text":"Run ","type":"text"},{"text":"accounts","type":"text","marks":[{"type":"code_inline"}]},{"text":" to see writable calendars and the access level on each account.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"availability","type":"text"}]},{"type":"paragraph","content":[{"text":"Find free time slots. Without ","type":"text"},{"text":"--attendees","type":"text","marks":[{"type":"code_inline"}]},{"text":", shows the user's own availability. With ","type":"text"},{"text":"--attendees","type":"text","marks":[{"type":"code_inline"}]},{"text":", computes mutual free windows.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark availability # today\nspark availability --tomorrow\nspark availability --week --attendees [email protected]\nspark availability --start 2026-03-16 --end 2026-03-20 --attendees [email protected],[email protected]","type":"text"}]},{"type":"paragraph","content":[{"text":"Free slots are within working hours (08:00-20:00), skip weekends, and ignore events marked \"free\".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"contacts","type":"text"}]},{"type":"paragraph","content":[{"text":"Search contacts by name or email. Strict match first, then fuzzy fallback. Without a query, lists the contacts the user writes to most, most-used first. ","type":"text"},{"text":"--limit","type":"text","marks":[{"type":"code_inline"}]},{"text":" caps the list (1-1000, default 25).","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark contacts \"john\"\nspark contacts \"example.com\"\nspark contacts --limit 500 --json # most-used contacts; \"query\" is null, \"match\" is \"top\"","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"contact","type":"text"}]},{"type":"paragraph","content":[{"text":"Show one contact's details: name, other addresses, and each setting ","type":"text"},{"text":"contact-action","type":"text","marks":[{"type":"code_inline"}]},{"text":" changes. Check a sender's state before changing it - e.g. whether they are already Priority or blocked. An unknown address is an error.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark contact [email protected]\nspark contact [email protected] --json","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Field","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Changed by","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"category","type":"text","marks":[{"type":"code_inline"}]},{"text":" (","type":"text"},{"text":"personal","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"notification","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"newsletter","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"changeCategory*","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"is_priority","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"markContactAsPrimary","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"unmarkContactAsPrimary","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"notifications","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"markContactAsImportant","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"unmarkContactAsImportant","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"blocked","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"accepted","type":"text","marks":[{"type":"code_inline"}]},{"text":" (GateKeeper; neither for a new sender)","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"blockContact","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"acceptContact","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"grouped","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"grouped_in_inbox","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"groupEmailsFromContact[AndShowInInbox]","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"ungroupEmailsFromContact","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"auto_summary","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"enableAutosummaryForContact","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"disableAutosummaryForContact","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"team","type":"text"}]},{"type":"paragraph","content":[{"text":"Show team info - metadata, shared inboxes with members, full member list, assigned emails, assignment summary.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark team # list available teams\nspark team \"Readdle\" # specific team","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"meetings","type":"text"}]},{"type":"paragraph","content":[{"text":"List meeting transcripts with optional filters and pagination.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark meetings\nspark meetings --filter \"newer_than:30d\"\nspark meetings --filter \"subject:standup\" --page-size 10","type":"text"}]},{"type":"paragraph","content":[{"text":"Filter operators: ","type":"text"},{"text":"subject:\u003ctext>","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"before:yyyy/MM/dd","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"after:yyyy/MM/dd","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"newer_than:Xd","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"older_than:Xd","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"meeting","type":"text"}]},{"type":"paragraph","content":[{"text":"Read a single meeting transcript's summary. Optionally include the full transcript and/or notes.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark meeting 42 # summary only\nspark meeting --transcript 42 # include transcript\nspark meeting --notes 42 # include notes\nspark meeting --transcript --notes 42 # everything\nspark meeting \"https://sparkmailapp.com/dpl/bl?token=ABC...\" # by Spark deep link","type":"text"}]},{"type":"paragraph","content":[{"text":"The positional argument accepts either a numeric meeting message ID or a Spark deep link.","type":"text"}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"meetings","type":"text","marks":[{"type":"code_inline"}]},{"text":" to find meeting IDs.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"action","type":"text"}]},{"type":"paragraph","content":[{"text":"Requires: triage","type":"text","marks":[{"type":"strong"}]},{"text":" access level.","type":"text"}]},{"type":"paragraph","content":[{"text":"Perform an action on one or more emails. Supports standard email actions and team actions.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark action \u003caction-name> \u003cmessage-id...> [options]","type":"text"}]},{"type":"paragraph","content":[{"text":"Supported actions:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"pin","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Pin the message to keep it at the top of the list","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"unpin","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Remove the pin from the message","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"mute","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Mute the thread to stop receiving notifications","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"unmute","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Unmute a previously muted thread","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"snooze","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Snooze the message until a specific date (requires ","type":"text"},{"text":"--date","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"unsnooze","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Remove the snooze and return the message to the inbox","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"changeReminder","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Set a follow-up reminder if no reply by the date (requires ","type":"text"},{"text":"--date","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"clearReminder","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Remove the follow-up reminder from the message","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"setAside","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Set the message aside for later review","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"archive","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Archive the message, removing it from the inbox","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"moveToInbox","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Move the message back to the inbox","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"moveToTrash","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Move the message to trash","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"moveToFolder","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Move the message to a specific folder (requires ","type":"text"},{"text":"--folder","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"attachLabel","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Attach a Gmail or Spark Team label without removing other labels (requires ","type":"text"},{"text":"--folder","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"detachLabel","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Remove a Gmail or Spark Team label from the message (requires ","type":"text"},{"text":"--folder","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"markAsDone","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Mark the message as done","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"markAsUndone","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Mark the message as not done","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"markAsSeen","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Mark the message as read","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"markAsUnseen","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Mark the message as unread","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"markAsSpam","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Mark the message as spam","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"markThreadAsPriority","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Mark the thread as priority","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"unmarkThreadAsPriority","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Remove the priority mark from the thread","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"unsubscribe","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Unsubscribe from the sender or mailing list","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"changeCategoryPersonal","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Change the email category to Personal","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"changeCategoryNotification","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Change the email category to Notification","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"changeCategoryNewsletters","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Change the email category to Newsletter","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"shareInTeam","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Share the thread with teammates (requires ","type":"text"},{"text":"--team","type":"text","marks":[{"type":"code_inline"}]},{"text":" when multiple teams)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"assign","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Assign the email to a teammate (requires ","type":"text"},{"text":"--assignee","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"delegationComplete","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Mark the delegation as complete","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"delegationReopen","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Reopen a completed delegation","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"send","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" verb (requires send access):","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Sends an existing draft (created with ","type":"text"},{"text":"spark draft","type":"text","marks":[{"type":"code_inline"}]},{"text":" or in Spark Desktop) through the owning account's outbound mail pipeline. Same validation as the desktop composer: the draft must live on an account whose access level is ","type":"text"},{"text":"send","type":"text","marks":[{"type":"strong"}]},{"text":" (Settings -> AI Agents), have at least one recipient, a non-empty subject, all attachments uploaded, and no unresolved manual template placeholders.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark action send 1234","type":"text"}]},{"type":"paragraph","content":[{"text":"Output reports the original draft ID and the PK of the sent message:","type":"text"}]},{"type":"paragraph","content":[{"text":"Draft 1234 sent. Sent message ID: 5678.","type":"text","marks":[{"type":"code_inline"}]}]},{"type":"paragraph","content":[{"text":"Typical flow: ","type":"text"},{"text":"spark draft ...","type":"text","marks":[{"type":"code_inline"}]},{"text":" to compose, review the draft, then ","type":"text"},{"text":"spark action send \u003cpk>","type":"text","marks":[{"type":"code_inline"}]},{"text":" to commit. Splitting the two operations means you (or the user) can edit the draft before any external mail is emitted - ","type":"text"},{"text":"spark draft","type":"text","marks":[{"type":"code_inline"}]},{"text":" alone never sends.","type":"text"}]},{"type":"paragraph","content":[{"text":"send","type":"text","marks":[{"type":"code_inline"}]},{"text":" accepts multiple draft IDs in one call (each runs through validation independently and the response reports per-draft success/failure), but the common case is a single id.","type":"text"}]},{"type":"paragraph","content":[{"text":"Scheduled send (\"Send Later\"):","type":"text","marks":[{"type":"strong"}]},{"text":" pass an optional ","type":"text"},{"text":"--date","type":"text","marks":[{"type":"code_inline"}]},{"text":" to schedule the draft instead of sending it now. The date must be in the future (formats: ","type":"text"},{"text":"yyyy-MM-dd","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"dd/MM/yyyy","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"yyyy-MM-ddTHH:mm","type":"text","marks":[{"type":"code_inline"}]},{"text":"); a past or malformed date is rejected before anything is sent.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark action send 1234 --date 2026-04-10T09:00","type":"text"}]},{"type":"paragraph","content":[{"text":"Output confirms the schedule: ","type":"text"},{"text":"Draft 1234 scheduled to send on 2026-04-10 09:00. Message ID: 5678.","type":"text","marks":[{"type":"code_inline"}]},{"text":" The message sits in the outbox and is delivered at that time.","type":"text"}]},{"type":"paragraph","content":[{"text":"Manage an already-scheduled (\"Send Later\") message","type":"text","marks":[{"type":"strong"}]},{"text":" by targeting its message ID with ","type":"text"},{"text":"send","type":"text","marks":[{"type":"code_inline"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Reschedule:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"send","type":"text","marks":[{"type":"code_inline"}]},{"text":" with a new ","type":"text"},{"text":"--date","type":"text","marks":[{"type":"code_inline"}]},{"text":" updates the existing schedule (it is no longer a plain draft, so this does not create a new message):","type":"text"}]}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark action send 5678 --date 2026-04-12T15:00","type":"text"}]},{"type":"paragraph","content":[{"text":"Output: ","type":"text"},{"text":"Message 5678 rescheduled to send on 2026-04-12 15:00. Message ID: 5678.","type":"text","marks":[{"type":"code_inline"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Send now:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"send","type":"text","marks":[{"type":"code_inline"}]},{"text":" with no ","type":"text"},{"text":"--date","type":"text","marks":[{"type":"code_inline"}]},{"text":" drops the schedule and sends it immediately:","type":"text"}]}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark action send 5678","type":"text"}]},{"type":"paragraph","content":[{"text":"Output: ","type":"text"},{"text":"Scheduled message 5678 sent now. Message ID: 5678.","type":"text","marks":[{"type":"code_inline"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Unschedule:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"unschedule","type":"text","marks":[{"type":"code_inline"}]},{"text":" cancels the schedule and returns the message to drafts (so you can edit it or send it later):","type":"text"}]}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark action unschedule 5678","type":"text"}]},{"type":"paragraph","content":[{"text":"Output: ","type":"text"},{"text":"Message 5678 unscheduled - returned to drafts. Find it in the Drafts folder.","type":"text","marks":[{"type":"code_inline"}]},{"text":" Clearing the schedule mints a fresh draft, so the original ID (5678) no longer resolves - re-list the Drafts folder to get the new draft ID before editing or sending it.","type":"text"}]},{"type":"paragraph","content":[{"text":"Both ","type":"text"},{"text":"send","type":"text","marks":[{"type":"code_inline"}]},{"text":" (with or without ","type":"text"},{"text":"--date","type":"text","marks":[{"type":"code_inline"}]},{"text":") on a scheduled message and ","type":"text"},{"text":"unschedule","type":"text","marks":[{"type":"code_inline"}]},{"text":" require send access on the owning account.","type":"text"}]},{"type":"paragraph","content":[{"text":"Options:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"--date","type":"text","marks":[{"type":"code_inline"}]},{"text":" - required for ","type":"text"},{"text":"snooze","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"changeReminder","type":"text","marks":[{"type":"code_inline"}]},{"text":", optional for ","type":"text"},{"text":"assign","type":"text","marks":[{"type":"code_inline"}]},{"text":" as due date (formats: ","type":"text"},{"text":"yyyy-MM-dd","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"dd/MM/yyyy","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"yyyy-MM-ddTHH:mm","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"--folder","type":"text","marks":[{"type":"code_inline"}]},{"text":" - required for ","type":"text"},{"text":"moveToFolder","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"attachLabel","type":"text","marks":[{"type":"code_inline"}]},{"text":", and ","type":"text"},{"text":"detachLabel","type":"text","marks":[{"type":"code_inline"}]},{"text":" (qualified name: ","type":"text"},{"text":"[email protected]:FolderName","type":"text","marks":[{"type":"code_inline"}]},{"text":"; use ","type":"text"},{"text":"folders","type":"text","marks":[{"type":"code_inline"}]},{"text":" to list labels including shared inboxes)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"--team","type":"text","marks":[{"type":"code_inline"}]},{"text":" - team name for team actions; required when you belong to multiple teams","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"--user","type":"text","marks":[{"type":"code_inline"}]},{"text":" - teammate email to share with for ","type":"text"},{"text":"shareInTeam","type":"text","marks":[{"type":"code_inline"}]},{"text":"; repeat for multiple users; required when team has more than 2 members","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"--assignee","type":"text","marks":[{"type":"code_inline"}]},{"text":" - teammate email to assign the email to for ","type":"text"},{"text":"assign","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"--comment","type":"text","marks":[{"type":"code_inline"}]},{"text":" - comment text for the ","type":"text"},{"text":"assign","type":"text","marks":[{"type":"code_inline"}]},{"text":" action","type":"text"}]}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark action pin 12345 # pin a message\nspark action archive 100 200 300 # archive multiple messages\nspark action markAsSeen 100 200 # mark as read\nspark action snooze 12345 --date 2026-04-10T09:00 # snooze until date/time\nspark action snooze 12345 --date 2026-04-10 # snooze until date\nspark action moveToFolder 12345 --folder \"[email protected]:Archive\" # move to folder\nspark action attachLabel 12345 --folder \"[email protected]:MyLabel\" # add Gmail/Team label\nspark action detachLabel 12345 --folder \"[email protected]:SomeLabel\" # remove label\nspark action changeReminder 12345 --date 2026-04-15 # set reminder\nspark action shareInTeam 1234 --team \"Engineering\" --user [email protected] # share with teammate\nspark action shareInTeam 1234 --user [email protected] --user [email protected] # share with multiple\nspark action assign 1234 --assignee [email protected] # assign to teammate\nspark action assign 1234 --assignee [email protected] --date 2026-04-15 --comment \"Please review\"\nspark action delegationComplete 1234 # mark delegation done\nspark action delegationComplete 100 200 300 # complete multiple delegations\nspark action delegationReopen 1234 # reopen delegation","type":"text"}]},{"type":"paragraph","content":[{"text":"Use the ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":" command to find message IDs. Use ","type":"text"},{"text":"folders","type":"text","marks":[{"type":"code_inline"}]},{"text":" to resolve qualified names for ","type":"text"},{"text":"moveToFolder","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"attachLabel","type":"text","marks":[{"type":"code_inline"}]},{"text":", and ","type":"text"},{"text":"detachLabel","type":"text","marks":[{"type":"code_inline"}]},{"text":". Use ","type":"text"},{"text":"team","type":"text","marks":[{"type":"code_inline"}]},{"text":" to list teams and members for team actions.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"contact-action","type":"text"}]},{"type":"paragraph","content":[{"text":"Requires: triage","type":"text","marks":[{"type":"strong"}]},{"text":" access level.","type":"text"}]},{"type":"paragraph","content":[{"text":"Perform an action on one or more contacts by email address.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark contact-action \u003caction-name> \u003cemail...>","type":"text"}]},{"type":"paragraph","content":[{"text":"Supported actions:","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Action","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"changeCategoryPersonal","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Change the contact's email category to Personal","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"changeCategoryNotification","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Change the contact's email category to Notification","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"changeCategoryNewsletters","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Change the contact's email category to Newsletter","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"groupEmailsFromContact","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Group emails from the contact by category","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"groupEmailsFromContactAndShowInInbox","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Group emails from the contact and show in inbox","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"ungroupEmailsFromContact","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Ungroup emails from the contact","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"markContactAsImportant","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Enable notifications for the contact","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"unmarkContactAsImportant","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Disable notifications for the contact","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"markContactAsPrimary","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Mark the contact as priority (auto-prioritize emails)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"unmarkContactAsPrimary","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Remove priority mark from the contact","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"acceptContact","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Accept or unblock the contact (bypass Gatekeeper)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"blockContact","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Block the contact","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"acceptDomain","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Accept or unblock the contact's entire domain","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"blockDomain","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Block the contact's entire domain","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"enableAutosummaryForContact","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Enable auto-summary for emails from the contact","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"disableAutosummaryForContact","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Disable auto-summary for emails from the contact","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Examples:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark contact-action blockContact [email protected]\nspark contact-action acceptContact [email protected] [email protected]\nspark contact-action changeCategoryPersonal [email protected]\nspark contact-action markContactAsPrimary [email protected]\nspark contact-action enableAutosummaryForContact [email protected]","type":"text"}]},{"type":"paragraph","content":[{"text":"Use the ","type":"text"},{"text":"contacts","type":"text","marks":[{"type":"code_inline"}]},{"text":" command to look up email addresses.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Smart Categories","type":"text"}]},{"type":"paragraph","content":[{"text":"Spark automatically classifies incoming email into six categories. Use the ","type":"text"},{"text":"category:","type":"text","marks":[{"type":"code_inline"}]},{"text":" filter operator with ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"search","type":"text","marks":[{"type":"code_inline"}]},{"text":" to view mail by category, and use ","type":"text"},{"text":"action","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"contact-action","type":"text","marks":[{"type":"code_inline"}]},{"text":" to reclassify and tune.","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Category","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Filter","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Typical Content","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Priority","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"category:priority","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Auto-prioritized or manually marked as priority","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"People","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"category:personal","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Direct person-to-person email","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Notifications","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"category:notification","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Service notifications, alerts, receipts","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Newsletters","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"category:newsletter","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Subscriptions, digests, marketing","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Invites","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"category:invitation","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Calendar invitations","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Invite Responses","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"category:invitation_response","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"RSVPs, accepts, declines","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Browse by category","type":"text","marks":[{"type":"strong"}]},{"text":" (read-only):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark emails Inbox --filter \"category:priority is:unread\" # unread priority mail\nspark emails Inbox --filter \"category:personal is:unread\" # unread people mail\nspark emails Inbox --filter \"category:invitation\" # pending invites\nspark emails Inbox --filter \"category:notification is:unread\" # unread notifications\nspark emails Inbox --filter \"category:newsletter newer_than:7d\" # recent newsletters","type":"text"}]},{"type":"paragraph","content":[{"text":"Reclassify a message","type":"text","marks":[{"type":"strong"}]},{"text":" (triage):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark action changeCategoryPersonal \u003cid> # move to People\nspark action changeCategoryNotification \u003cid> # move to Notifications\nspark action changeCategoryNewsletters \u003cid> # move to Newsletters","type":"text"}]},{"type":"paragraph","content":[{"text":"Tune per-contact category rules","type":"text","marks":[{"type":"strong"}]},{"text":" (triage) - changes apply to all future mail from the sender:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark contact-action changeCategoryPersonal [email protected] # reclassify as People\nspark contact-action changeCategoryNewsletters [email protected] # reclassify as Newsletters\nspark contact-action groupEmailsFromContact [email protected] # group by category\nspark contact-action markContactAsImportant [email protected] # enable notifications\nspark contact-action markContactAsPrimary [email protected] # auto-prioritize\nspark contact-action enableAutosummaryForContact [email protected] # AI summaries","type":"text"}]},{"type":"paragraph","content":[{"text":"Category-first triage pattern:","type":"text","marks":[{"type":"strong"}]},{"text":" Process inbox in priority order - priority first, then people, then invites, then notifications, then newsletters. This ensures the most important messages get attention first.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Typical Workflows","type":"text"}]},{"type":"paragraph","content":[{"text":"Answer a question about emails:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark search \"topic\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - find relevant emails with bodies","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Read the output and answer the user's question","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Find and read a specific email:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark emails --filter \"from:sender subject:keyword\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - locate the email","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark thread \u003cID>","type":"text","marks":[{"type":"code_inline"}]},{"text":" - read the full conversation","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Draft a reply:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark emails --filter \"from:sender\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - find the email","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark draft --reply-to \u003cID> --body \"Thanks for the update!\"","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Give the user the ","type":"text"},{"text":"Link:","type":"text","marks":[{"type":"code_inline"}]},{"text":" from the output as a clickable markdown link so they can review the draft in Spark","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Send an email from a saved template:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark templates","type":"text","marks":[{"type":"code_inline"}]},{"text":" - list templates (or ","type":"text"},{"text":"spark templates --personal","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"--team \"\u003cname>\"","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark template \"\u003cname>\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - inspect placeholders before applying","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark draft --template \"\u003cname>\" --to \u003crecipient> --placeholder \"\u003cmanual>=\u003cvalue>\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - create the draft (repeat ","type":"text"},{"text":"--placeholder","type":"text","marks":[{"type":"code_inline"}]},{"text":" for each manual one)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Check someone's schedule for a meeting:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark availability --tomorrow --attendees [email protected],[email protected]","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Suggest a time from the free slots","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Comment on a shared thread:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark emails --filter \"from:sender\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - find the email","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark comment \u003cID> --body \"Looks good, approved!\"","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"paragraph","content":[{"text":"Get team workload overview:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark team \"Team Name\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - see members and assigned emails","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Look up a contact:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark contacts \"name or domain\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - find their email address","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Perform an action on emails:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark emails --filter \"from:sender\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - find the email","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark action archive \u003cID>","type":"text","marks":[{"type":"code_inline"}]},{"text":" - archive it (or pin, snooze, etc.)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Share an email with your team:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark emails --filter \"subject:keyword\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - find the email","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark action shareInTeam \u003cID> --user [email protected]","type":"text","marks":[{"type":"code_inline"}]},{"text":" - share with a teammate","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Delegate an email to a teammate:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark emails --filter \"subject:keyword\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - find the email","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark action assign \u003cID> --assignee [email protected] --date 2026-04-15 --comment \"Please handle this\"","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"paragraph","content":[{"text":"Mark delegated emails as done:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark emails --filter \"subject:keyword\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - find the email(s)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark action delegationComplete \u003cID1> \u003cID2>","type":"text","marks":[{"type":"code_inline"}]},{"text":" - mark multiple as complete","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Find unassigned shared inbox emails:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark emails [email protected]:Inbox --filter \"assigned_to:unassigned\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - list unassigned items","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark action assign \u003cID> --assignee [email protected]","type":"text","marks":[{"type":"code_inline"}]},{"text":" - assign to a teammate","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Review what's assigned to a teammate:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark emails --filter \"assigned_to:[email protected]\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - see their assignments","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark emails --filter \"is:shared_inbox_open\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - all open shared inbox items","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark emails --filter \"is:shared_inbox_done\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - completed items","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Manage a contact:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark contacts \"name or domain\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" - find the contact email","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"spark contact-action blockContact [email protected]","type":"text","marks":[{"type":"code_inline"}]},{"text":" - block them (or accept, change category, etc.)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Keeping this skill up to date","type":"text"}]},{"type":"paragraph","content":[{"text":"The CLI and this skill share a single version (","type":"text"},{"text":"metadata.version","type":"text","marks":[{"type":"code_inline"}]},{"text":" in the front-matter above). New features in newer Spark Desktop releases ship with an updated embedded skill. Backward compatibility is guaranteed within a major version, so the commands and flags documented here keep working - but newly added features won't appear in this file until it is reinstalled.","type":"text"}]},{"type":"paragraph","content":[{"text":"Check for an update when - and only when - you hit one of these signals:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"The user asks about a Spark feature, command, or flag that isn't documented here.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"A ","type":"text"},{"text":"spark","type":"text","marks":[{"type":"code_inline"}]},{"text":" command fails with an \"unknown command\" or \"unknown option\" error you didn't expect.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"The user explicitly says they upgraded Spark or that the skill is out of date.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In those cases:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"spark --version","type":"text"}]},{"type":"paragraph","content":[{"text":"If the printed version is greater than ","type":"text"},{"text":"metadata.version","type":"text","marks":[{"type":"code_inline"}]},{"text":" above, refresh this file before answering. ","type":"text"},{"text":"spark skill","type":"text","marks":[{"type":"code_inline"}]},{"text":" prints SKILL.md to stdout - capture it and write it back over the file you're reading right now (the path is in your context). For example:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"mkdir -p \u003cparent-of-use-spark>/use-spark\nspark skill > \u003cparent-of-use-spark>/use-spark/SKILL.md","type":"text"}]},{"type":"paragraph","content":[{"text":"\u003cparent-of-use-spark>","type":"text","marks":[{"type":"code_inline"}]},{"text":" is the directory containing the ","type":"text"},{"text":"use-spark/","type":"text","marks":[{"type":"code_inline"}]},{"text":" folder this ","type":"text"},{"text":"SKILL.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" lives in. If you have a file-write tool, you can also pipe ","type":"text"},{"text":"spark skill","type":"text","marks":[{"type":"code_inline"}]},{"text":" output directly through it - the CLI itself does not write any files.","type":"text"}]},{"type":"paragraph","content":[{"text":"Do not check on every session or before every command - this skill is the source of truth unless one of the signals above tells you otherwise.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Tips","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Always quote multi-word arguments: ","type":"text"},{"text":"spark search \"project update\"","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Combine filter operators in a single ","type":"text"},{"text":"--filter","type":"text","marks":[{"type":"code_inline"}]},{"text":" string: ","type":"text"},{"text":"--filter \"from:[email protected] is:unread newer_than:7d\"","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"folders","type":"text","marks":[{"type":"code_inline"}]},{"text":" to discover exact folder identifiers before passing them to ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":" or ","type":"text"},{"text":"search --in","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"accounts","type":"text","marks":[{"type":"code_inline"}]},{"text":" to discover calendar names before passing them to ","type":"text"},{"text":"events --in","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"search","type":"text","marks":[{"type":"code_inline"}]},{"text":" command is best for topic-based queries; ","type":"text"},{"text":"emails","type":"text","marks":[{"type":"code_inline"}]},{"text":" is best for browsing/filtering by metadata","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"thread","type":"text","marks":[{"type":"code_inline"}]},{"text":" returns the full conversation - use it when you need the complete email text, not just metadata","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"draft","type":"text","marks":[{"type":"code_inline"}]},{"text":" to compose emails - it supports new drafts, replies, forwards, and editing existing drafts","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"After creating a draft, always share its ","type":"text"},{"text":"Link:","type":"text","marks":[{"type":"code_inline"}]},{"text":" deep link with the user as a clickable markdown link instead of asking them to open Spark","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"draft --delete \u003cpk>","type":"text","marks":[{"type":"code_inline"}]},{"text":" discards a draft permanently - there is no Trash and no undo, so use it only when the user asked for it","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Never end a draft body with a sign-off: Spark appends the account's signature itself (","type":"text"},{"text":"draft signatures","type":"text","marks":[{"type":"code_inline"}]},{"text":" shows it)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"comment","type":"text","marks":[{"type":"code_inline"}]},{"text":" to post team chat messages on threads - it auto-shares the thread if needed","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"action","type":"text","marks":[{"type":"code_inline"}]},{"text":" to perform email actions like pin, archive, snooze, move to folder, and more","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"contact-action","type":"text","marks":[{"type":"code_inline"}]},{"text":" to manage contacts - block, accept, change category, toggle auto-summary, and more","type":"text"}]}]}]}]},"metadata":{"date":"2026-11-02","name":"use-spark","author":"@skillopedia","source":{"stars":155,"repo_name":"spark-cli-skills","origin_url":"https://github.com/readdle/spark-cli-skills/blob/HEAD/skills/use-spark/SKILL.md","repo_owner":"readdle","body_sha256":"a6a821badf2cfc00ac8b441b9c28efdeaee1d657ea1c6312e0b78262756a3baf","cluster_key":"0b79c572ee1c45406401b31122c2a433a4fee8a8022e8edc7c363d88e1093be6","clean_bundle":{"format":"clean-skill-bundle-v1","source":"readdle/spark-cli-skills/skills/use-spark/SKILL.md","text_bytes":0,"source_commit":"eb75eddb0e4cf1905986098b43762093d02b78a0","skills_sh_rank":19214,"attachment_count":0,"text_attachments":0,"attachment_storage":"skill_attachments","binary_attachments":0},"cluster_size":1,"skill_md_path":"skills/use-spark/SKILL.md","import_metadata":{"date":"2026-11-02","author":"@skillopedia","version":"v1","category":"integrations-apis","category_label":"Integrations"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"integrations-apis","metadata":{"version":"1.4.1","requires":{"bins":["spark"]}},"import_tag":"skills-sh-top20k-2026-11","description":"Use the spark CLI to access the user's Spark email data - list emails, search by topic, read threads, check calendar events, find availability, look up contacts, and view team info. Use when the user asks about their emails, calendar, contacts, meetings, or scheduling."}},"renderedAt":1793661569899}

Using spark is a CLI for the Spark email client. Use it to query the user's mailbox, calendar, contacts, meetings, and team data. Running spark Environment: is a thin client that talks over IPC to the user's running Spark Desktop app - it does not ship its own mailbox, network stack, or credentials. Run it directly on the user's computer against the live Spark Desktop process. Do not try to execute it inside a sandbox, container, CI runner, or any environment isolated from the user's desktop session - it will fail to connect. If Spark Desktop is not running, ask the user to launch it instead…