Superagent

Superagent is a free, open-source macOS desktop app that wraps Claude Code in a persistent, visual workspace — giving the agent a real browser, an iOS Simulator, and per-project chat sessions that survive restarts. It runs entirely on your Mac using the Claude subscription you already have, with no Superagent account, no telemetry, and no proxy server between you and Anthropic. The project is MIT-licensed and published across three repositories: the desktop app (Electron/TypeScript/React), an iPhone companion app (SwiftUI), and a blind relay (Cloudflare Worker / Node).

What It Is

Superagent is a desktop shell for AI coding agents, currently supporting Claude Code. Rather than a terminal or IDE plugin, it presents each project as a sidebar chat sitting next to a live browser pane and an optional iOS Simulator stream — so you can watch the agent work on the actual page or app, not a description of it. The agent drives the same browser session you're already signed into, meaning it can read, click, type, and send on real sites without a sandboxed profile.

How the Workspace Is Organized

The sidebar groups projects and conversations the way you think about them:

• One chat per task — each conversation keeps its own context and picks up mid-thought after a restart.
• Git worktrees per chat — on a git project, every conversation gets its own branch and working copy; your main checkout never moves. A "Keep / Throw away" button at the top of each chat merges or discards the agent's work.
• Browser tabs — plain browsing sessions sit above the project list; the agent can be summoned into any of them.
• The Computer — a top-level workspace where several agents can work simultaneously on a shared desktop surface with movable windows and a dock.

iOS Simulator Integration

Superagent streams a live iOS Simulator directly into the app window from the device's own framebuffer via a small compiled native helper (simfb). The agent can boot a device, tap, swipe, type, take screenshots, install and launch apps, and report back — all without opening Apple's Simulator window. The pane reveals itself automatically when the agent boots or launches something. Xcode is required only if you want the simulator; nothing else needs to be installed.

Phone Companion and Privacy Architecture

Pairing the Superagent iOS app (built from source, SwiftUI) lets you follow the agent's conversation from anywhere, send prompts, and approve or deny actions from your phone. The connection is end-to-end encrypted with a per-device key generated at pairing time; both sides dial out to a blind relay that forwards ciphertext only and stores nothing. The relay can be self-hosted with a single command. The Mac opens its relay connection only when a phone is paired — an install that never pairs a phone never connects to the relay at all.

Update: v1.7.11

The latest release is Superagent 1.7.11, published 2026-08-30. The project was created in July 2026 and has been releasing actively since, with the GitHub repository showing pushes as recently as the same day as the latest release. Notable milestones in the changelog include v1.1 (phase-1 simulator tools via xcrun simctl), v1.2 (live framebuffer streaming into the pane), and v1.6.0 (bundling the baguette input-injection binary so no external install is needed for gesture forwarding). The roadmap lists support for additional agents beyond Claude Code (Codex, Antigravity), persistent cross-project memory, and scheduled page-watching routines.

Tradeoffs to Know

• Apple Silicon only — no Intel Mac support.
• Claude Code required — the agent layer today is Claude Code; other CLIs are on the roadmap but not yet available.
• iOS Simulator requires Xcode — the framebuffer stream uses private Apple frameworks and falls back to a screenshot loop if the native helper is unavailable or if a future macOS moves the relevant symbols.
• iPhone app is source-only — the companion iOS app must be built and sideloaded; it is not on the App Store.
• No cloud fallback — everything runs locally by design, so there is no hosted option.