Skip to content
HN On Hacker News ↗

GitHub - superset-sh/superset: Code Editor for the AI Agents Era - Run an army of Claude Code, Codex, etc. on your machine

▲ 102 points 129 comments by avipeltz 2d ago HN discussion ↗

Pangram verdict · v3.3

We believe that this document is a mix of AI-generated, and human-written content

70 %

AI likelihood · overall

Mixed
26% human-written 74% AI-generated
SEGMENTS · HUMAN 1 of 3
SEGMENTS · AI 2 of 3
WORD COUNT 734
PEAK AI % 100% · §1
Analyzed
May 22
backend: pangram/v3.3
Segments scanned
3 windows
avg 245 words each
Distribution
26 / 74%
human / AI fraction
Verdict
Mixed
Pangram v3.3

Article text · 734 words · 3 segments analyzed

Human AI-generated
§1 AI · 100%

Code 10x Faster With No Switching Cost 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. Features

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

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

Agent Status

Amp Code Fully supported

Claude Code Fully supported

OpenAI Codex CLI Fully supported

Cursor Agent Fully supported

Gemini CLI Fully supported

GitHub Copilot Fully supported

OpenCode Fully supported

Pi Fully supported

Any CLI agent Will work

If it runs in a terminal, it runs on Superset Requirements

Requirement Details

OS macOS (Windows/Linux untested)

Runtime Bun v1.0+

Version Control Git 2.20+

GitHub CLI gh

Caddy caddy (for dev server)

Getting Started Quick Start (Pre-built) Download Superset for macOS Build from Source

Click to expand build instructions 1. Clone the repository git clone https://github.com/superset-sh/superset.git cd superset 2.

§2 Human · 24%

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

Keyboard Shortcuts All shortcuts are customizable via Settings > Keyboard Shortcuts (⌘/). See full documentation. Workspace Navigation

Shortcut Action

⌘1-9 Switch to workspace 1-9

⌘⌥↑/↓ Previous/next workspace

⌘N New workspace

⌘⇧N Quick create workspace

⌘⇧O Open project

Terminal

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

Layout

Shortcut Action

⌘B Toggle workspaces sidebar

⌘L Toggle changes panel

⌘O Open in external app

⌘⇧C Copy path

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

§3 AI · 100%

See full documentation. { "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

Example setup script #!/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

Mastra Dependencies This repo uses the published upstream mastracode and @mastra/* packages directly. Avoid adding custom tarball overrides unless there is a repo-specific blocker. Tech Stack

Private by Default

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.

Contributing 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 for bugs or feature requests. See CONTRIBUTING.md for detailed instructions and code of conduct.

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

Discord — Chat with the team and community Twitter — Follow for updates and announcements GitHub Issues — Report bugs and request features GitHub Discussions — Ask questions and share ideas

Team

License Distributed under the Elastic License 2.0 (ELv2). See LICENSE.md for more information.