Ambient Agent

Ambient Agent

A native macOS app that analyzes your digital life to surface insights about your relationships, communication patterns, and wellbeing.

  

Features

Insights Dashboard

• Wellbeing Score - Composite score based on sleep patterns, social connection, and stress indicators
• Communication Patterns - Hourly and daily activity visualization
• Relationship Tiers - Automatic categorization of contacts by engagement level

People

• Contact Analysis - See message counts, reaction patterns, and relationship strength
• Rich Metadata - Sent/received ratios, heart reactions, media sharing stats
• Privacy Controls - Right-click to block contacts from all analytics

Activity

• Time Patterns - When you're most active
• Peak Hours - Your busiest communication times
• Volume Trends - Daily message volume over the past 2 weeks

Network Graph

• Top Connections - Your most engaged relationships
• Group Chats - Activity across group conversations
• Relationship Strength - Visual indicators of connection depth

Privacy Features

• Contact Blocking - Completely hide specific contacts from all insights
• Privacy Blur Mode - Obscure names/numbers for screenshots
• Local Processing - All data stays on your Mac

Requirements

• macOS 14.0 (Sonoma) or later
• Full Disk Access permission (for Messages database)
• Optional: Anthropic API key for AI-powered features

Setup

1. Clone the repository:

   git clone https://github.com/haasonsaas/ambient-agent.git
   cd ambient-agent

2. Open in Xcode:

   open AmbientAgent.xcodeproj

3. Build and run (⌘R)

4. Grant **Full Disk Access** when prompted:

   • System Settings → Privacy & Security → Full Disk Access
   • Enable for Ambient Agent

Dat