Superset: orchestrate parallel CLI coding agents in git worktrees

1 min read
claude-codeai-agentsgit-worktreescoding-agentsorchestrationelectronmacos
View as Markdown
Originally from github.com
View source

My notes

Summary

Superset is a macOS desktop app (source-available, Elastic License 2.0) that orchestrates multiple CLI coding agents in parallel, each isolated in its own git worktree. It works with any terminal-based agent - Claude Code, Codex, Cursor Agent, Gemini CLI, Copilot, OpenCode, Pi - and adds a built-in diff viewer, agent monitoring, and one-click editor handoff.

Key Insight

  • Worktree isolation is the core trick. Each task gets its own git branch + working directory, so 10+ agents can run simultaneously without stepping on each other. This is the cleanest way to fan out parallel agent work locally.
  • Agent-agnostic by design. “If it runs in a terminal, it runs on Superset.” No lock-in to a single vendor’s agent.
  • Built-in monitoring + notifications flag when an agent needs attention - solves the main pain of parallel agents (you can’t watch 10 terminals at once).
  • Per-workspace setup/teardown scripts in .superset/config.json automate env vars, dependency installs. Scripts get SUPERSET_WORKSPACE_NAME and SUPERSET_ROOT_PATH.
  • Stack notes: Electron + Bun, uses Electric SQL streams (needs Caddy reverse proxy locally because Chromium rejects self-signed https://localhost). Built on upstream mastracode / @mastra/* packages.
  • macOS only - Windows/Linux untested.