用途：gcalcli 是一个 Python 命令行工具，用于与 Google 日历交互，查看日程、搜索事件并读取会议附件，适合在终端或自动化流程中做日程感知与会议准备。
主要能力：通过 uvx 一次性执行；支持 agenda（日程）、search（按文字搜索事件）、list（列出日历）、calm（月视图）等命令；输出支持默认人类可读格式、--tsv 制表符分隔、--json 结构化数据；配合 --details all 可显示完整描述、参与者、会议链接、地点和附件。资料强调自定义分支在 TSV/JSON 中增加 attachments 数组，含 attachment_title 与 attachment_url，可据此筛选“Notes by Gemini”、录音、聊天等附件，并用 jq 过滤、配合 gcmd 导出笔记。
使用方式：首次运行会打开浏览器进行 Google OAuth 认证并缓存凭据、申请日历读取权限。推荐命令为 uvx --from "git+https://github.com/shanemcd/gcalcli@attachments-in-tsv-and-json" --with "google-api-core<2.28.0" gcalcli 后接子命令。例如 agenda --calendar smcdonal@redhat.com --details all --json。时间范围可传 "today"、"tomorrow"、"2 weeks"、"monday" "friday" 或绝对日期。
适用场景：晨间查看当天日程、每周计划、会前准备、查找会议链接与笔记、在工作前确认相关同步会议。
限制：本资料描述为只读，未记载通过 CLI 创建或修改事件；需要 OAuth 认证，可能需定期重新认证；多日历需分别指定 --calendar；agenda 默认从当前时间向后显示，"today" 不含当天已过去的事件，需看完整一天应使用绝对日期。官方文档见 https://github.com/insanum/gcalcli ，自定义分支见 https://github.com/shanemcd/gcalcli/tree/attachments-in-tsv-and-json 。