How Spaces works

Spaces is a Mac app whose own source is open to the agent inside it. You ask in a chat, the agent rewrites part of the app, proves the result in a copy, and only then changes the window you are looking at.

01

It starts as an empty window

The first time you open Spaces there is a sidebar with nothing in it, and a chat. You connect one AI account: a ChatGPT plan or GitHub Copilot from the welcome screen, a Claude subscription through Claude Code, or an API key.

Then you say what you want to keep an eye on. Type it, and drop the files or photos it should work from anywhere on the window.

Track my runs from the GPX files in ~/Runs and show each week's distance.
Ask for a change
02

Your request becomes an edit to the app

Everything the window draws is a script: the sidebar, the chat, every space. The agent works on a copy of those scripts in a folder on your Mac, never on the ones your window is running.

A space is a few files in that folder: a view that draws it, the data it shows and, when it should stay current, an updater. Once written, a space opens without calling a model.

spaces/running/
main.jsthe view
update.jsfetches every 15 min
commands.jsonits buttons
SPACE.mdwhat it is for
03

It is checked before you see it

When the agent is done it publishes. Publishing draws every view of the changed app out of sight. If one fails to open, nothing reaches your window and the agent goes back to fix it.

The agent can also look at its own work: the app draws the new space into a picture, off screen, and the agent reads that picture for layout mistakes before it answers you.

Read 214 runs from ~/Runs
Wrote the Running space
Checked 3 views in a copy
Adding it to your sidebar
04

A space keeps itself current

A space that shows outside data gets an updater: code the agent writes once, which fetches from files, web pages, command-line tools or MCP servers and writes the space's data.

It runs on the schedule you asked for, every five minutes or every day at 08:00, while the app is open, and catches up once at launch if its time passed while the app was closed. An update never calls a model, so it uses none of your AI plan.

A dot in the sidebar marks a space whose data changed while you were elsewhere. If an update fails, the space says why and offers to have the agent fix it.

Runningevery 15 min07:58
Moneyat 08:0008:00
PRsevery 5 mingh is signed outFix
05

Buttons run your own commands

A space can carry buttons for what you do after reading it. A button runs a command you already use in a terminal, with fields for what changes each time: the branch to deploy, the amount to file.

A button can also hand work to the agent without leaving the space. When the agent needs a decision, it asks with a card of answers at the bottom of the window.

For a job that only exists inside another Mac app, the agent can operate that app through Cua Driver, a free, open-source tool that Spaces offers to install the first time it is needed.

Deploy
Branchmain
Run deploy
Deployed main to staging in 48 s
06

Every change can be undone

Each publish is kept as a step in the app's history. The answer that made a change ends with an Undo, and Undo Last Change in the menu (⌥⌘Z) takes back the latest step from anywhere.

Settings has Start over, which returns the app to the empty window it began as.

Added the Running spaceUndo
Nested Diet under Life09:12
Changed the fontyesterday
The empty windowNov 2
07

The look is yours too

The request that builds a space can also restyle the app. Ask for another font, a quieter sidebar or a different character altogether, and the agent rewrites the theme and its design rules, so the spaces built afterwards follow.

One space can have a look of its own, and the app follows your Mac's light or dark setting unless you pin one.

RunningLight
28.4 km
RunningDark
28.4 km

Spaces at a glance

What it is
A Mac app that starts as an empty window with a chat and becomes the pages you ask for, called spaces.
Runs on
Apple silicon · macOS 13.5 or later.
AI
Your own account: a ChatGPT plan, GitHub Copilot, a Claude subscription through Claude Code, or an API key from Anthropic, Google, OpenRouter, Mistral, xAI, Groq and others.
Interface
A native Mac window drawn with GPUI. A space can still hold a web page of its own.
Where things live
A folder on your Mac: the app's scripts with their full history, and a local database for the data.
Staying current
Each space's updater runs on a schedule while the app is open, as plain code that calls no model.
Sources
Files and folders, web pages, command-line tools, MCP servers, and other Mac apps through Cua Driver.
Safety net
Every change is checked in a copy first and can be undone, back to the empty window.

Start with an
empty window

Sign in to the AI you already use, then ask for the first thing you'd otherwise open another app for.

Apple silicon · macOS 13.5 or later