# Launch HN: Superset (YC P26) – IDE for the agents era

> Source: <https://github.com/superset-sh/superset>
> Published: 2026-05-22 14:53:55+00:00

Orchestrate swarms of Claude Code, Codex, and more in parallel.

Works with any CLI agent. Built for local worktree-based development.

[ 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)

Superset orchestrates CLI-based coding agents across isolated git worktrees, with built-in terminal, review, and open-in-editor workflows.

**Run multiple agents simultaneously** without context switching overhead**Isolate each task** in its own git worktree so agents don't interfere with each other**Monitor all your agents** from one place and get notified when they need attention**Review and edit changes quickly** with the built-in diff viewer and editor**Open any workspace where you need it** with one-click handoff to your editor or terminal

Wait less, ship more.

| Feature | Description |
|---|---|
Parallel Execution |
Run 10+ coding agents simultaneously on your machine |
Worktree Isolation |
Each task gets its own branch and working directory |
Agent Monitoring |
Track agent status and get notified when changes are ready |
Built-in Diff Viewer |
Inspect and edit agent changes without leaving the app |
Workspace Presets |
Automate env setup, dependency installation, and more |
Universal Compatibility |
Works with any CLI agent that runs in a terminal |
Quick Context Switching |
Jump between tasks as they need your attention |
IDE Integration |
Open any workspace in your favorite editor with one click |

Superset works with any CLI-based coding agent, including:

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

[Claude Code](https://github.com/anthropics/claude-code)[OpenAI Codex CLI](https://github.com/openai/codex)[Cursor Agent](https://docs.cursor.com/agent)[Gemini CLI](https://github.com/google-gemini/gemini-cli)[GitHub Copilot](https://github.com/features/copilot)[OpenCode](https://github.com/opencode-ai/opencode)[Pi](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent)If it runs in a terminal, it runs on Superset

| Requirement | Details |
|---|---|
OS |
macOS (Windows/Linux untested) |
Runtime |
|

**Version Control****GitHub CLI**[gh](https://cli.github.com/)** Caddy**[caddy](https://caddyserver.com/docs/install)(for dev server)## Click to expand build instructions

**1. Clone the repository**

```
git clone https://github.com/superset-sh/superset.git
cd superset
```

**2. Set up environment variables** (choose one):

Option A: Full setup

```
cp .env.example .env
# Edit .env and fill in the values
```

Option B: Skip env validation (for quick local testing)

```
cp .env.example .env
echo 'SKIP_ENV_VALIDATION=1' >> .env
```

**3. Set up Caddy** (reverse proxy for Electric SQL streams):

```
# Install caddy: brew install caddy (macOS) or see https://caddyserver.com/docs/install
cp Caddyfile.example Caddyfile

# Without this, Chromium rejects https://localhost:* with ERR_CERT_AUTHORITY_INVALID.
# Prompts for sudo once.
caddy trust
```

**4. Install dependencies and run**

```
bun install
bun run dev
```

**5. Build the desktop app**

```
bun run build
open apps/desktop/release
```

All shortcuts are customizable via **Settings > Keyboard Shortcuts** (`⌘/`

). See [full documentation](https://docs.superset.sh/keyboard-shortcuts).

| Shortcut | Action |
|---|---|
`⌘1-9` |
Switch to workspace 1-9 |
`⌘⌥↑/↓` |
Previous/next workspace |
`⌘N` |
New workspace |
`⌘⇧N` |
Quick create workspace |
`⌘⇧O` |
Open project |

| Shortcut | Action |
|---|---|
`⌘T` |
New tab |
`⌘W` |
Close pane/terminal |
`⌘D` |
Split right |
`⌘⇧D` |
Split down |
`⌘K` |
Clear terminal |
`⌘F` |
Find in terminal |
`⌘⌥←/→` |
Previous/next tab |
`Ctrl+1-9` |
Open preset 1-9 |

| Shortcut | Action |
|---|---|
`⌘B` |
Toggle workspaces sidebar |
`⌘L` |
Toggle changes panel |
`⌘O` |
Open in external app |
`⌘⇧C` |
Copy path |

Configure workspace setup and teardown in `.superset/config.json`

. See [full documentation](https://docs.superset.sh/setup-teardown-scripts).

```
{
  "setup": ["./.superset/setup.sh"],
  "teardown": ["./.superset/teardown.sh"]
}
```

| Option | Type | Description |
|---|---|---|
`setup` |
`string[]` |
Commands to run when creating a workspace |
`teardown` |
`string[]` |
Commands to run when deleting a workspace |

``` bash
#!/bin/bash
# .superset/setup.sh

# Copy environment variables
cp ../.env .env

# Install dependencies
bun install

# Run any other setup tasks
echo "Workspace ready!"
```

Scripts have access to environment variables:

`SUPERSET_WORKSPACE_NAME`

— Name of the workspace`SUPERSET_ROOT_PATH`

— Path to the main repository

This repo uses the published upstream `mastracode`

and `@mastra/*`

packages directly. Avoid adding custom tarball overrides unless there is a repo-specific blocker.

**Source Available**— Full source is available on GitHub under Elastic License 2.0 (ELv2).** Explicit Connections**— You choose which agents, providers, and integrations to connect.

We welcome contributions! If you have a suggestion that would make Superset better:

- Fork the repository
- Create your feature branch (
`git checkout -b feature/amazing-feature`

) - Commit your changes (
`git commit -m 'Add amazing feature'`

) - Push to the branch (
`git push origin feature/amazing-feature`

) - Open a Pull Request

You can also [open issues](https://github.com/superset-sh/superset/issues) for bugs or feature requests.

See [CONTRIBUTING.md](/superset-sh/superset/blob/main/CONTRIBUTING.md) for detailed instructions and code of conduct.

Join the Superset community to get help, share feedback, and connect with other users:

— Chat with the team and community[Discord](https://discord.gg/cZeD9WYcV7)— Follow for updates and announcements[Twitter](https://x.com/superset_sh)— Report bugs and request features[GitHub Issues](https://github.com/superset-sh/superset/issues)— Ask questions and share ideas[GitHub Discussions](https://github.com/superset-sh/superset/discussions)

Distributed under the Elastic License 2.0 (ELv2). See [LICENSE.md](/superset-sh/superset/blob/main/LICENSE.md) for more information.