superagent-desktop

<p align="center"> <img src="docs/logo.png" width="112" alt="Superagent logo" /> </p> <h1 align="center">Superagent</h1> <p align="center"><b>A home for your agent.</b></p> <p align="center">A free, open-source Mac app for <b>Claude Code</b>, <b>OpenAI Codex</b> and <b>Google Antigravity</b>: a desktop GUI where your AI coding agent works next to a real browser it drives, an iOS Simulator in the window, and your iPhone in the loop. Run several agents in parallel, each on its own git branch. No API key: it runs on the subscription you already have.</p> <p align="center"> <a href="https://github.com/pungme/superagent-desktop/releases/latest"><img src="https://img.shields.io/github/v/release/pungme/superagent-desktop?label=release&color=1c1d1a" alt="Latest release"></a> <a href="https://github.com/pungme/superagent-desktop/releases"><img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fpungme%2Fsuperagent-desktop%2Fbadges%2Fdownloads.json" alt="Downloads"></a> <img src="https://img.shields.io/badge/macOS-Apple%20Silicon-1c1d1a" alt="macOS, Apple Silicon"> <img src="https://img.shields.io/badge/iOS-iPhone%20%26%20iPad-1c1d1a" alt="iPhone and iPad"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-1c1d1a" alt="MIT licensed"></a> </p> <p align="center">Works with <b>Claude Code</b>, <b>Codex</b> and <b>Antigravity</b> · switch per chat</p> <p align="center"> <a href="https://github.com/pungme/superagent-desktop/releases/latest/download/SuperAgent.dmg"><b>⬇ Download for Mac</b></a> · <a href="https://superagent.computer/">Website</a> · Apple Silicon · free &amp; open source </p> <p align="center"> <a href="https://github.com/pungme/superagent-desktop"><b>desktop</b></a> · <a href="https://github.com/pungme/superagent-ios">iOS</a> · <a href="https://github.com/pungme/superagent-relay">relay</a> </p>

Your agent already writes the code. Superagent gives it a place to work — and gives you a place to watch. Every project is a chat sitting next to the thing being built: a real browser on the sites you're already logged into, the files it's editing, an iOS Simulator streamed straight into the window. Every chat works in its own copy of the project, so nothing collides. And when you leave the desk, the iPhone app follows the conversation and lets you answer the agent's questions from anywhere.

Everything runs locally on your Mac, on the agent subscription you already have — Claude Code, Codex or Antigravity, switchable per chat. No middleman server, no API key, no AI of its own — and the whole app is open source, so you can read exactly how it touches your browser.

For Antigravity, install the agy CLI and run agy in Terminal to sign in with Google, then select Antigravity in the chat’s agent picker. Its model picker reads the models available to your account.

---

What it does

<table> <tr> <td width="46%" valign="top">

Build it and watch it, side by side. The chat sits next to a real browser. Ask for a change and watch the page update in the same window — no alt-tabbing to find out whether it worked. Point it at a local dev server or any live site; the agent can start the server itself and iterate while you watch.

</td> <td valign="top"><img src="docs/chat.png" alt="The chat next to the code it's editing — the file tree, grouped steps and edits, model and mode pickers"></td> </tr> <tr> <td width="46%" valign="top">

Eight chats, one window. New in the 2.1 beta. Drag a chat from the sidebar onto the window and it opens beside the one you are in — up to eight, from any projects, and chats that belong to no project too. Drag a result out of <kbd>⌘</kbd><kbd>K</kbd> the same way, or press <kbd>⌘</kbd><kbd>↩</kbd> on it to open it beside. Move a window by its handle and pull its edge to resize it. Each split is kept as a row under Splits in the sidebar: a small picture of its windows with each project's logo, its chats, and a dot while one of them works. Click it to go back; × takes it apart. <kbd>⌘</kbd><kbd>1</kbd>–<kbd>8</kbd> picks a window, <kbd>⌘</kbd><kbd>⇧</kbd><kbd>[</kbd> and <kbd>⌘</kbd><kbd>⇧</kbd><kbd>]</kbd> go round them. A narrow window keeps its browser or simulator as a small view inside it. The iPad app splits the same way, with up to four windows.

</td> <td valign="top"><img src="docs/split-view.png" alt="Split view: four chats side by side in one window, three from projects and one loose chat, with the split saved as a row under Splits in the sidebar"></td> </tr> <tr> <td width="46%" valign="top">

An agent that can use the browser. Your agent drives that same browser: open a page, click, type, read it back. Not a hidden browser it describes to you second-hand — the one on your screen, with your logged-in session. You watch it work and can take over any time. Automation only ever happens in Superagent's own pane, never in your personal browser.

</td> <td valign="top"><img src="docs/browser-view.png" alt="The agent driving the browser pane: a real page, a real session, a stop button"></td> </tr> <tr> <td width="46%" valign="top">

An iPhone in the window. A real iOS Simulator, streamed into the app at about a frame a second, that the agent can tap, swipe and type into. Ask it to build and run, and it does — then looks at the screen and fixes what it sees.

