Getting started
Set Homeling up, ask your first things, and find your way around.
Before you start
- A Mac with Apple silicon (2020 or newer) and 16 GB of memory, running macOS 26.
- Room for Homeling's AI: on a Mac with 16 GB, about 5 GB for the everyday model, and about 7 GB more for the overnight model if you let Homeling work overnight. Setup shows the exact size before anything downloads.
- An internet connection for the download. After that, the things you use every day work offline.
Set it up
- Your name. Homeling asks what to call you. Type it and click Continue, or click Skip.
- Your Mac and its model. Homeling looks at your Mac (memory, graphics and free space) and suggests the model that fits it. Click Use this, or Other options to pick another.
- Overnight work and backup. “Work overnight” is already on if your Mac is plugged in. Then click Get started, or Keep my history safe & get started to back up to your iCloud as well (Backup and restore).
While the model downloads
You can start right away: until the download finishes, Homeling answers with Apple's on-device model, so it's a bit simpler for now. A small bar at the top of the window shows how far the download has got; it checks every file when it's done, then loads the model.
If it stops, the bar says “Download paused · Retry”. See a download that's stuck.
Ask your first things
A new chat offers a few one-tap starters, like “Plan my day”, “Catch me up on email” and “What should I wear?”. Or just ask, the way you'd ask a person: “Find a night next week for dinner with Priya and Alex and text them the options.”
- The first time a request needs your calendar, reminders or contacts, a card explains why before macOS asks (permissions).
- Before anything is sent or bought, Homeling shows you what it's about to do and waits for your OK (approvals).
- Ask “What can you do?” for a list, with examples you can tap.
Overnight work and the morning report
In Homeling: Settings → General
With “Work overnight” on, Homeling does its longer jobs between 1 and 6 am: only while your Mac is on power, after it has been idle for a while, and while it's cool. You can change the hours in Settings → General. In the morning, your report is ready (from 7 am unless you pick another hour): what got done, what's waiting for your OK, and what Homeling learned. The morning report guide has the rest.
Overnight work happens while Homeling is running. To let it work with the window closed, turn on “Keep working when the window is closed” (the background service).
How much of your Mac it uses
In Homeling: Settings → General → Daytime share of your Mac
Pick Light (stay out of the way), Balanced (a fair share of my Mac, the starting choice) or Max (I'm mostly using you). Homeling also steps down to Light by itself for background work while you're using your Mac. More in if your Mac feels slow.
People
People (⌘4) is everyone Homeling knows from your contacts and from what it reads overnight: when you last talked, what you promised, birthdays and notes. Ask things like “Who haven't I talked to in a while?”.
To give it a head start, import a WhatsApp, LinkedIn or Discord export from Settings → Your Data, or the “Import my WhatsApp, LinkedIn or Discord history” starter. You can take an import back there later.
Automations
Tell Homeling in a chat to do something on a schedule, like “every weekday at 7:30, summarise my day”, and approve the card. It then runs on its own. Automations (⌘5) lists them, with Pause, Run now and Delete. An automation keeps the permissions you had when you approved it and can only lose them, never gain them; anything that would leave your Mac still asks you, in the morning report if you're away.
Keyboard shortcuts
- ⌘N
- A new chat
- ⌘0
- Back to your chats
- ⌘1, ⌘3 … ⌘7
- Morning report, Activity, People, Automations, VM terminal, Sandbox
- ⇧⌘A
- Review the oldest thing waiting for your OK
- ⌃⌥Space
- Talk to Homeling from any app
- ⇧⌘M
- Talk, with the words waiting in the message box
- Esc
- Discard what you're saying, or stop a reply being read aloud
- ⌘?
- Help for the screen you're on