Skip to content

lonexreb/FounderAgent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

╔══════════════════════════════════════════════════════════════════════════════╗
║                                                                              ║
║     ███████╗ ██████╗ ██╗   ██╗███╗   ██╗██████╗ ███████╗██████╗              ║
║     ██╔════╝██╔═══██╗██║   ██║████╗  ██║██╔══██╗██╔════╝██╔══██╗             ║
║     █████╗  ██║   ██║██║   ██║██╔██╗ ██║██║  ██║█████╗  ██████╔╝             ║
║     ██╔══╝  ██║   ██║██║   ██║██║╚██╗██║██║  ██║██╔══╝  ██╔══██╗             ║
║     ██║     ╚██████╔╝╚██████╔╝██║ ╚████║██████╔╝███████╗██║  ██║             ║
║     ╚═╝      ╚═════╝  ╚═════╝ ╚═╝  ╚═══╝╚═════╝ ╚══════╝╚═╝  ╚═╝             ║
║                  █████╗  ██████╗ ███████╗███╗   ██╗████████╗                 ║
║                 ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝                 ║
║                 ███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║                    ║
║                 ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║                    ║
║                 ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║                    ║
║                 ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝                    ║
║                                                                              ║
║              Your AI co-founder that protects your performance.              ║
║                                                                              ║
╚══════════════════════════════════════════════════════════════════════════════╝

What is this?

FounderAgent is an autonomous AI agent that runs every 15 minutes, reads your biometrics from wearables, and takes real actions to protect your cognitive performance.

ChatGPT Health reads your data. FounderAgent acts on it.


How it works

Every 15 minutes:

  ┌─────────┐     ┌─────────┐     ┌─────────┐     ┌─────────┐
  │  SENSE  │────▶│  THINK  │────▶│   ACT   │────▶│   LOG   │
  └─────────┘     └─────────┘     └─────────┘     └─────────┘
       │               │               │               │
   Oura API        Claude AI      Google Cal       Supabase
   HRV, sleep,    "Block focus    Slack DND        Full audit
   readiness       time now"      Email alert      trail
Phase What happens
SENSE Pulls HRV, sleep score, readiness, and activity data from Oura Ring
THINK Claude analyzes your state and decides what actions to take
ACT Blocks your calendar, sets Slack DND, sends recovery protocols
LOG Every decision + reasoning stored for full transparency

When does it act?

FounderAgent only intervenes when it matters:

Trigger Threshold Action
Low readiness < 50 Block calendar, light meeting load
High workload ratio ACWR > 1.5 Recovery protocol, reduce intensity
Sleep debt > 5 hours Slack DND, push non-critical meetings
Peak cognitive window Detected via HRV Protect deep work blocks

Safety rails: Never cancels external meetings. Max 2hr calendar block. Max 4hr DND. Every action is overridable.


Tech Stack

Framework     →  Next.js 15 (App Router, TypeScript)
Database      →  Supabase (Postgres + RLS)
Agent Brain   →  Claude API (structured JSON output)
Health Data   →  Oura Ring API v2
Calendar      →  Google Calendar API
Messaging     →  Slack Web API
Email         →  Resend
Payments      →  Stripe
Scheduling    →  Vercel Cron (every 15 min)
UI            →  shadcn/ui + Tailwind + Recharts

Architecture

                    ┌──────────────────┐
                    │   Vercel Cron    │
                    │  */15 * * * *   │
                    └────────┬─────────┘
                             │
                    ┌────────▼─────────┐
                    │  /api/cron/agent  │
                    │   (Agent Loop)   │
                    └────────┬─────────┘
                             │
              ┌──────────────┼──────────────┐
              │              │              │
     ┌────────▼───┐  ┌──────▼──────┐  ┌───▼────────┐
     │   SENSE    │  │    THINK    │  │    ACT     │
     │  Oura API  │  │  Claude AI  │  │  GCal API  │
     │  Scores    │  │  Decision   │  │  Slack API │
     └────────────┘  └─────────────┘  │  Resend    │
                                      └────────────┘
                             │
                    ┌────────▼─────────┐
                    │    Supabase      │
                    │  agent_actions   │
                    │  agent_config    │
                    │  daily_health    │
                    └──────────────────┘

Pricing

Plan Price Features
Free $0 View readiness + energy curve
Pro $19.99/mo Full agent loop, all actions, 30-day history
Team $39.99/seat Multi-user, team dashboards

Getting Started

# Clone
git clone https://github.com/YOUR_USERNAME/FounderAgent.git
cd FounderAgent

# Install
npm install

# Environment
cp .env.example .env.local
# Fill in your API keys (see .env.example for docs)

# Run
npm run dev

Status

🔨 Currently building. See NEXT-TO-DO.md for the implementation roadmap.


Built for founders who optimize everything — including themselves.

About

Autonomous health-aware AI agent. Reads your biometrics, takes real actions: blocks calendar, sets Slack DND, sends recovery protocols. Your AI co-founder that protects your performance.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors