Fitbit CLI

从Fitbit可穿戴设备查询健康和健身数据。

命令

健康数据

# Sleep logs (deep, light, REM, awake times)
fitbit-cli -s                    # today
fitbit-cli -s yesterday          # yesterday
fitbit-cli -s last-week          # last 7 days
fitbit-cli -s 2026-01-01         # specific date

# Heart rate time series
fitbit-cli -e                    # today
fitbit-cli -e last-week          # last 7 days

# Blood oxygen (SpO2)
fitbit-cli -o                    # today
fitbit-cli -o last-3-days        # last 3 days

# Active Zone Minutes
fitbit-cli -a                    # today
fitbit-cli -a last-month         # last month

# Breathing rate
fitbit-cli -b                    # today

# Daily activity (steps, calories, distance, floors)
fitbit-cli -t                    # today
fitbit-cli -t yesterday          # yesterday

账户与设备

# User profile
fitbit-cli -u

# Connected devices (battery, sync status)
fitbit-cli -d

日期格式

• 无参数：今天
• 特定日期：2026-01-05
• 日期范围：2026-01-01,2026-01-05
• 相对日期：昨天,上周,上个月
• 自定义相对日期：过去2天,过去3周,过去2个月

使用示例

用户询问“我昨晚睡得怎么样？”

fitbit-cli -s yesterday

用户问："我这周心率怎么样？"

fitbit-cli -e last-week

用户问："今天走了多少步？"

fitbit-cli -t

用户问："显示我的血氧水平"

fitbit-cli -o

用户问："我的Fitbit同步了吗？"

fitbit-cli -d

用户问："我上个月活动量如何？"

fitbit-cli -a last-month

注意事项

• 对Fitbit数据具有只读访问权限
• 令牌自动刷新（8小时后过期）
• 设备同步后数据可能有延迟
• 首次设置：fitbit-cli --init-auth