perpetua
by danielkillenberger
Browser & AutomationBrief
OAuth proxy for calling external APIs (Oura, Google Calendar, etc.) via Perpetua.sh hosted API using a single API.
Description
What This Skill Does
OAuth proxy that lets agents call external APIs like Oura and Google Calendar using a single API key. Perpetua.sh handles OAuth token storage and refresh, so agents never touch OAuth credentials directly. Supports multiple provider connections managed through a hosted API.
Instead of managing per-service OAuth flows and token refresh logic, one API key gives agents access to all connected providers through a uniform proxy interface.
When to Use It
- Check last night's sleep score before morning planning
- Pull today's calendar events to prep for meetings
- Fetch weekly readiness and HRV trends
- List upcoming workouts logged via Oura Ring
- Add a new OAuth provider connection to the workspace
Example Workflow
User asks: How did I sleep this week?
- 1
Load PERPETUA_API_KEY from environment
- 2
Call GET /api/proxy/oura/v2/usercollection/daily_sleep with start_date and end_date set to the past 7 days
- 3
Parse response JSON for sleep score and contributors fields
- 4
Summarize scores by day
A day-by-day breakdown of sleep scores and key contributors for the past week
Requirements
- PERPETUA_API_KEY environment variable
- Perpetua.sh account with connected OAuth providers (e.g., Oura, Google Calendar)
Installation
clawhub install danielkillenberger/perpetuaRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.