</td> <td valign="top"><img src="docs/build.png" alt="An iOS Simulator streamed into the window beside the conversation building it"></td> </tr> <tr> <td width="46%" valign="top">

Your Mac's agent, in your pocket. Pair once from Settings → Phone and the iPhone app follows your Mac from anywhere: the conversation as it happens, a prompt from the sofa, a yes or no when the agent asks. End-to-end encrypted, through a relay that stores nothing and can read nothing. On iPad it takes the Mac's shape — sidebar left, conversation right, the page beside it.

</td> <td valign="top"><img src="docs/phone-app.png" alt="The iPhone app: a page mirrored from the Mac above the conversation that opened it"></td> </tr> <tr> <td width="46%" valign="top">

Ask from anywhere. Superagent also sits as a small tile in the corner of your screen, over every app. Click it or press its shortcut, say where (the Computer, or any project) and what, and the answer comes back beside it without opening the window. It spins while it works, turns amber when it needs your yes, and every request is an ordinary chat you can open afterwards.

Run the app by asking. From the tile or any chat, typed or spoken: "go to the wepush chat about e2e testing", "what's running?", "start a chat in the portal to fix the header", "show me its board", "go back". It finds the conversation from how you describe it and takes you there.

It can use your Mac, when you let it. Turned on in Settings, an agent can see the screen, read an app's controls by name, and press, fill and click in any app. It asks first, for the Mac and again for each app, and before anything named Quit, Delete or Send. Password managers, password prompts and the lock screen are out of bounds, you can add any app to that list, and ⌥Esc stops it from wherever you are.

Everything in its place. The Computer sits at the top of the sidebar with its own conversations under it. Then one Projects section: your open browser tabs first, then your projects, each with its own icon and its conversations nested underneath — a spinner while the agent works, a dot when it needs you, and the git branch where you would expect it. The globe on its header opens a new tab; the folder adds a project. Pinned chats go in whatever order you drag them into.

</td> <td valign="top"><img src="docs/sidebar.png" alt="The sidebar: grouped projects with nested chats and branch chips"></td> </tr> </table>

Getting the phone app

TestFlight, or build it from source — see its README.

• Ask mode. A permission mode where the agent checks with you before it acts — on the Mac, or on your phone if that is where you are.
• More than one Mac. Switch between paired Macs from the title at the top of the phone app; it reopens on the one you picked last.
• Private by construction. Everything between the phone and the Mac is end-to-end encrypted with a per-device key from the pairing QR. Both sides dial out to a tiny blind relay (superagent-relay) that forwards ciphertext and stores nothing, so it works behind any network with no setup. Run your own with one command and change the URL in Settings → Phone.
• Connects only when it is used. The Mac opens its relay connection when a phone is paired or being paired. An install that never pairs a phone never connects anywhere.

Also in the box

• Every chat is its own checkout. A new conversation gets a private copy of the project on its own branch, cut on its first message and named after what you asked for. Keep folds its work back in as one change; Throw away deletes it. The project row keeps a conversation that works in the folder itself, for when that is what you want.
• A board the agent keeps. Backlog, next, doing, done — per project, and Claude moves the cards as it works. Watch them move while you talk to it.
• A plan you can steer. When the agent writes itself a to-do list, it shows up pinned above the conversation — tap a pending step to send it straight back as the next thing to work on.
• Routines. "Check this site every hour," in plain language, on a timer.
• /loop, self-paced. Ask it to keep going — reviewing, testing, refining — and it decides its own pace between rounds instead of you re-prompting it every few minutes.
• Dashboard. Turns per day, tasks done, a streak — and which projects actually got your time. Computed locally.
• Every project shows what it is. A website's favicon, a native app's own icon from its Xcode AppIcon, or a glyph for a screenplay, design or music folder — pulled straight off the project's own files, even inside a folder that holds several repos. It shows in the sidebar and next to projects and conversations in <kbd>⌘</kbd><kbd>K</kbd>. Pick your own any time.
• Several repos, one row. A project folder that holds several repos folds them away under a caret on its own row, and remembers whether you left it open. A repo that is still cloning says "cloning…".
• Files & PDFs. Click any file to read it — PDFs, images, markdown, source — right beside the tree; annotate PDFs in place; drag files into the chat.
• A screenshot lands in the chat, not just a link to it. When a tool call produces a picture — a simulator screenshot, a page it read — it shows up inline, right under the step that made it. Images the agent puts in its reply show as small previews; click one for full size.
• Snip to attach. ✂ on the browser or the simulator (or ⌘⇧S): drag a box right on the page or the phone screen and the crop lands in your message, at full resolution.
• Multiple browser tabs per chat. Open more than one page without leaving the conversation — switch between them the way you would in a real browser. The agent keeps its own tab, so one you opened to look something up isn't taken over by its next navigation.
• A real phone size. The agent can switch the browser pane to a real 390×844 mobile viewport, to desktop, or to both side by side, so it checks a mobile layout at that size instead of faking one.
• @ reaches everything. Type @ for this project's files, the other projects in your sidebar by name, or any folder on the disk (@/, @~/) —