Architecture

Electron main owns the agent processes, the store, the memory supervisor and scheduled automations. The renderer is a React app that talks to main over a typed IPC contract. Providers are data-driven adapters around each CLI's stream format. Housekeeping work (titles, summaries, small classifications) is handed to Apple's built-in fm CLI on macOS 27 when it is present, so the chores run locally and free instead of billing a frontier model. The full breakdown lives in docs/ARCHITECTURE.md, and contributions are welcome on GitHub.