Superset

Run 10+ parallel coding agents on your machine

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.

Prerequisites:

1. Install Bun (package manager and Node runtime)

2. Clone the repo from GitHub

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

3. Set up environment variables

cp .env.example .env

Then edit .env and fill in the required values:

• Neon Database: DATABASE_URL, DATABASE_URL_UNPOOLED (required for database features)
• Clerk Auth: NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY, CLERK_SECRET_KEY (required for authentication)
• Optional: Neon org credentials, PostHog analytics, Blob storage

Install dependencies:

bun install

Run in dev mode:

bun run dev

Build desktop app:

bun run build
open apps/desktop/release       

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.

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.

Superet 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.

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.

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

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