### Superset Run Claude Code, Codex, or another CLI agent with terminals, code review, and browser previews in one workspace. [**Download for macOS**](https://github.com/superset-sh/superset/releases/latest) • [Documentation](https://docs.superset.sh) • [Changelog](https://github.com/superset-sh/superset/releases) • [Discord](https://discord.gg/cZeD9WYcV7)

Claude and OpenCode working in parallel Superset workspaces with live diffs

### Documentation for agents The docs are available as [a Markdown index](https://docs.superset.sh/llms.txt) linking to individual pages, or [one full-text file](https://docs.superset.sh/llms-full.txt). ## Install Download the desktop app: - **macOS**: [Apple Silicon (.dmg)](https://github.com/superset-sh/superset/releases/latest/download/Superset-arm64.dmg) · [Intel (.dmg)](https://github.com/superset-sh/superset/releases/latest/download/Superset-x64.dmg) - **Linux**: [x64 AppImage](https://github.com/superset-sh/superset/releases/latest/download/Superset-x86_64.AppImage) (experimental; macOS is the primary target) - **Windows**: not yet available - [All builds](https://github.com/superset-sh/superset/releases/latest) All you need installed is [Git](https://git-scm.com/). [gh](https://cli.github.com/) is optional and enables the PR workflows; Superset offers to install it for you. ## Start with one task 1. [Install Superset](#install) and add a repository from your computer or clone one. 2. Create a workspace, choose your CLI agent, and describe a small change you want to make. 3. Inspect its patch in **Changes**, run the relevant tests, and preview your app in the browser pane before committing. For a walkthrough of workspace creation and review, see [Your First Parallel Session](https://docs.superset.sh/first-workspace). ## Review and revise - **Change your app's UI.** Use **Design** in the browser pane to select an element and send your requested change to an agent with element context. [Walkthrough](https://superset.sh/blog/change-ui-with-your-coding-agent) · [Design Mode docs](https://docs.superset.sh/browser#design-mode) - **Ask an agent to fix a PR.** Open **Pull requests → Code**, select diff lines, and send feedback to a running or new agent session. Posting to GitHub is optional. [Walkthrough](https://superset.sh/blog/send-pr-feedback-to-your-agent) · [PR docs](https://docs.superset.sh/pull-requests#comment-straight-to-an-agent) - **Review a report with your team.** Ask an agent to publish a Page. Teammates pin comments, and a watching agent can revise it at the same link. Keep its host and session running for feedback delivery. [Walkthrough](https://superset.sh/blog/review-agent-work-with-pages) · [Pages docs](https://docs.superset.sh/pages)

See the diff viewer and browser previews

### Built-in Diff Viewer Inspect, comment on, and edit agent changes without leaving the app, then commit and push when it's ready. [Docs →](https://docs.superset.sh/diff-viewer)

Reviewing an agent's changes in the diff viewer

### In-App Browser & Ports Preview running dev servers in a browser pane. Ports are detected per workspace, so every worktree gets its own preview. [Docs →](https://docs.superset.sh/browser)

In-app browser previewing a dev server with detected ports

## Run independent tasks Give each task a Git worktree with its own branch and terminals. Worktrees separate working files; they do not sandbox processes or prevent merge conflicts. [Workspace docs](https://docs.superset.sh/workspaces) · [Terminal docs](https://docs.superset.sh/terminal-integration) · [Agent status](https://docs.superset.sh/agent-integration)

See workspaces, monitoring, terminals, and the command palette

### Parallel Workspaces Review each result before merging, or try two approaches to the same problem and keep the one you prefer. [Docs →](https://docs.superset.sh/workspaces)

Claude streaming a billing migration while other agents run in parallel workspaces

### Agent Monitoring Track every agent from the sidebar, with working indicators, completion chimes, and dock badges when one needs your attention. [Docs →](https://docs.superset.sh/agent-integration)

An agent finishing its task and the sidebar status flipping from working to done

### Built-in Terminal Tabs, infinite splits, presets, and persistent sessions that survive restarts. Press ⌘I for a rich prompt editor with multiline editing and @-file mentions. [Docs →](https://docs.superset.sh/terminal-integration)

Typing a follow-up with an @-file mention in the rich prompt editor next to a split terminal

### Command Palette Jump to any workspace, action, or setting from one search box. [Docs →](https://docs.superset.sh/keyboard-shortcuts)

Typing in the command palette and filtering workspace actions live

## Work across devices and on a schedule Connect another machine to reach its workspaces remotely, or schedule an agent to work on a recurring task. The CLI, SDK, and MCP server also let agents and scripts manage workspaces. Mobile requires **Superset Pro**, **iOS 26 or later**, and a computer with **Remote Access enabled**. [Remote access](https://docs.superset.sh/remote-access) · [Automations](https://docs.superset.sh/automations) · [iPhone](https://superset.sh/mobile) · [CLI](https://docs.superset.sh/cli/getting-started)

See mobile, automations, remote access, and the CLI

### Superset for iPhone Remotely control Claude Code, Codex, and other terminal agents running on your connected computer. Pick up the same workspaces and terminal sessions, send follow-up prompts, review diffs, and merge PRs from your iPhone. [**Download on the App Store**](https://apps.apple.com/us/app/id6788926383) • [Learn more →](https://superset.sh/mobile)

Superset desktop with an iPhone terminal session overlaid on the right

### Automations Run agent sessions on a schedule: triage issues overnight, draft the weekly changelog, keep dependencies fresh. [Docs →](https://docs.superset.sh/automations)

### Remote Access Connect another machine and reach its workspaces from anywhere: the desktop app, the CLI, or your phone. Wake offline hosts with a custom command. [Docs →](https://docs.superset.sh/remote-access)

Hosts and members in organization settings

### Superset CLI Script it from any shell: create workspaces, launch agents, read their terminals, and manage automations with a single binary. If an agent can run a command, it can drive Superset. [Docs →](https://docs.superset.sh/cli/getting-started)

Creating a workspace and launching an agent from the Superset CLI

## Customize your workflow - **[Built-in skills](https://docs.superset.sh/skills)**: agents come pre-loaded with `superset:*` skills (orchestrate parallel agents, schedule automations, file feedback, diagnose issues), provisioned automatically at launch - **[Workspace setup scripts](https://docs.superset.sh/setup-teardown-scripts)**: automate env setup, dependency installs, and dev servers per workspace - **[Terminal presets](https://docs.superset.sh/terminal-presets)**: save agent and shell layouts and open them with one keystroke - **[Slack & Linear](https://docs.superset.sh/use-with-linear)**: spin up workspaces from Slack messages or Linear issues - **[Open in your IDE](https://docs.superset.sh/use-with-ide)**: one-click handoff to Cursor, VS Code, or any editor - **[Custom themes](https://docs.superset.sh/custom-themes)**: build, edit, and import theme files - **[Keyboard shortcuts](https://docs.superset.sh/keyboard-shortcuts)**: every action is remappable via **Settings → Keyboard Shortcuts** (⌘/) - **[Bring your own providers](https://docs.superset.sh/providers)**: connect OpenRouter, Bedrock, Vertex, or Vercel AI Gateway - **And many more**: we ship daily, so this list is perpetually behind. The [changelog](https://superset.sh/changelog) is the real feature list. ## Supported Agents Keep your existing agent subscriptions. Use Claude Code, Codex, OpenCode, Cursor Agent, or another CLI coding agent.

Browse supported agents

| Agent | Status | |:------|:-------| |

[Amp Code](https://ampcode.com/) | Fully supported | |

[Antigravity CLI](https://antigravity.google/) | Fully supported | |

[Claude Code](https://github.com/anthropics/claude-code) | Fully supported | |

[OpenAI Codex CLI](https://github.com/openai/codex) | Fully supported | |

[Cursor Agent](https://docs.cursor.com/agent) | Fully supported | |

[Droid](https://www.factory.ai/) | Fully supported | |

[fx](https://fx.sh/) | Fully supported | |

[Gemini CLI](https://github.com/google-gemini/gemini-cli) | Fully supported | |

[GitHub Copilot](https://github.com/features/copilot) | Fully supported | |

[Grok](https://x.ai/) | Fully supported | |

[Hermes](https://github.com/NousResearch/hermes-agent) | Fully supported | |

[Muse Code](https://developer.meta.com/ai/products/muse-code/) | Fully supported | |

[Devin](https://devin.ai/cli) | Fully supported | |

[Kimi Code](https://www.kimi.com/) | Fully supported | | Kiro

[Kiro](https://kiro.dev/cli/) | Fully supported | |

[Mastra Code](https://mastra.ai/) | Fully supported | |

[Mistral Vibe](https://mistral.ai/) | Fully supported | |

[Oh My Pi](https://github.com/can1357/oh-my-pi) | Fully supported | |

[OpenCode](https://github.com/opencode-ai/opencode) | Fully supported | |

[Pi](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent) | Fully supported | |

Agents get more than a terminal: - **Model picker**: choose a model and reasoning effort when you launch an agent - **Per-agent settings**: tune launch commands, prompt templates, and model overrides in Settings → Agents - **Custom agents**: add any terminal agent with its own icon and it works like a built-in - **Built-in chat**: talk to models in a chat pane, with inline tool approvals and plan review ## More Than a Desktop App Every surface talks to the same workspaces, so you can start a task in the app and check on it from anywhere. | Surface | What you get | |:--------|:-------------| | [**Desktop App**](https://github.com/superset-sh/superset/releases/latest) | The full IDE: terminals, diff viewer, in-app browser, automations | | [**CLI**](https://docs.superset.sh/cli/getting-started) | A single `superset` binary to manage workspaces, agents, terminals, and hosts from any shell | | [**TypeScript SDK**](https://docs.superset.sh/sdk/getting-started) | Drive Superset programmatically with [`@superset_sh/sdk`](https://www.npmjs.com/package/@superset_sh/sdk) from Node, Bun, or Deno | | [**MCP Server**](https://docs.superset.sh/mcp) | Let Claude Code, Codex, Cursor, and other agents create and manage workspaces themselves | The CLI comes bundled with the desktop app, or install it standalone: ```bash curl -fsSL https://superset.sh/cli/install.sh | sh # or brew install superset-sh/tap/superset ``` ## Development Want to hack on Superset or contribute a PR? Clone the repository, add it to the installed Superset app, and create a workspace for your change: ```bash git clone https://github.com/superset-sh/superset.git ``` Then run the development setup from that workspace terminal: ```bash ./.superset/setup.local.sh bun run dev ``` Run `setup.local.sh` once in every new worktree. It configures workspace-specific app identity and ports so the development desktop app can run alongside the installed Superset app and other development worktrees. No Neon account or third-party credentials are needed. `setup.local.sh` brings up a local Postgres + neon-proxy + Redis stack via Docker and seeds a dev account. Sign in with the **"Sign in as dev"** button (or `admin@local.test` / `supersetdev`). Prereqs: [Bun](https://bun.sh/) v1.3.14+ (pinned in `.bun-version`), `docker`, `jq`, and [`gh`](https://cli.github.com/) (`brew install jq gh`). See [**DEVELOPMENT.md**](./DEVELOPMENT.md) for the full guide: what the setup script does, manual setup against real services, common commands, troubleshooting, and how to build the desktop app. Contribution process lives in [**CONTRIBUTING.md**](./CONTRIBUTING.md). ## Configuration Configure workspace setup, teardown, and run scripts in `.superset/config.json`. See [full documentation](https://docs.superset.sh/setup-teardown-scripts). ```json { "setup": ["./.superset/setup.sh"], "teardown": ["./.superset/teardown.sh"], "run": ["./.superset/run.sh"] } ``` ## Tech Stack

Browse the implementation stack

## Private by Default - **Explicit Connections**: you choose which agents, providers, and integrations to connect. ## Contributing We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for how to get set up and open a PR. Bugs and feature requests go in [issues](https://github.com/superset-sh/superset/issues).

[![GitHub stars](https://img.shields.io/github/stars/superset-sh/superset?style=flat&logo=github)](https://github.com/superset-sh/superset/stargazers) [![GitHub release](https://img.shields.io/github/v/release/superset-sh/superset?style=flat&logo=github)](https://github.com/superset-sh/superset/releases) [![License](https://img.shields.io/badge/license-Elastic%20License%202.0-blue?style=flat)](LICENSE.md) [![Twitter](https://img.shields.io/badge/@superset__sh-555?logo=x)](https://x.com/superset_sh) [![Discord](https://img.shields.io/badge/Discord-555?logo=discord)](https://discord.gg/cZeD9WYcV7)

🌐 Read this in other languages

## Community Join the Superset community to get help, share feedback, and connect with other users: - **[Discord](https://discord.gg/cZeD9WYcV7)**: chat with the team and community - **[Twitter](https://x.com/superset_sh)**: follow for updates and announcements - **[GitHub Issues](https://github.com/superset-sh/superset/issues)**: report bugs and request features - **[GitHub Discussions](https://github.com/superset-sh/superset/discussions)**: ask questions and share ideas ### Team [![Avi Twitter](https://img.shields.io/badge/Avi-@avimakesrobots-555?logo=x)](https://x.com/avimakesrobots) [![Kiet Twitter](https://img.shields.io/badge/Kiet-@flyakiet-555?logo=x)](https://x.com/flyakiet) [![Satya Twitter](https://img.shields.io/badge/Satya-@saddle__paddle-555?logo=x)](https://x.com/saddle_paddle) ## License & what's free forever **The desktop app is free forever.** Running agents in parallel on your own machine will never require payment. Anything we charge for will be an optional service on top. The whole app is in this repo under the [Elastic License 2.0](LICENSE.md): use it, fork it, modify it, self-host it for your team. The only thing off the table is repackaging Superset itself as a service you sell to others.