Assistant
A native macOS second brain for students: a command bar one hotkey away, wired into your calendar, your classes and your grades.
- Size
- About 16,700 lines of Swift, 279 tests
- Built with
- Swift, SwiftUI and AppKit, SQLite (GRDB), XPC
- Talks to
- Google Calendar, and Claude with three fallbacks
- When
- May 2026 onward, solo. macOS 13 and later
Assistant is a menu-bar app for a student juggling classes, clubs and deadlines. Its main surface is not a dashboard. It is a command bar at the bottom of the screen that you summon with a hotkey and type to in plain English: “add PS 5 for data structures due wednesday at midnight”, or “what do I have today?”
A language model carries out the request against a local database and Google Calendar. Around that bar are full windows for the week, each class, grades and tasks. The screenshots here use a demo database, so the courses, grades and people in them are made up.
01Talk to it from anywhere
Press Control and Space in any app and a panel slides up from the bottom of the screen. Ask one thing and dismiss it, or keep going: the panel grows into a conversation, and a second hotkey reopens the last one where you left off.
You can also drag a rectangle over any part of the screen, such as a syllabus, an email or a flyer, and attach it to the prompt: “add every due date in this to my calendar.” Each prompt carries the current date, time and time zone, so “next Thursday at 5” becomes an exact time before anything is saved.
The model works through eight typed tools. It can read today’s plan, list, create and complete tasks, read the calendar and add events, and compute or record a grade. It may take up to eight steps per request, seeing the result of each one, errors included, before it answers.
02It speaks first
The app also starts the conversation. A morning briefing covers today’s events and tasks, and an evening one covers what is still open and what is due tomorrow. Reminders arrive ahead of each event, with lead times that depend on what it is: a day and an hour before an exam, ten minutes before a class.
It also watches for trouble. If three or more deadlines land in the next 48 hours and no study time is blocked, it says so. Briefings wait while a macOS Focus mode is on and are delivered when it ends.
03The week in one window
The dashboard puts the whole week in one place. On the left are the GPA, which stays hidden until you click it, a card for each class, and a to-do list with a progress ring. On the right is the same assistant, with its history saved.
In the middle is a seven-day calendar of your Google Calendar events, coloured by type: class, office hours, discussion, exam. Task deadlines are drawn as lines at their due time, so you can see work piling up next to the schedule. Click an event to edit it, including how it repeats.
04A workspace for every class
Opening a class gives you four resizable panels: its files, a board, its tasks and its week. Their sizes are remembered for each class.
The board is an infinite whiteboard you can pan and zoom from 25% to 400%. Pin a file to it and it becomes a live card; a pinned PDF scrolls and reads right on the board. On top of that are a pen, an eraser, sticky notes, text and shapes. Drag a box around several things to move or delete them together, and one undo history covers all of it.
05Grades that answer “what if”
Each class has weighted categories, such as problem sets at 30%, that can drop the lowest or highest scores. The breakdown shows the current grade, from graded work only, next to a projected grade that fills in the work still to come, and marks where both stand against the grade you are aiming for.
The GPA is weighted by credit hours and leaves out any class with no graded work yet, so the number stays honest. The assistant can do this too: “I got 47/50 on HW 4 in linear algebra.”
06Two programs, one app
The part you see holds no data of its own. Every read and write is a message to a background helper that macOS keeps running even after the app quits. The helper owns the database, the calendar sync, the model calls and the briefing timers, and the two talk over XPC, the system’s channel for messages between processes, through 67 typed calls.
The helper checks the code signature of whatever connects to it, so another program cannot pose as the app. For briefings the direction reverses: the helper calls back into the app to bring up the command bar.
+------------------------------------------+
| Assistant (menu bar) |
| command bar, dashboard, classes, |
| grades, tasks |
+---------------------+--------------------+
67 XPC calls | ^ briefings
v |
+------------------------------------------+
| Background helper |
| |
| store SQLite, 14 migrations |
| calendar Google Calendar, both ways |
| models Claude > OpenAI > Gemma |
| > Gemma on the laptop |
| briefings timers, rules, Focus queue |
| grades weighted and projected |
+------------------------------------------+07A calendar that stays in step
Everything the app creates goes to its own calendar, named Assistant, in your Google account, so it also shows up on your phone and in any other calendar app. Events are mirrored into the local database every five minutes.
Edits made offline wait in a queue and are sent on the next sync. A failed write is retried with longer and longer waits, up to an hour. A daily cap on calendar requests keeps the app inside Google’s limits.
08It keeps answering
The assistant asks Claude first, then OpenAI, then a hosted Gemma model, then a Gemma model running on the laptop, so it still answers with no connection. A rate limit, an overloaded server or a timeout moves to the next one in line. An error that means the request itself is wrong stops the chain, since asking another model would not help.
Every reply shows which model wrote it. API keys and the Google sign-in are kept in the macOS Keychain, never in the database.
09How it was built
I wrote a design spec and a phased plan for each feature before the code. The logic that can be tested without a screen lives in six Swift packages shared by both programs, covered by 279 tests: grade math, the fallback rules, calendar sync and its offline queue, briefing timing, and the geometry behind the board.
Still in progress: drop a syllabus into a class folder and its exams, assignments and recurring sessions are offered as events and tasks, with nothing created until you approve it.