用途：用 gcalcli 读取、搜索和管理 Google 日历，追求最少工具调用与最少输出，适合个人助理式快速日历操作。
主要能力：默认只返回当天议程，可按需扩展到明天、未来 N 天或指定日期范围；支持按语义（而非精确文本）在有限时间窗内定位事件；支持创建一次性事件、全天事件、提醒，以及通过 stdin 导入 ICS 实现重复事件（RRULE）或空闲/忙碌（TRANSP）；支持非交互删除并做删除后验证。
使用方式：全局标志（如 --nocolor、--calendar）放在子命令之前，子命令专属标志放在子命令之后。常用命令：gcalcli --nocolor agenda today tomorrow；gcalcli --nocolor agenda today +14d；gcalcli --nocolor search "<query>" today +180d；gcalcli --nocolor --calendar "<Cal>" add --noprompt --title "<Title>" --when "<Start>" --duration <minutes>；gcalcli --nocolor delete --iamaexpert "<query>" <start> <end>。创建前需跨所有非忽略日历做重叠检查（扫描议程时不加 --calendar）；删除后用同一时间窗议程验证，必要时加 --refresh 重试一次。
适用场景：查询当天或近期议程、按含义查找并取消/删除事件、快速新建一次性或全天事件、需要重复规则或空闲状态时用 stdin 导入 ICS。
限制：gcalcli edit 为交互式，无法在非交互执行中使用，修改属性需删除后重建；add 不支持重复与 free/busy；quick 确定性较低，除非用户明确要求否则避免；搜索默认窗口约 180 天，无结果时提示可扩展；日期默认人类可读格式，仅在明确要求时用 ISO。资料未提供安装方式、收费与平台信息。