At a Glance:
Superset is an orchestrator for CLI-based coding agents like Claude Code and Codex that runs multiple agents in parallel within isolated git worktrees, with built-in diff review and one-click IDE handoff.
Overview:
Superset is a macOS desktop application designed to orchestrate multiple CLI-based coding agents simultaneously. It allows developers to run agents such as Claude Code, OpenAI Codex CLI, and Gemini CLI in parallel, with each agent operating in its own isolated git worktree to prevent interference. The application provides a centralized interface for monitoring agent status, reviewing changes through a built-in diff viewer, and opening any workspace in an external editor or terminal with one click. Superset is built for local developers working with multiple agent-driven tasks who want to reduce context-switching and manual oversight overhead.
Key Decision Points:
Local macOS application: Superset is a native macOS app built for local development using worktree-based isolation.
Orchestrates any CLI agent: It is compatible with any CLI-based coding agent regardless of provider, including Claude Code, Codex, and Copilot.
Worktree-based isolation: Each task runs in its own git worktree, ensuring agents do not interfere with each other's branches or working directories.
Built-in review capabilities: A built-in diff viewer allows developers to inspect and edit agent-generated changes without leaving the application.
Keyboard-driven workflow: The application supports keyboard shortcuts for navigation, terminal management, layout control, and workspace presets, which are customizable via Settings.
Core Features:
Parallel agent execution: Run more than 10 coding agents simultaneously on a single machine.
Git worktree isolation: Each agent task is assigned its own branch and working directory to isolate changes.
Agent monitoring and notifications: Track agent status across tasks and receive notifications when changes are ready for review.
Built-in diff viewer: Inspect and modify agent output through an integrated diff interface.
Workspace presets: Automate environment setup and dependency installation through configurable preset commands.
IDE and terminal handoff: Open any workspace directly in a preferred external editor or terminal with a single action.
Use Cases:
A developer using multiple CLI coding agents like Claude Code and Codex can run them in parallel without manually managing separate terminal sessions or branches.
Developers can monitor long-running agent tasks across multiple worktrees and jump to tasks that require attention, reducing idle context-switching.
Users who need to quickly review AI-generated code changes can use the built-in diff viewer to inspect and edit changes before integrating them into a main branch.
Open-Source Alternative Value:
Superset provides a source-available option for developers who need a local orchestrator for CLI-based AI coding agents. Its source code is available under the Elastic License 2.0, offering transparency into how agent orchestration, worktree isolation, and monitoring are implemented. Superset's universal CLI agent compatibility and configurable workspace presets give developers a way to integrate orchestrator workflows into their local environment without relying on managed SaaS platforms.
