用途:使用 calendly CLI 读取 Calendly 的连接状态与日程调度数据。
主要能力:支持查询连接状态、断开连接、生成授权链接、获取当前用户信息、列出事件与事件类型,以及发起通用 GET 请求。
常用命令: calendly status calendly disconnect calendly authorize-url calendly me calendly list-events --user-uri <uri> [--status active] [--min-start-time <iso>] [--max-start-time <iso>] [--count 20] [--page-token <token>] calendly event-types --user-uri <uri> [--active true] [--count 20] [--page-token <token>] calendly request --method GET --path '/scheduled_events' --query 'user=<uri>' [--query 'status=active'] [--json-body '<json>']
使用方式:命令从 PATH 直接调用,每条命令返回带顶层 ok 的 JSON。先运行 calendly status;未连接则运行 calendly authorize-url,将返回的 connect_url 以 Markdown 链接形式提供;授权后运行 calendly me 验证。需要用户 URI 或组织 URI 时先执行 me,再列出用户范围内的资源。list-events 与 event-types 解析返回集合及分页 token;定时事件附带 UTC 与本地时间的 event_starts_at / event_ends_at,读取输出附带 retrieved_at。
限制与规则:调用 API 前需 status 显示已连接;过期 token 自动刷新,若仍失败需重新检查状态并按需重新关联。执行破坏性或用户可见的变更前需确认。不建议在摘要中直接输出凭证;优先使用 event_starts_at.user_local 与 event_ends_at.user_local。凭证存储细节与底层配置路径暂未提供。