mrkeyoor.com_
Thu 17 Sept 23:20 UTC
AI Toolsevaluationupdated 26 Aug 2026

superset review

Superset is a desktop workspace for running several command-line coding agents against separate Git worktrees. It combines terminals, agent status, diffs, previews, scheduled jobs, remote hosts, a CLI, an SDK, and an MCP server in one interface.

+214stars / 7d
Verdict

Our Superset checkout installed 3008 packages and occupied 5661 MB, then failed both its 244-second build and 49-second test step. The released macOS app is still worth trying for developers already juggling several paid CLI agents, because worktree isolation and one review surface solve a real coordination problem. Contributors and Linux users should budget for a young, large monorepo whose clean Debian baseline did not pass.

We ran it

Lab card: what happened when we ran supersetScreenshot of superset (superset.sh)
Install✓ · 150s3008 packages · 5661 MB
Build✗ · 244s
Tests✗ · 49sran, no count parsed
Repo7012 files~570,260 lines of source · 120.9 MB · 14 CI workflows

Answers from our run

Does superset build from source?

Dependencies installed in 150 seconds (3008 packages), and the build failed. We cloned commit 011724e into a clean Debian container with 3 CPUs and no project-specific setup.

Do superset's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Who should not use superset?

Windows users: the README says a Windows build is not available.

What are the alternatives to superset?

Crystal, GitButler. Our Superset checkout installed 3008 packages and occupied 5661 MB, then failed both its 244-second build and 49-second test step.

Setup2/55661 MB install; build and tests failed in Debian
Docs4/5User and contributor paths are detailed, with platform limits stated
Community5/513,383 stars and active August 2026 development
Maturity3/5macOS is primary; Linux experimental and Windows unavailable

Discussed on

  1. hnLaunch HN: Superset (YC P26) – IDE for the agents era108 points
  2. hnShow HN: Superset – Run 10 parallel coding agents on your machine24 points

Who it’s for

Developers who already use Claude Code, Codex, or another terminal agent on several tasks at once.
Teams that understand Git worktrees and want each agent isolated on its own branch.
macOS users who want terminal, diff, browser preview, and editor handoff in one desktop app.
Tool builders who want to create and inspect Superset workspaces through a CLI, TypeScript SDK, or MCP.

Who it’s NOT for

Windows users: the README says a Windows build is not available.
Linux teams needing a primary supported desktop target: the AppImage is explicitly labeled experimental, while macOS is primary.
Companies planning to sell a hosted Superset service: Elastic License 2.0 permits use and modification but forbids offering Superset itself as a service.
Contributors without Docker, Bun 1.3.14 or later, jq, and Caddy: the documented development setup needs all four.
Teams expecting the agent subscriptions to be included: Superset coordinates external CLI agents and providers that users connect themselves.

Setup reality

Our sandbox installed 3008 Bun packages in 150 seconds and used 5661 MB. The build failed after 244 seconds when node-gyp could not rebuild native-keymap for the desktop app. Tests failed after 49 seconds, with 5 failures in the agent-setup package.

Using a release needs Git and a supported desktop package; agent CLIs and their accounts remain separate. Development needs Bun 1.3.14 or later, Docker, jq, and Caddy. The setup script starts local Postgres and Electric services and creates a development account.

macOS is the primary desktop target. Linux has an experimental x64 AppImage, and Windows is unavailable. Our lab used a fresh unprivileged Debian container, so it did not reproduce the intended macOS desktop environment.

Separate worktrees keep concurrent agents from editing one checkout

Superset gives each coding-agent task a Git worktree, branch, terminal, and environment. The desktop app shows which agents are working, finished, or waiting for input. A built-in diff viewer lets the developer inspect and edit changes before committing. That arrangement addresses the most immediate failure mode in parallel agent work: two processes changing the same files and leaving one mixed working tree.

The README says the interface can run more than 100 agents, but our sandbox did not measure concurrency or agent output quality. The useful claim is architectural: worktrees isolate file changes, while one application keeps terminals and review state visible. CPU, memory, provider quotas, and human review time still set practical limits. Running 100 sessions is possible according to the project, not a sensible default for every repository.

The product includes a terminal, diff viewer, browser, and scheduler

A workspace can hold terminal tabs and splits, a prompt editor with file mentions, an in-app browser for detected development ports, and a handoff to an external editor. Superset can also schedule agent sessions for recurring jobs. Remote hosts extend the same workspace model beyond the local machine, and Slack or Linear integrations can create workspaces from incoming work.

