explaingit

superset-sh/superset

10,637TypeScriptAudience · vibe coderComplexity · 3/5Setup · moderate

TLDR

Superset is a macOS desktop app for running multiple AI coding agents in parallel, each in its own isolated git worktree, so you can tackle many tasks at once and review each agent's diff from one window.

Mindmap

mindmap
  root((Superset))
    What it does
      Run parallel AI agents
      Isolate with worktrees
      Review agent diffs
    Supported agents
      Claude Code
      GitHub Copilot
      OpenAI Codex
      Gemini CLI
    Tech stack
      Electron
      React
      Bun
    Workflow
      Create workspace
      Run agent
      Review and merge
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Run ten Claude Code or Copilot agents simultaneously on ten different tasks and monitor them all from one window.

USE CASE 2

Use git worktrees to let multiple AI agents edit your codebase in isolation without conflicting file changes.

USE CASE 3

Review and merge AI agent diffs using the built-in diff viewer after each agent finishes its task.

USE CASE 4

Configure automatic setup scripts to install dependencies in each agent workspace when it is created.

Tech stack

TypeScriptElectronReactBunTurborepo

Getting it running

Difficulty · moderate Time to first run · 30min

macOS only, requires Git 2.20+, GitHub CLI, and Bun to build from source, Windows and Linux are untested.

In plain English

Superset is a desktop application for macOS that lets you run multiple AI coding agents at the same time, each working on a separate task in its own isolated copy of your codebase. Instead of having one AI agent working on one problem while you wait, you can start ten agents on ten different tasks and monitor all of them from a single window. The way it achieves isolation is through git worktrees, a Git feature that lets you check out multiple branches of the same repository into separate directories at once. Each agent gets its own worktree, so their file changes do not conflict with each other or with your main working copy. When an agent finishes, you review its diff in the built-in viewer, edit anything that needs adjusting, and then merge or discard the changes. Superset works with any AI agent that runs in a terminal. The README lists explicit support for Claude Code, OpenAI Codex, Cursor Agent, Gemini CLI, GitHub Copilot, and others, but the tool is designed to work with any CLI-based agent regardless of vendor. You can also configure setup and teardown scripts that run automatically when a workspace is created or deleted, which is useful for copying environment files or installing dependencies. The app is built on Electron, React, and Bun, and uses Turborepo to manage its monorepo structure. A pre-built macOS download is available from the releases page. Building from source requires Bun, Git 2.20 or later, the GitHub CLI, and Caddy for the local development server. Windows and Linux are listed as untested. Keyboard shortcuts cover workspace navigation, terminal management, and layout toggling, and all shortcuts can be customized in the app settings.

Copy-paste prompts

Prompt 1
I want to use Superset to run five Claude Code agents in parallel on my repo. Walk me through creating workspaces and assigning a task to each.
Prompt 2
Show me how to write a Superset setup script that copies my .env file and runs npm install in each new worktree automatically.
Prompt 3
I finished reviewing an agent's changes in Superset. Walk me through merging its worktree branch back into my main branch.
Prompt 4
How do I configure custom keyboard shortcuts in Superset to switch between agent terminal windows faster?
Open on GitHub → Explain another repo

← superset-sh on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.