filippocappa/aide

A personal assistant for one person, backed by Claude.
Calendar, reminders, mail, health, habits, study notes, trams and errands on the web, through chat on the phone and the Mac.
Aide is a Python server that runs on a home machine and an app for iPhone and Mac that talks to it over Tailscale. You chat with
Aide, which hands the work to a small team of specialists, each with its own chats, tools and memory:
| Agent | Looks after |
| Aide | the orchestrator: web, maps, memory, routines, errands in its own browser; asks the others |
| Secretary | calendar (iCloud), reminders (Apple Reminders), mail (Gmail), trams and buses (GTT, Turin) |
| Professor | courses, lectures, study files, course notebooks, quizzes and practice exams |
| Coach | Apple Health, sleep and recovery, habits, food, Screen Time locks |
| Finance | money: linked bank accounts (balances, money in, every payment), Apple Pay taps, budget, subscriptions, the orders Aide placed |
Anything destructive or outward-facing (sending mail, deleting an event, moving a reminder, placing an order) is
queued in code and runs only after you tap Confirm in the app. The model never runs it directly.
On the phone the app has four tabs, one per area, each opening with a line from its agent:
Team: the chats with Aide and the specialists, the briefing, what's waiting for you, and Today (habits and
objectives). Settings is behind the gear in the corner.
Study: Professor's courses, with notebooks, lessons, quizzes and practice exams.
Health: Coach's Body, Food and Screen. Body has the Strain, Recovery and Sleep scores and last night's numbers
against your usual (see Health scores). Food has meals from a photo, a description or a
barcode. Screen has screen time and its locks and limits.
Money: Finance's month: what's left of the budget (or this month against last), categories, payments by day,
subscriptions, and the accounts with their balances from your bank (see Banks).
Around them are routines and watches (an agent's scheduled job, or a check that posts only when something needs
you), widgets, and Live Activities on the Lock Screen and in the Dynamic Island (the next tram, the next event, an
agent at work).
The Mac app is the same app in a window. It has the sections in a sidebar, the day at a glance under them, and
Pebble in the menu bar for a quick look. It also has its own screen time: the Mac counts its apps and websites and
enforces the phone's locks itself.
The API is in docs/API.md, the contract between the server and the app. SPEC.md is the
original plan, and CLAUDE.md is where things stand.
## Screenshots
iPhone: Study, a course, Health (Body, Food, Screen) and Money.
Mac: Study, Health, Food and Screen, with the sidebar and the day at a glance.
## How it fits together
mermaid
flowchart TB
subgraph Phone["📱 iPhone"]
direction LR
HK["Apple Health"] --> App["Aide app SwiftUI"]
EK["Apple Reminders"] App
Obs["Obsidian"]
end
subgraph Server["🖥️ Home server, always on"]
API["HTTP API FastAPI"]
Sched["Scheduler digests · routines · watches"]
Loop["Agent loop Aide + specialists"]
Queue["Confirmation queue"]
DB[("SQLite")]
Workers["Study workers Whisper · notebook"]