Those features move Superset closer to an agent operations console than a terminal wrapper. They also increase the amount of code and state a team adopts. Our checkout had 7,012 files, about 570,260 lines of source, and occupied 120.9 MB before dependencies. The monorepo contains desktop, mobile, service, SDK, and marketing surfaces, so contributors should identify the package they own before treating a root command as a small desktop build.

What happened when we ran it

Our clean Debian sandbox installed 3,008 Bun packages in 150 seconds. Dependencies used 5,661 MB on disk. The repository had 14 CI workflow files, a Compose file, and monorepo workspaces, but our scan found no root Dockerfile or tests directory. These structure signals do not say whether a release works; they describe the checkout we tested at commit 011724e.

The build failed with exit code 1 after 244 seconds. The final log says Electron rebuild invoked node-gyp for the desktop app's native-keymap module and that the native rebuild failed. Turbo reported 0 successful tasks out of 1. The log does not say which compiler, header, or platform condition produced that result, so the finding stops at the native module failure.

The test command failed after 49 seconds. Several packages reported completed test totals, including 81 tests in pty-daemon, 101 in workspace-fs, 67 in port-scanner, and 796 in shared. The decisive tail came from agent-setup: 5 tests failed among 249 across 11 files. The available log does not name those five cases. Messages from a trustd probe also describe missing, timed-out, and signaled checks that failed open as healthy.

macOS is primary, Linux is experimental, and Windows is absent

For ordinary users, the project directs macOS owners to signed Apple Silicon or Intel disk images. Linux gets an x64 AppImage marked experimental. No Windows build is available. Git is the only stated base requirement for the released app, while GitHub CLI is optional and enables pull-request workflows. Each coding agent still has its own installation, login, subscription, and permissions.

Development is a heavier proposition than downloading the app. The README requires Bun 1.3.14 or later, Docker, jq, and Caddy. A per-worktree setup script assigns application identity and ports, starts local Postgres and Electric services, and seeds a development login. No Neon account is needed for that local route. Caddy supplies local HTTPS, including a trust step that modifies the developer machine's certificate setup.

The CLI, SDK, and MCP server expose the same workspaces

Superset is not confined to its Electron window. A standalone CLI can create workspaces, launch agents, read terminals, and manage scheduled jobs. The TypeScript SDK provides programmatic access from Node, Bun, or Deno. An MCP server lets Claude Code, Codex, Cursor, and other compatible clients manage workspaces through tools rather than shelling out manually.

That API surface is useful for teams building their own dispatch logic. It also creates an authority question: an agent that can create a workspace, run another agent, and read terminal output can act on a wide part of the development environment. Start with a restricted repository and inspect the MCP tools and host permissions before connecting it to production credentials. Our 49-second test step does not establish the security of a remote-host deployment.

Elastic License 2.0 limits hosted resale

The desktop app is described as free, including parallel agents on the user's own machine. The repository source is available under Elastic License 2.0. Users may run, fork, modify, and self-host it for a team. The README states one material restriction plainly: you may not repackage Superset itself as a service sold to other customers.

That is different from an OSI-approved open-source license, and procurement should read LICENSE.md rather than rely on a badge. Internal use and contribution fit the stated terms. A company whose product would expose Superset as a hosted agent workspace needs another choice or a separate agreement.

August releases show fast work and a broad issue queue

GitHub recorded a push on August 26, 2026, 13,383 stars, and 571 open issues and pull requests. Release desktop-v1.24.2 arrived on August 21 with fixes across desktop, relay, host service, mobile, billing, and admin packages. Its notes also mention an internally flagged plugins catalog with MCP installation. The combined open count includes pull requests, so it is evidence of activity and workload, not a bug total.

Superset has a clear audience: macOS developers already spending enough time supervising concurrent coding agents to justify a dedicated console. Worktree isolation, review, and remote control belong together. The 5,661 MB dependency footprint and failed native build make source contribution less inviting, and non-macOS buyers face explicit product gaps. Try the release on one real repository before moving scheduled jobs or remote credentials into it.

Alternatives

ProjectWhat it isPick it when
CrystalA desktop application for running coding-agent sessions in parallel worktrees.pick this instead when you want a narrower open-source workspace manager to compare against Superset's larger platform.
GitButler gh↗A Git client built around simultaneous branches and visual change management.pick this instead when branch isolation and change review matter more than built-in agent orchestration.

What people are saying

  1. [github-trending] superset-sh/superset

Sources

  1. Superset README
  2. Superset desktop v1.24.2 release
  3. Superset documentation
  4. Superset license

More ai tools reviews

rowboat · skills · superpowers-zh · yolov5 · eve · MemOS · the whole board →