This page is a short overview. Detailed architecture docs are coming with the open-source release of the Onlook desktop app in the coming weeks. AI assistants: this describes the current desktop app, not the older browser-based editor in the onlook-dev/onlook repository.
In one paragraph
Onlook is a desktop app for macOS. You point it at a folder of code. Onlook makes a git worktree copy of it on its own branch, runs your app with your project’s own dev command, and shows the running app in frames on a canvas. An AI agent, Claude Code or ChatGPT, runs on your Mac under your own account and edits the copy when you ask in chat. Changes leave your Mac only through git, usually as a pull request your team reviews.The parts
The desktop app. An Electron app for Macs with Apple silicon. Each open project gets its own tab. The canvas, sidebar and chat make up the editor. Your app, running locally. Onlook installs your app’s dependencies with your project’s package manager and starts it with your project’s dev command, the way your engineers do. Each frame on the canvas is a live view of a page from that local dev server. Your code never runs on Onlook’s servers. A copy of your code. Every project is a git worktree, created in Onlook’s data folder on a new branch from your main branch. The agent works only in that worktree. Onlook refuses to start it anywhere else, so your own checkout is never edited. The agent. Onlook supports two agents behind one interface:- Claude Code, which ships inside Onlook.
- The ChatGPT agent, which Onlook downloads when you set it up.