用途：通过 gcalcli 读取、搜索和管理 Google 日历，面向个人助理场景，追求最少工具调用与最少输出。
主要能力：默认只返回当天议程；按语义在有限时间窗内查找事件；创建一次性或全天事件；通过 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）。删除后须在同一时间窗用 agenda 验证，必要时加 --refresh 重试一次。
适用场景：查询当天或指定范围议程、按含义定位事件、快速增删事件、需要重复或空闲标记时用 import。
限制：gcalcli edit 为交互式，非交互环境不可用，需删除后重建；add 不支持重复与 free/busy；quick 确定性较低，非明确要求避免使用；日期默认人类可读，ISO 仅在明确要求时使用。资料未提供安装方式、配置细节与收费信息。