Apple Flow
Apple Flow v0.3.0+ Updates

Apple apps in front,
AI systems behind.

Bridge iMessage, Mail, Reminders, Notes, and Calendar to Codex, Claude, Gemini, Cline, or Kilo CLI. New in the latest releases: agent teams, AI-led onboarding, emergency stop controls, and an optional Swift setup/dashboard app.

Get StartedView on GitHub

Works with the apps you already use

iMessageiMessage
Apple MailApple Mail
RemindersReminders
Apple NotesApple Notes
CalendarCalendar
iMessageiMessage
Apple MailApple Mail
RemindersReminders
Apple NotesApple Notes
CalendarCalendar

How it works

Local-first message ingress, guarded execution, and native Apple-app responses.

01

Trigger from Apple channels

Text iMessage directly, or use !!agent-tagged Mail, Reminders, Notes, and Calendar items.

02

Route through guarded orchestration

Apple Flow applies allowlists, policy checks, approval gates, and workspace routing before execution.

03

Receive results + operational signals

Replies flow back to your Apple apps with status, health, and companion signals when enabled.

New capabilities in the latest core release

Local-First by Default
Everything runs on your Mac. Data stays local with approval gates for mutating actions.
Safer Execution
task: and project: requests stay queued until the original requester explicitly approves.
Five Native Gateways
iMessage, Apple Mail, Reminders, Notes, and Calendar can all feed the same AI workflow.
Workspace Routing
Route commands to specific project paths with aliases for cleaner multi-repo operations.
Provider Flexibility
Run with Codex, Claude, Gemini, Cline, or Kilo connectors based on your preferred stack.
Reliable Auto-Start
Launchd setup and restart semantics were improved for cleaner boot behavior and recovery.
Codex Agent Teams
36 reusable multi-agent team presets ship in-repo with list/use scripts and managed config writes.
Emergency Stop Controls
Process-registry-backed stop/cancel controls let you terminate long or unsafe runs quickly.
Companion Observability
Startup greeting and health visibility make proactive companion state easier to confirm.
Mail Owner Forwarding
Apple Mail responses can automatically forward to your owner iMessage thread for faster follow-up.
AI-Led Onboarding
Master prompt setup flow guides env generation, gateway setup, checks, and safe restart.
Optional Swift App
Use the local Swift onboarding/dashboard app for checks, config preview, and runtime operations.

Native Apple app integrations

iMessage icon
iMessage
Primary chat and response channel with command handling, help output, and status controls.
Apple Mail icon
Apple Mail
Send long-form prompts by email and optionally forward responses to owner iMessage for visibility.
Apple Reminders icon
Apple Reminders
Treat reminders as task ingress; pending items are parsed and executed with safety checks.
Apple Notes icon
Apple Notes
Use notes as durable prompt workspaces; execution results can be appended back to notes.
Apple Calendar icon
Apple Calendar
Schedule AI work as calendar events and run when due, with improved ingress parsing performance.

The !!agent trigger tag

Mail, Reminders, Notes, and Calendar process tagged items by default. iMessage supports natural chat plus explicit command prefixes. Trigger behavior remains configurable in environment settings for stricter or broader intake.

Setup, onboard, and operate quickly

Terminal
$ git clone https://github.com/dkyazzentwatwa/apple-flow.git
$ cd apple-flow && ./scripts/setup_autostart.sh
$ codex login
✓ readiness checks passed
✓ launchd services installed
✓ daemon/admin running
# Ask in iMessage:
help
# Queue safe mutation:
task: @web-app add health endpoint
# Control runs if needed:
system: stop

Security defaults stay strict

Local execution with explicit controls for approvals, access, and runtime safety.

Sender Allowlist
Only configured sender identities are processed; unknown senders are ignored at ingress.
Read-Only iMessage Access
Messages DB reads are run in query-only mode, reducing write and corruption risk.
Approval + Sender Verification
Mutating actions require approvals, and only the matching requester can approve.
Rate Limits and Admin Auth
Per-sender throttles plus bearer-token-protected admin endpoints harden runtime operations.

Ready to run Apple Flow?

Use the quickstart path, AI-led onboarding docs, or the optional Swift setup app.

Read the QuickstartOpen AI Install Prompt