AI导哈

文档办公

use-spark

readdle/spark-cli-skills

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.

  • 517 次安装
  • 154 星标
  • 收录于

安装命令

npx skills add https://github.com/readdle/spark-cli-skills --skill use-spark

SKILL.md

Using spark

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

spark <command> [options]

Environment: spark 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.

JSON output: add --json 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 {"error": {"message": "…"}} on stdout and exits non-zero. Prefer the default text when you only need to read the result; use --json when you need to process it (e.g. spark emails --json | jq '.emails[].id'). Fields are only ever added, never renamed or removed.

Commands