安装
brew install bpauli/tap/gccli适合谁
gccli 是 Garmin Connect 的命令行工具，官方定位为“快速、适合脚本的 CLI”，可访问活动、健康数据、身体成分、训练、路线、设备、装备、目标与徽章。适合这些人：
- 想在终端直接查自己的 Garmin 数据、并让结果进脚本的人：官方提供 JSON 与 plain/TSV 两种可解析输出，明确面向脚本与自动化。
- 在 agent 客户端里工作、想让 agent 代查数据的人：gccli 自带即用的 agent skill，官方说明面向 Claude Code、Codex、Hermes、OpenClaw 等 AI agent 客户端。
- 需要把训练与健康数据并入自动化流程的开发者。
不适合或需先确认的情况：
- 没有 Garmin Connect 账号无法使用：认证经 Garmin SSO 完成，这是硬前提。
- 不想用 Homebrew 的环境：官方给出的可复制安装命令只有 Homebrew 一条；从源码构建要求 Go 1.26 或更高，完整构建步骤未在证据范围内。
- 客户端名单是官方例举而非穷尽，名单之外是否兼容未说明，接入前以仓库文档为准。
3 分钟完成第一次尝试
推荐主路径只有一条：用 Homebrew 安装，完成 Garmin SSO 认证，再让 agent 跑一个查询。
前提：已有 Garmin Connect 账号；本机已安装 Homebrew；知道首次认证会把凭据写入系统 keyring（副作用见「使用边界」）。
第 1 步，安装：
brew install bpauli/tap/gccli
第 2 步，认证。认证经 Garmin SSO 进行，凭据保存到系统 keyring。一个必须先知道的细节：官方明确说明，gccli 用内置于源码的固定口令加密每个令牌文件——即 keyring 不可用时的回退令牌文件，其加密口令并非你的专属秘密，能否接受请在首次认证前自行判断。具体登录命令证据未给出，安装后按 gccli 自带帮助完成登录。
第 3 步，让 agent 接上技能。gccli 自带的 agent skill 在 skills/gccli/SKILL.md，官方称其即用；接入你所用客户端的具体步骤证据未给出，以各客户端文档为准。
第 4 步，发起一个查询任务。直接对 agent 说：“调出我最近的跑步活动和这周的身体成分数据”。这类任务落在官方列出的数据访问能力内；查询过程是否写本地文件官方未说明、未确认，已确认的写入副作用只有令牌存储（见「使用边界」），不要预设“只读不写”。
第 5 步，核对成功信号：返回应是 JSON 或 plain/TSV 的可解析输出，可直接粘贴或交给脚本；看到结构化输出即链路已通。
使用案例
案例 1：汇总训练与身体数据。
- 场景：想一次看全最近的运动记录和体重变化，不在网页端逐条翻。
- 发起：在接好 gccli 的 agent 客户端里说“列出我最近的训练和身体成分记录”。
- 工作流：agent 经 gccli 访问活动与身体成分这两类官方确认的数据类别。
- 可期待结果：拿到 JSON 或 plain/TSV 可解析输出，可粘进表格或交给脚本；单条记录的字段清单官方未列出，以实际返回为准。
案例 2：把 Garmin 数据并入自动化脚本。
- 场景：想每周固定汇总设备、装备、目标与徽章状态，形成自己的训练档案。
- 发起：在已有的脚本或定时 agent 任务里调用 gccli，把输出交给下游处理。
- 工作流：利用官方“适合脚本”定位与 JSON、plain/TSV 输出模式接入现有流程。
- 可期待结果：机器可读输出可稳定进入下一步；具体子命令与参数清单官方未逐字给出，动手前以 gccli 帮助输出与仓库说明为准。
使用边界
- 网络与账号：数据来自 Garmin Connect 云端，认证与每次查询都需联网并使用你的 Garmin 账号；官方未提及离线能力，未确认。
- 凭据与写入副作用：首次认证经 Garmin SSO，凭据写入系统 keyring；keyring 不可用时的回退令牌文件用源码内置固定口令加密。除令牌存储外，查询是否写其他文件，官方未说明，未确认。
- 运行环境：从源码构建要求 Go 1.26 或更高；推荐主路径经 Homebrew 安装，不涉及本地构建；其他运行要求未写明。
- 客户端前提：自带 agent skill 面向 Claude Code、Codex、Hermes、OpenClaw 等 AI agent 客户端；名单之外的客户端是否兼容、各客户端接入步骤是否一致，官方未逐一说明，接入前以各客户端文档为准。
- 明确限制：速率限制、导出上限、服务条款层面的约束官方均未提及；批量或高频使用前先查阅官方仓库。