pulse-cli 0.1.6

CLI for syncing and visualising health data from Garmin Connect and Intervals.icu
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

# Pulse


Pulse is a unified health data aggregator that pulls data from Garmin Connect and Intervals.icu into a local SQLite database, then surfaces actionable insights through a Rust CLI. It computes a daily **vitality score** — a weighted composite of sleep, recovery, activity, stress, and fitness — so you can track your long-term health trajectory without trusting a vendor dashboard.

## Features


- **Sync** data from Garmin Connect (sleep, HRV, VO2 max, steps, stress, workouts) and Intervals.icu
- **Vitality score** — weighted daily composite with configurable targets
- **Fitness scoring** — VO2 max percentiles (Shvartz & Reinbold norms) + FFMI from lean body mass
- **Raw data tables** — sleep, heart rate, recovery, activity, stress, workouts
- **JSON output** — pipe-friendly `--json` flag on all data commands
- **TUI** — planned interactive terminal dashboard

## Quick Start


```bash
# 1. Build

cargo build --release

# 2. Initialise config (creates ~/.pulse/config.toml)
pulse config init

# 3. Authenticate with Garmin (optional)

pulse garmin-login

# 4. Sync and view vitality

pulse sync
pulse vitality
```

## Requirements


| Requirement | Version |
|---|---|
| Rust (stable) | 1.80+ |
| Garmin Connect account | optional |
| Intervals.icu API key | optional |

## Documentation


- [Installation](wiki/installation.md)
- [Configuration](wiki/configuration.md)
- [Usage](wiki/usage.md)
- [Syncing data](wiki/syncing.md)

## License


MIT