# Send Garmin Connect CLI to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "garmin-connect-cli",
    "name": "Garmin Connect CLI",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/bpauli/garmin-connect-cli",
    "canonicalUrl": "https://clawhub.ai/bpauli/garmin-connect-cli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/garmin-connect-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=garmin-connect-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "garmin-connect-cli",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T13:00:00.532Z",
      "expiresAt": "2026-05-10T13:00:00.532Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=garmin-connect-cli",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=garmin-connect-cli",
        "contentDisposition": "attachment; filename=\"garmin-connect-cli-1.8.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "garmin-connect-cli"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/garmin-connect-cli"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/garmin-connect-cli",
    "downloadUrl": "https://openagent3.xyz/downloads/garmin-connect-cli",
    "agentUrl": "https://openagent3.xyz/skills/garmin-connect-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/garmin-connect-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/garmin-connect-cli/agent.md"
  }
}
```
## Documentation

### gccli

Use gccli for Garmin Connect health, fitness, and activity data. Requires Garmin SSO authentication.

Setup (once)

gccli auth login you@example.com (opens browser for Garmin SSO)
Headless: gccli auth login you@example.com --headless (with --mfa-code <code> for MFA)
Set default account: export GCCLI_ACCOUNT=you@example.com
Verify: gccli auth status

Output

Default: human-friendly tables. Use --json / -j for JSON, --plain for TSV.
Data goes to stdout, messages/errors to stderr.
Always use --json when parsing output programmatically.

Date shortcuts

today, yesterday, 3d (N days ago), YYYY-MM-DD (specific date).
Use --start/--end flags for date ranges.

Common commands

Auth status: gccli auth status
Auth token (for scripting): gccli auth token
Remove credentials: gccli auth remove
List activities: gccli activities list --limit 20
List activities by type: gccli activities list --type running
Activity count: gccli activities count
Search activities: gccli activities search --start-date 2024-01-01 --end-date 2024-12-31
Activity summary: gccli activity summary <id>
Activity details: gccli activity details <id>
Activity splits: gccli activity splits <id>
Activity weather: gccli activity weather <id>
Activity HR zones: gccli activity hr-zones <id>
Activity power zones: gccli activity power-zones <id>
Activity exercise sets: gccli activity exercise-sets <id>
Activity gear: gccli activity gear <id>
Download activity (FIT): gccli activity download <id> --format fit
Download activity (GPX): gccli activity download <id> --format gpx --output track.gpx
Upload activity: gccli activity upload ./activity.fit
Create manual activity: gccli activity create --name "Morning Run" --type running --date 2024-06-15T07:30:00 --duration 1800 --distance 5000
Rename activity: gccli activity rename <id> "New Name"
Retype activity: gccli activity retype <id> running
Delete activity: gccli activity delete <id> --force
Health summary: gccli health summary [date]
Steps chart: gccli health steps [date]
Daily steps range: gccli health steps daily --start 2024-01-01 --end 2024-01-31
Weekly steps: gccli health steps weekly --weeks 4
Heart rate: gccli health hr [date]
Resting HR: gccli health rhr [date]
Floors climbed: gccli health floors [date]
Sleep: gccli health sleep [date]
Respiration: gccli health respiration [date]
SpO2: gccli health spo2 [date]
HRV: gccli health hrv [date]
Stress: gccli health stress [date]
Weekly stress: gccli health stress weekly --weeks 4
Body battery: gccli health body-battery [date]
Body battery range: gccli health body-battery range --start 2024-01-01 --end 2024-01-07
Training readiness: gccli health training-readiness [date]
Training status: gccli health training-status [date]
Fitness age: gccli health fitness-age [date]
VO2max / max metrics: gccli health max-metrics [date]
Lactate threshold: gccli health lactate-threshold
Cycling FTP: gccli health cycling-ftp
Race predictions: gccli health race-predictions [date]
Race predictions range: gccli health race-predictions range --start 2024-01-01 --end 2024-06-30
Endurance score: gccli health endurance-score [date]
Hill score: gccli health hill-score [date]
Intensity minutes: gccli health intensity-minutes [date]
Weekly intensity minutes: gccli health intensity-minutes weekly --start 2024-01-01 --end 2024-01-31
Wellness events: gccli health events [date]
Body composition: gccli body composition [date]
Body composition range: gccli body composition --start 2024-01-01 --end 2024-01-31
Weigh-ins: gccli body weigh-ins --start 2024-01-01 --end 2024-01-31
Add weight: gccli body add-weight 75.5 --unit kg
Add composition: gccli body add-composition 75.5 --body-fat 15.2 --muscle-mass 35.0
Blood pressure: gccli body blood-pressure --start 2024-01-01 --end 2024-01-31
Add blood pressure: gccli body add-blood-pressure --systolic 120 --diastolic 80 --pulse 65
List workouts: gccli workouts list --limit 20
Workout detail: gccli workouts detail <id>
Download workout (FIT): gccli workouts download <id> --output workout.fit
Upload workout (JSON): gccli workouts upload ./workout.json
Schedule workout: gccli workouts schedule add <id> 2024-06-20
List scheduled workouts: gccli workouts schedule list 2024-06-20
Remove scheduled workout: gccli workouts schedule remove <schedule-id> (use --force to skip confirmation)
Delete workout: gccli workouts delete <id>
Create running workout with pace: gccli workouts create "Easy Run" --type run --step "warmup:5m" --step "run:20m@pace:5:00-5:30" --step "cooldown:5m"
Create workout with HR targets: gccli workouts create "HR Run" --type run --step "warmup:10m" --step "run:20m@hr:140-160" --step "cooldown:10m"
Create cycling workout with power: gccli workouts create "FTP Intervals" --type bike --step "warmup:10m" --step "run:5m@power:250-280" --step "recovery:3m" --step "run:5m@power:250-280" --step "cooldown:10m"
List courses: gccli courses list
Favorite courses: gccli courses favorites
Course detail: gccli courses detail <id>
Import course from GPX (default: cycling, private): gccli courses import route.gpx
Import course with name: gccli courses import route.gpx --name "Sunday Ride"
Import course with type: gccli courses import route.gpx --type gravel_cycling
Import public course: gccli courses import route.gpx --privacy 1
Send course to device: gccli courses send <course-id> <device-id>
Delete course: gccli courses delete <id> (use -f to skip confirmation)
List devices: gccli devices list
Device settings: gccli devices settings <device-id>
Primary device: gccli devices primary
Last used device: gccli devices last-used
Device alarms: gccli devices alarms
Solar data: gccli devices solar <device-id> --start 2024-06-01 --end 2024-06-30
List gear: gccli gear list
Gear stats: gccli gear stats <uuid>
Gear activities: gccli gear activities <uuid> --limit 20
Gear defaults: gccli gear defaults
Link gear: gccli gear link <uuid> <activity-id>
Unlink gear: gccli gear unlink <uuid> <activity-id>
Goals: gccli goals list --status active
Earned badges: gccli badges earned
Available badges: gccli badges available
In-progress badges: gccli badges in-progress
Challenges: gccli challenges list
Badge challenges: gccli challenges badge
Personal records: gccli records
Profile: gccli profile
Profile settings: gccli profile settings
Hydration: gccli hydration [date]
Log water: gccli hydration add 500
Training plans: gccli training plans --locale en
Training plan detail: gccli training plan <id>
Menstrual cycle: gccli wellness menstrual-cycle --start-date 2024-01-01 --end-date 2024-03-31
Pregnancy summary: gccli wellness pregnancy-summary
List events: gccli events list
List events from date: gccli events list --start 2024-06-01 --limit 50
Add event: gccli events add --name "Berlin Marathon" --date 2026-09-27 --type running --race --location "Berlin, Germany" --distance 42.195km --time 09:15 --timezone Europe/Berlin
Add event with goal and training priority: gccli events add --name "Spring 10K" --date 2026-05-10 --type running --race --distance 10km --goal 40m --training
Delete event: gccli events delete <id> (use -f to skip confirmation)
Reload data: gccli reload [date]

Notes

Set GCCLI_ACCOUNT=you@example.com to avoid repeating --account.
For scripting, use --json for JSON output or --plain for TSV.
Dates support today, yesterday, 3d, or YYYY-MM-DD.
Tokens are stored securely in the OS keyring (macOS Keychain, Linux Secret Service, file fallback).
Tokens auto-refresh on 401; automatic retry on 429/5xx with exponential backoff.
For Garmin China accounts: export GCCLI_DOMAIN=garmin.cn.
Confirm before deleting activities/workouts (or use --force).
Download formats: FIT (default), GPX, TCX, KML, CSV.
Workout step format: type:duration[@target:low-high] — types: warmup, run, recovery, cooldown; targets: pace (min:sec), hr (bpm), power (watts), cadence.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: bpauli
- Version: 1.3.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T13:00:00.532Z
- Expires at: 2026-05-10T13:00:00.532Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/garmin-connect-cli)
- [Send to Agent page](https://openagent3.xyz/skills/garmin-connect-cli/agent)
- [JSON manifest](https://openagent3.xyz/skills/garmin-connect-cli/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/garmin-connect-cli/agent.md)
- [Download page](https://openagent3.xyz/downloads/garmin-connect-cli)