Skip to content

The terminal for parallel coding agents - Run dozens of Claude Code, OpenCode, or any other CLI agents in parallel on your machine using worktrees.

License

Notifications You must be signed in to change notification settings

superset-sh/superset

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
supersetlogo

Superset

Run 10+ parallel coding agents on your machine

Superset Twitter Superset Twitter

A Terminal Built for Coding Agents

Run 10+ CLI coding agents like Claude Code, Codex, etc. in parallel on your machine. Spin up new coding tasks while waiting for your current agent to finish. Quickly switch between tasks as they need your attention.

superset-demo.mp4

Getting Started

Prerequisites:

  1. Install Bun (package manager and Node runtime)
  2. Clone the repo from GitHub
git clone https://github.com/superset-sh/superset.git
  1. Set up environment variables (choose one):

    Option A: Full setup

    cp .env.example .env

    Then edit .env and fill in the values

    Option B: Skip env validation

    export SKIP_ENV_VALIDATION=1

    This skips environment validation, useful for quickly running the app without external services.

Install dependencies:

bun install

Run in dev mode:

bun run dev

Build desktop app:

bun run build
open apps/desktop/release       

Note

While Electron is cross-platform, Superset Desktop has only been built and tested on macOS. Other platforms are currently untested and may not work as expected.

Usage

For each parallel tasks, Superset uses git worktrees to clone a new branch on your machine. Automate copying env variables, installing dependencies, etc. through a config file (.superset/config.json). Each workspace gets their own organized terminal system. You can create default presets.

Screenshot 2025-12-24 at 9 33 35 PM

Superset monitors your running agents, notify you when changes are ready, and help coordinate between multiple agents. There's a diff view with editor built in so you can quickly inspect and edit agents' changes.

Screenshot 2025-12-24 at 9 33 51 PM

Superset is designed to be a superset of your existing tools. It works for any CLI agents that runs in the terminal. You can open your superset workspace in any apps like IDE, filesystem, terminal, etc.

Screenshot 2025-12-24 at 9 34 04 PM

Tech Stack

Electron React TailwindCSS Bun Turborepo Vite Biome Drizzle ORM Neon tRPC

Contributing

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also open issues.

See the CONTRIBUTING.md for instructions and code of conduct.

Cookbook

See tips and motivation under docs: docs/cookbook/README.md.

Follow Us

  • Avi Twitter
  • Kiet Twitter
  • Satya Twitter

License

Distributed under the Apache 2.0 License. See LICENSE.md for more information.

Packages

No packages published

Contributors 15

Languages