caldav-cli 是一个专为命令行用户设计的 CalDAV 日历管理工具，支持通过终端高效管理 iCloud、Google Calendar、Yandex Calendar 以及任意自定义 CalDAV 服务器上的日程数据。它采用 Node.js 开发，安装后即可全局使用 `caldav-cli` 命令进行快速操作，无需依赖图形界面。该工具的核心优势在于其简洁的命令行接口与强大的多账户管理能力，允许用户在多个日历服务之间无缝切换，同时确保所有敏感信息（如密码和 OAuth2 令牌）均安全存储于操作系统级密钥链中，杜绝明文写入磁盘的风险。无论是查看近期日程、创建新事件，还是批量导出为 JSON 格式供脚本调用，caldav-cli 都提供了直观且灵活的交互方式，特别适合开发者、系统管理员或偏好终端工作流的高级用户使用。
核心功能特点
- 支持主流日历服务商：包括 Apple iCloud、Google Calendar（OAuth2）、Yandex Calendar 及任意自定义 CalDAV 服务器
- 安全的凭证管理：使用操作系统密钥链（macOS Keychain / Linux libsecret / Windows Credential Vault）存储密码和 OAuth2 刷新令牌，避免明文泄露
- 多账户配置：可同时添加和管理多个日历账户，并通过命名区分不同服务或用途
- 灵活的输出格式：支持标准表格视图与 JSON 结构化输出，便于集成到自动化脚本或数据处理流程中
- 交互式与非交互式操作并存：既可通过向导逐步输入参数，也支持通过命令行标志一次性指定所有字段创建事件
- 完整的 CRUD 支持：提供列出、创建、编辑（隐含于覆盖机制）和删除事件的完整功能集
适用场景
caldav-cli 特别适合那些长期使用命令行环境、追求效率与自动化能力的技术用户。例如，系统管理员可以将其集成到运维脚本中，自动检测未来一周内的维护窗口并同步至团队共享日历；开发人员则可利用其 JSON 输出生成 API 调用前的测试数据，或在 CI/CD 流程中验证日历事件是否按预期创建。对于频繁在多个日历平台间切换的个人用户而言，该工具避免了在不同网页端反复登录的繁琐操作，只需记住几个简单命令即可完成日程管理。此外，由于其对 OAuth2 和 Basic Auth 的全面支持，无论是企业自托管的 CalDAV 服务器还是公有云服务，都能在同一套工具下统一管理，极大提升了跨平台协作场景下的工作效率。