Superset addresses the challenge of managing numerous concurrent CLI coding agents by providing a dedicated terminal environment for parallel execution. It targets developers and power users seeking to boost productivity by running dozens of agents like Claude Code or Codex simultaneously, allowing seamless switching between tasks and efficient monitoring of their progress.

How It Works

The core approach leverages Git worktrees to create isolated environments for each parallel task, ensuring organized workspaces and dedicated terminal systems. This design automates the setup of environment variables and dependencies via a .superset/config.json file, streamlining the onboarding for new agents. Superset actively monitors running agents, provides timely notifications when tasks are ready or require attention, and includes an integrated diff view with an editor for inspecting and managing agent outputs, aiming to be a superset of existing terminal tools by unifying agent management.

Quick Start & Requirements

• Install: Bun (package manager and Node runtime).
• Clone: git clone https://github.com/superset-sh/superset.git
• Configure: Copy .env.example to .env and fill in Neon Database (DATABASE_URL, DATABASE_URL_UNPOOLED) and Clerk Auth (NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY, CLERK_SECRET_KEY) credentials.
• Dependencies: bun install
• Run (Dev): bun run dev
• Build (Desktop): bun run build then open apps/desktop/release
• Note: Desktop app tested only on macOS.

Highlighted Details

• Enables running 10+ parallel CLI coding agents (e.g., Claude Code, Codex, or any other CLI tool).
• Task isolation is managed through Git worktrees, providing distinct environments for each agent.
• Features an integrated diff view with an editor for quickly inspecting and editing agent-generated changes.
• Provides comprehensive agent monitoring, including status updates and notifications for task completion or required intervention.

Maintenance & Community

• Community: Discord (https://discord.gg/cZeD9WYcV7), Twitter (https://x.com/superset_sh).
• Contribution: Detailed instructions are available in CONTRIBUTING.md.
• Docs: A cookbook with tips and motivation is located under docs/cookbook/README.md.

Licensing & Compatibility

• License: Apache 2.0.
• Compatibility: Designed to be a superset of existing tools, working with any CLI agent.

Limitations & Caveats

The Superset Desktop application has been built and tested exclusively on macOS; functionality on other operating systems is currently untested and may not be reliable.