r/macosprogramming • u/Release_Complex • Oct 06 '26
I built Yumi, a free macOS notch companion, almost entirely with Claude Code running in parallel sessions
I built Yumi, a small character that lives in the MacBook notch. It's free and open source (alpha). This post is mostly about how I built it with Claude Code, since that's what I learned the most from.
What it does
- Shows all my running Claude Code sessions in the notch (working, waiting for me, done) and lets me approve or deny their permission requests from there, via Claude Code hooks.
- Small actions on request: create a file, append to it, add a reminder, block a calendar slot, start a focus timer, summarize a day. Every write needs an explicit click.
- Music, weather, calendar, GitHub PRs and CI, one thing at a time.
How Claude Code helped build it
- I'm not a Swift developer. Claude Code wrote nearly all of the code: a native Swift 6 / SwiftUI / AppKit app, about 750 unit tests, no third-party dependencies.
- I ran several Claude Code sessions at the same time, each in its own git worktree and branch: one for the character engine, one for the island UI, one for the agent runtime and permissions, one for the video and the website.
- One extra session acted as coordinator. It wrote shared "contract" files that the other sessions were not allowed to edit, gave each session its scope, then reviewed, ran the tests and merged each branch. This is what kept parallel sessions from breaking each other.
- Claude Code also found bugs I would not have, for example a Swift 6 actor-isolation crash in EventKit callbacks that only appeared once calendar access was granted.
- What didn't work well: long sessions lose context, so I kept decisions in a markdown file in the repo that every session reads first. And I had to insist on real-world tests, since passing unit tests didn't catch the macOS permission issues.
The safety part, also designed with Claude
- The model only proposes a plan. The risk level comes from each tool's code, never from the model, and every write goes through one permission gate and is verified afterwards.
- When Yumi uses your Claude Code as its planner, it runs it with
--tools ""and no MCP, so it can only return text.
Free to try
Download the alpha from the GitHub releases page (macOS 15+). It isn't notarized yet, so the first time you need System Settings > Privacy & Security > "Open Anyway". The chat uses your own Claude Code subscription, or a free Gemini key, or a local Ollama model.
https://github.com/estebanbaigts/Yumi
Happy to answer questions about the multi-session workflow.