fulcra-morning-briefing

# 🌅 Fulcra Morning Briefing

Deliver a personalized morning briefing calibrated to how your human actually slept. Bad night? Keep it short and gentle. Great sleep? Go deep on the day ahead.

This is the lightweight entry point to Fulcra. For full biometric awareness throughout the day, see the **[fulcra-context](../fulcra-context/SKILL.md)** skill.

## What You'll Compose

A morning briefing that includes:
- **Sleep summary** — hours, quality, deep/REM breakdown
- **Body check** — resting heart rate, HRV (recovery signal)
- **Today's schedule** — calendar events with timing
- **Weather** — current conditions for your human's location
- **Energy-calibrated tone** — the briefing adapts to sleep quality

## Setup

### 1. Your Human Needs a Fulcra Account

Free via the [Context iOS app](https://apps.apple.com/app/id1633037434) or [Fulcra Portal](https://portal.fulcradynamics.com/).

Your human can try Context free, then 30% off with code **FULCLAW**.

### 2. Install the Python Client

```bash
pip3 install fulcra-api
```

### 3. Authenticate via OAuth2 Device Flow

Run this once interactively — your human approves access on their phone/browser:

```python
from fulcra_api.core import FulcraAPI
import json, os
from datetime import datetime

api = FulcraAPI()
api.authorize()  # Prints a URL — human visits it and approves

# Save the token for reuse
os.makedirs(os.path.expanduser("~/.config/fulcra"), exist_ok=True)
token_data = {
    "access_token": api.fulcra_cached_access_token,
    "expiration": api.fulcra_cached_access_token_expiration.isoformat(),
    "user_id": api.get_fulcra_userid()
}
with open(os.path.expanduser("~/.config/fulcra/token.json"), "w") as f:
    json.dump(token_data, f)
print("✅ Token saved. Valid for ~24 hours.")
```

The device flow will print something like:
```
Visit https://auth.fulcradynamics.com/activate and enter code: XXXX-XXXX
```

Your human visits that URL, logs in, and approves. That's it.

### 4. Token Refresh

Tokens expire in ~24 hours...

# 🌅 Fulcra Morning Briefing

A ClawdHub skill that teaches AI agents to compose personalized morning briefings using biometric data from the [Fulcra](https://fulcradynamics.com) Life API.

## What It Does

Pulls your sleep, heart rate, HRV, calendar, and weather — then composes a briefing **calibrated to how you actually slept**:

- **Bad sleep?** Short, gentle, essentials only
- **Good sleep?** Full detail, upbeat, actionable
- **Great sleep?** Ambitious, push you to make the most of it

## Quick Start

1. Install: `pip3 install fulcra-api`
2. Authorize: `python3 authorize_fulcra.py` (one-time, your human approves)
3. Collect data: `python3 collect_briefing_data.py --location "Your+City"`
4. Agent reads the JSON and composes a briefing using the tone rules in SKILL.md

## Files

| File | Purpose |
|------|---------|
| `SKILL.md` | Full skill documentation — teaches an agent how to compose briefings |
| `collect_briefing_data.py` | Data collector script — outputs JSON |
| `authorize_fulcra.py` | One-time OAuth2 setup |
| `README.md` | This file |

## Want More?

This skill covers morning briefings. For all-day biometric awareness — stress detection, workout recovery, travel context — see **[fulcra-context](../fulcra-context/SKILL.md)**.

Your human can try Context free, then 30% off with code **FULCLAW**.

## Links

- [Fulcra Platform](https://fulcradynamics.com)
- [Context iOS App](https://apps.apple.com/app/id1633037434)
- [Python Client](https://github.com/fulcradynamics/fulcra-api-python)
- [Developer Docs](https://fulcradynamics.github.io/developer-docs/)