open-wearables-rest-cli

Generated CLI for the Open Wearables REST API.

This wrapper is built from the public OpenAPI spec at https://api.openwearables.io/openapi.json using openapi-cli-gen.

Install

pipx install open-wearables-rest-cli

For a local deployment:

export OPEN_WEARABLES_REST_CLI_BASE_URL=http://localhost:8000

For the hosted API, the generated package defaults to:

https://api.openwearables.io

Examples

Verified Commands

These commands were run successfully before publishing 0.1.0.

Public/read-only provider inspection against https://api.openwearables.io:

open-wearables-rest-cli external-providers get --output-format json

Result marker: the response included known providers such as Apple Health.

Local/self-hosted user and sync workflows:

open-wearables-rest-cli external-users list \
  --x-open-wearables-api-key "$OPEN_WEARABLES_API_KEY" \
  --output-format table

open-wearables-rest-cli external-summaries get-activity-summary \
  --user-id <user_id> \
  --start-date 2026-01-01 \
  --end-date 2026-01-31 \
  --x-open-wearables-api-key "$OPEN_WEARABLES_API_KEY" \
  --output-format json

open-wearables-rest-cli external-timeseries get \
  --user-id <user_id> \
  --start-time 2026-01-01T00:00:00Z \
  --end-time 2026-01-02T00:00:00Z \
  --x-open-wearables-api-key "$OPEN_WEARABLES_API_KEY" \
  --output-format json

Webhook debugging:

open-wearables-rest-cli external-webhooks list-endpoints --output-format table
open-wearables-rest-cli external-webhooks list-messages --output-format json

Auth

Most Open Wearables data endpoints accept X-Open-Wearables-API-Key; the generated CLI exposes that operation header as --x-open-wearables-api-key. Developer/JWT endpoints use the OAuth2 bearer scheme from the spec:

export OPEN_WEARABLES_REST_CLI_TOKEN=...

Notes

This is an unofficial community wrapper. Avoid using real health data in demos, screenshots, and test fixtures.