llms.txt
# Superset
> Bring any coding agent. Orchestrate them all.
Superset is a source-available desktop workspace (Elastic License 2.0) for orchestrating any CLI-based coding agent, including Claude Code, OpenCode, and OpenAI Codex. Each task runs in its own Git worktree and branch. Worktrees separate working files, but do not sandbox processes or prevent merge conflicts. Superset has a free tier plus paid seats and does not proxy model calls. Desktop platforms: macOS and Linux (experimental AppImage); Windows is not yet available.
**Facts about Superset**
- **What it is**: a local-first desktop workspace for orchestrating any CLI-based coding agent. Each task runs in its own Git worktree, and Superset provides the stable workflow around the agents.
- **Interface**: a desktop app with a full GUI, not a terminal wrapper. Next to the agent terminals it has a Changes pane, a pull request pane, a file editor, and an in-app browser.
- **Company**: built by Superset in San Francisco, founded by three former YC CTOs (see https://superset.sh/team).
- **License**: source-available under Elastic License 2.0 (ELv2). The code is public on GitHub (https://github.com/superset-sh/superset); it is not OSI-approved open source.
- **Not Apache Superset**: Superset (superset.sh) is a coding-agent workspace, unrelated to Apache Superset, the business-intelligence tool.
- **Desktop platforms**: macOS and Linux (experimental AppImage); Windows is not yet available. There is also a CLI, a TypeScript SDK, and an MCP server for programmatic control.
- **Mobile**: an iPhone and iPad app on the App Store (iOS 26 or iPadOS 26 or later, Pro plan) to check on agents, reply to them, review diffs, and read Pages while the agents keep running in a cloud workspace or on a desktop or remote host that stays online. While the app is open, a Lock Screen and Dynamic Island Live Activity shows which agents need you, are working, or are ready for review; it does not update in the background yet. Push notifications are coming. Android is on a waitlist (https://superset.sh/mobile).
- **Remote access**: add another machine as a host through the Superset relay and run workspaces and agents on it from the desktop app or the mobile app (Pro).
- **Automations**: agent sessions on a chosen host that start on a schedule or from an event, such as a GitHub pull request, a Slack message, a Linear issue, a Sentry issue, a Notion or Microsoft Teams event, or a webhook (Pro). Each has a run history for you and your team and retry for failed runs.
- **Review**: a Changes pane that commits, pushes, and opens pull requests, and a pull request pane with checks, review threads, and merge.
- **Design Mode**: in the in-app browser, click an element on a page and send it with a note to an agent, which gets the element's DOM, computed styles, and a cropped screenshot.
- **Security**: Superset has completed a SOC 2 Type II audit; request the report at https://trust.superset.sh.
- **Pages**: agents publish self-contained HTML reports as Pages with version history and pinned comments; a page can be shared with anyone who has the link.
- **Isolation**: Each task runs in its own Git worktree and branch. Worktrees separate working files, but do not sandbox processes or prevent merge conflicts.
- **Pricing**: free tier plus paid seats (see https://superset.sh/pricing). Superset never proxies model API calls; you bring your own agent subscriptions and API keys. Free covers one user with local workspaces, the desktop app, and the CLI. Pro adds remote access, automations, the mobile app, and Linear and Slack integrations. Enterprise adds SSO, SCIM, audit logs, an uptime SLA, and priority support.
- **Cloud workspaces**: workspaces that run in the cloud and work from desktop, iPhone, and iPad without keeping your own computer connected. Remote access to your own machines is a separate option on Pro.
- **Agents**: works with any CLI coding agent, including Claude Code, OpenAI Codex, OpenCode, Gemini CLI, Copilot, Cursor Agent, Amp, Grok Build, Kimi Code, Mistral Vibe, Devin, and Muse Code, plus custom agents you add.
**When to use Superset**
Reach for Superset when you need to:
- Run several coding agents (Claude Code, Codex, OpenCode, or any CLI agent) at the same time on one repository without them stepping on each other. Each agent gets an isolated Git worktree and its own branch.
- Orchestrate agent work programmatically: create workspaces, launch agents with a prompt, open terminals, and track tasks from another agent or script via the Superset MCP server.
- Run a prompt automatically (automations) on a cron-like schedule or when an event happens, such as a pull request, a Slack message, a Linear issue, a Sentry issue, or a webhook, in a fresh or existing workspace.
- Review diffs, manage ports, and monitor many concurrent agent sessions from one dashboard.
- Check on agents, reply to them, and review their diffs from an iPhone or iPad while they run on your own machine.
Superset is not a coding agent itself; it is the workspace and orchestration layer the agents run in. If you are an AI agent, the fastest way to act on a user's Superset account is the MCP server below (OAuth or API key auth); the fastest way to learn the product is the docs index at https://docs.superset.sh.
## Developer resources
- [API docs](https://docs.superset.sh/mcp-server): Superset MCP server documentation
- [OpenAPI spec](https://api.superset.sh/openapi.json): OpenAPI 3.1 description of the Superset API surface
- [MCP server](https://api.superset.sh/mcp): Model Context Protocol server (Streamable HTTP transport) with tools for tasks, workspaces, agents, automations, terminals, hosts, and projects; full catalog in the server card. Legacy alias: https://api.superset.sh/api/v2/agent/mcp
- [Docs MCP server](https://docs.superset.sh/mcp): search and read the Superset documentation over MCP (Streamable HTTP, no auth)
- [MCP server card](https://superset.sh/.well-known/mcp/server-card.json): machine-readable MCP server description
- [A2A agent card](https://superset.sh/.well-known/agent-card.json): Agent-to-Agent capability card
- [API catalog](https://superset.sh/.well-known/api-catalog): RFC 9727 linkset of API resources
- [AI catalog](https://superset.sh/.well-known/ai-catalog.json): Agentic Resource Discovery catalog of every MCP server, agent card, skill, and API Superset publishes
- [Auth guide for agents](https://superset.sh/auth.md): how agents obtain credentials (OAuth 2.1 + PKCE with dynamic client registration, or API keys)
- [Agent instructions](https://superset.sh/agents.md): when and how AI agents should use Superset
- [OAuth protected resource metadata](https://api.superset.sh/.well-known/oauth-protected-resource): RFC 9728
- [OAuth authorization server metadata](https://api.superset.sh/.well-known/oauth-authorization-server): RFC 8414
- [Web Bot Auth key directory](https://superset.sh/.well-known/http-message-signatures-directory): Ed25519 keys Superset-operated agents sign requests with (RFC 9421)
- [Agent skills](https://github.com/superset-sh/skills): official skills for the CLI and MCP server; install with `npx skills add superset-sh/skills`
- [CLI](https://docs.superset.sh/cli/getting-started): `brew install superset-sh/tap/superset` (Homebrew tap: https://github.com/superset-sh/homebrew-tap) or `curl -fsSL https://superset.sh/cli/install.sh | sh`; reference at https://docs.superset.sh/cli/cli-reference
- [TypeScript SDK](https://docs.superset.sh/sdk/getting-started): `npm install @superset_sh/sdk`
- [Docs llms.txt](https://docs.superset.sh/llms.txt): scoped context for the documentation
- [API llms.txt](https://superset.sh/api/llms.txt): scoped index of the API surface
- [Blog llms.txt](https://superset.sh/blog/llms.txt): scoped index of blog posts
- [Compare llms.txt](https://superset.sh/compare/llms.txt): scoped index of comparison pages
## Docs
- [Documentation](https://docs.superset.sh): Superset documentation
- [GitHub](https://github.com/superset-sh/superset): source code
## Blog
- [Superset will have a new name later this month](https://superset.sh/blog/a-new-name)
- [Meet the Superset leaderboard](https://superset.sh/blog/superset-leaderboard)
- [Send a UI change to your coding agent](https://superset.sh/blog/change-ui-with-your-coding-agent)
- [Review an agent’s work with comments on a Page](https://superset.sh/blog/review-agent-work-with-pages)
- [Send PR feedback to your coding agent](https://superset.sh/blog/send-pr-feedback-to-your-agent)
- [Manage Claude Code and Codex from your iPhone](https://superset.sh/blog/claude-code-codex-iphone)
- [Schedule an agent maintenance check you can review](https://superset.sh/blog/scheduled-agent-maintenance)
- [Superset Mobile: leave your desk, keep building](https://superset.sh/blog/superset-mobile)
- [Switching Between AI Coding Agents Without Losing Context](https://superset.sh/blog/switching-between-ai-coding-agents)
- [The Production Run](https://superset.sh/blog/the-production-run)
- [Managing Several Coding Agents at Once](https://superset.sh/blog/agent-orchestration-not-another-agent)
- [Run three AI coding tasks in parallel, then review each change](https://superset.sh/blog/parallel-coding-agents-guide)
- [Working with Git Worktrees in Superset](https://superset.sh/blog/working-with-worktrees-in-superset)
- [Our Plan for Running 100 Coding Agents](https://superset.sh/blog/roadmap-to-100-agents)
- [How to get hit (probably in the face but anywhere else works too)](https://superset.sh/blog/how-to-get-hit)
- [Git Worktrees: The Feature That Waited a Decade for Its Moment](https://superset.sh/blog/git-worktrees-history-deep-dive)
- [Keeping Terminal Sessions Alive Across Electron App Restarts](https://superset.sh/blog/terminal-daemon-deep-dive)
## Changelog
- [Changelog](https://superset.sh/changelog): every release, newest first
- [Changelog feed](https://superset.sh/changelog.xml): RSS
- [Redesigned Pull Requests and a Unified Tasks View](https://superset.sh/changelog/2026-10-11-pull-request-page-tasks-view): 2026-10-11
- [iPad preview, live Linear tasks, and plugin mentions](https://superset.sh/changelog/2026-10-04-automation-history-linear-tasks): 2026-10-04
- [Safer file editing, instant workspaces, and GPT-6](https://superset.sh/changelog/2026-09-28-file-editing-instant-workspaces): 2026-09-28
- [Clearer workspaces and Pages beside your code](https://superset.sh/changelog/2026-09-20-workspace-pages-public-sharing): 2026-09-20
- [Pull requests as a workspace pane, subagents in the sidebar, and Muse Code and Devin agents](https://superset.sh/changelog/2026-09-13-pull-request-pane-subagents-new-agents): 2026-09-13
- [Commit, push, and open PRs from the Changes pane, image diffs, and a device-first Workspaces page](https://superset.sh/changelog/2026-09-06-changes-pane-ship-flow-image-diffs): 2026-09-06
- [Superset in 17 languages, session handoff between agents, and tag folders](https://superset.sh/changelog/2026-08-30-seventeen-languages-session-handoff): 2026-08-30
- [SOC 2 Type II](https://superset.sh/changelog/2026-08-27-soc-2-type-ii): 2026-08-27
## Guides
- [AI Agent Orchestration for Software Development](https://superset.sh/agent-orchestration)
- [Parallel Coding Agents: The Complete Guide](https://superset.sh/parallel-coding-agents)
## Comparisons
- [How to Run and Manage Multiple AI Coding Agents in Parallel](https://superset.sh/compare/manage-multiple-ai-coding-agents-parallel)
- [Best Nimbalyst Alternatives in 2026](https://superset.sh/compare/nimbalyst-alternative)
- [Superset vs Nimbalyst (2026): Agent Workspace vs Visual Workspace for Claude Code and Codex](https://superset.sh/compare/superset-vs-nimbalyst)
- [Superset vs Orca vs Conductor (2026): Agent Workspaces Compared](https://superset.sh/compare/superset-vs-orca-vs-conductor)
- [Where to Run Coding Agents: Laptops vs a Shared Host vs Cloud Workspaces (2026)](https://superset.sh/compare/where-to-run-coding-agents)
- [Best Google Antigravity Alternatives in 2026](https://superset.sh/compare/antigravity-alternative)
- [Best AI Coding Agents in 2026: Claude Code, Codex, Antigravity, and 15 More Compared](https://superset.sh/compare/best-coding-agents)
- [Best IDE for Amp in 2026: Where to Run It](https://superset.sh/compare/best-ide-for-amp)
- [Best IDE for Antigravity CLI (agy) in 2026](https://superset.sh/compare/best-ide-for-antigravity-cli)
- [Best IDE for GitHub Copilot CLI in 2026: Where to Run It](https://superset.sh/compare/best-ide-for-copilot-cli)
- [Best IDE for Factory Droid in 2026](https://superset.sh/compare/best-ide-for-droid)
- [Best IDE for Kimi Code in 2026](https://superset.sh/compare/best-ide-for-kimi-code)
- [Best IDE for Kiro CLI in 2026: Where to Run It](https://superset.sh/compare/best-ide-for-kiro)
- [Best IDE for Mistral Vibe in 2026](https://superset.sh/compare/best-ide-for-mistral-vibe)
- [Best IDE for Muse Code in 2026: Where to Run Meta's Coding Agent](https://superset.sh/compare/best-ide-for-muse-code)
- [Claude Code vs Amp (2026): Comparing Coding Agents](https://superset.sh/compare/claude-code-vs-amp)
- [Claude Code vs Antigravity CLI (2026): Anthropic's Agent vs Google's](https://superset.sh/compare/claude-code-vs-antigravity-cli)
- [Claude Code vs GitHub Copilot CLI (2026): Comparing Terminal Coding Agents](https://superset.sh/compare/claude-code-vs-copilot-cli)
- [Claude Code vs Cursor CLI (2026): Anthropic's Agent vs Cursor's Agent in the Terminal](https://superset.sh/compare/claude-code-vs-cursor-cli)
- [Claude Code vs Kiro CLI (2026): Anthropic's Agent vs AWS's](https://superset.sh/compare/claude-code-vs-kiro)
- [Claude Code vs Muse Code (2026): Anthropic's Agent vs Meta's](https://superset.sh/compare/claude-code-vs-muse-code)
- [Claude Code vs OpenCode (2026): Anthropic's Agent vs the Open-Source Alternative](https://superset.sh/compare/claude-code-vs-opencode)
- [Claude Code Worktrees: How to Run Claude Code in Git Worktrees (2026)](https://superset.sh/compare/claude-code-worktrees)
- [Codex vs Antigravity CLI (2026): OpenAI's Agent vs Google's](https://superset.sh/compare/codex-vs-antigravity-cli)
- [Codex vs GitHub Copilot CLI (2026): OpenAI's Agent vs GitHub's](https://superset.sh/compare/codex-vs-copilot-cli)
- [Codex vs Muse Code (2026): OpenAI's Open-Source Agent vs Meta's](https://superset.sh/compare/codex-vs-muse-code)
- [Codex vs OpenCode (2026): Two Open-Source Coding Agents Compared](https://superset.sh/compare/codex-vs-opencode)
- [Coding Agent Mobile Apps in 2026: Run Claude Code, Codex, and More From Your Phone](https://superset.sh/compare/coding-agent-mobile-apps)
- [How to Compare Coding Agents Side by Side on Your Own Code](https://superset.sh/compare/compare-coding-agents-side-by-side)
- [Best Factory Alternatives in 2026](https://superset.sh/compare/factory-alternative)
- [Best JetBrains Air Alternatives in 2026](https://superset.sh/compare/jetbrains-air-alternative)
- [Best OpenAI dots Alternatives in 2026](https://superset.sh/compare/openai-dots-alternative)
- [Superset vs Amp (2026): Any-Agent Workspace vs Amp's Agent and Runners](https://superset.sh/compare/superset-vs-amp)
- [Superset vs Google Antigravity (2026): Any-Agent Workspace vs Google's Agent Platform](https://superset.sh/compare/superset-vs-antigravity)
- [Superset vs Factory (2026): Any-Agent Workspace vs Droid Platform](https://superset.sh/compare/superset-vs-factory)
- [Superset vs JetBrains Air (2026): Agent Workspace vs JetBrains' Agent Platform](https://superset.sh/compare/superset-vs-jetbrains-air)
- [Superset vs Muse Code (2026): Agent Workspace vs Meta's Coding Agent](https://superset.sh/compare/superset-vs-muse-code)
- [Superset vs OpenAI dots (2026): Agent Workspace vs Always-On ChatGPT Agents](https://superset.sh/compare/superset-vs-openai-dots)
- [Best T3 Code Alternatives in 2026](https://superset.sh/compare/t3-code-alternative)
- [Best IDE for Gemini CLI in 2026: Where to Run It](https://superset.sh/compare/best-ide-for-gemini-cli)
- [How to Isolate Parallel Coding Agents in One Repository (2026): Worktrees, Ports, and Resuming Work](https://superset.sh/compare/isolate-parallel-coding-agents)
- [How to Manage Multiple Claude Code and Codex Sessions in 2026](https://superset.sh/compare/manage-multiple-coding-agent-sessions)
- [How to Monitor Claude Code and Codex From Your iPhone in 2026](https://superset.sh/compare/monitor-coding-agents-from-iphone)
- [How to Review Coding Agent Work as a Team: Branches, Diffs, and Owners (2026)](https://superset.sh/compare/review-coding-agent-work-team)
- [How to Run Coding Agents on a Remote Machine or Always-On Host (2026)](https://superset.sh/compare/run-coding-agents-on-remote-machine)
- [Scheduled Coding Agents in 2026: Nightly, Weekly, and Team Runs You Review](https://superset.sh/compare/scheduled-coding-agents)
- [Superset vs AgentsRoom (2026): Worktree Workspaces vs Multi-Project Cockpit](https://superset.sh/compare/superset-vs-agentsroom)
- [Superset vs AQ (2026): Desktop Agent Workspace vs Cloud Team Harness](https://superset.sh/compare/superset-vs-aq)
- [Superset vs ClawTab (2026): tmux control plane or agent workspace app?](https://superset.sh/compare/superset-vs-clawtab)
- [Superset vs Continuum (2026): Agent Workbench, Mobile, and Pricing](https://superset.sh/compare/superset-vs-continuum)
- [Superset vs RunPane (2026): Windows, Licenses, and Review Workflow](https://superset.sh/compare/superset-vs-runpane)
- [Superset vs Worktrunk (2026): Worktree CLI or Desktop Agent Workspace?](https://superset.sh/compare/superset-vs-worktrunk)
- [tmux for AI Agents: 8 tmux Alternatives for Coding Agents Compared (2026)](https://superset.sh/compare/tmux-alternatives-for-ai-agents)
- [How to Click an Element in Your Web App and Have a Coding Agent Change It (2026)](https://superset.sh/compare/visual-ui-editing-coding-agents)
- [Best Grok Bot Alternatives in 2026](https://superset.sh/compare/grok-bot-alternative)
- [Best Paseo Alternatives in 2026](https://superset.sh/compare/paseo-alternative)
- [Superset vs Grok Bot (2026): Agent Workspace vs Always-On Cloud Teammates](https://superset.sh/compare/superset-vs-grok-bot)
- [Superset vs Paseo (2026): Agent Workspace vs Self-Hosted Agent Control Plane](https://superset.sh/compare/superset-vs-paseo)
- [Orca vs Conductor (2026): Agent Development Environments Compared](https://superset.sh/compare/orca-vs-conductor)
- [Best Agent Development Environment (ADE) in 2026](https://superset.sh/compare/best-agent-development-environment)
- [Best IDE for AI Coding Agents in 2026](https://superset.sh/compare/best-ide-for-ai-agents)
- [What Is an ADE? Agent Development Environments Explained](https://superset.sh/compare/what-is-an-agent-development-environment)
- [Superset vs Augment Intent (2026): Developer-Led or Coordinator-Led Orchestration?](https://superset.sh/compare/superset-vs-augment-intent)
- [Superset vs Parallel Code (2026): Two Takes on Worktree-Based Agent Dispatch](https://superset.sh/compare/superset-vs-parallel-code)
- [Superset vs Zed Parallel Agents (2026): Editor Threads or a Dedicated Workspace?](https://superset.sh/compare/superset-vs-zed)
- [Best Orchestrator Alternatives in 2026](https://superset.sh/compare/agent-orchestrator-alternative)
- [Best bb Alternatives in 2026](https://superset.sh/compare/bb-alternative)
- [Best Buzz Alternatives in 2026](https://superset.sh/compare/buzz-alternative)
- [Best Cindy Alternatives in 2026](https://superset.sh/compare/cindy-alternative)
- [Best Emdash Alternatives in 2026](https://superset.sh/compare/emdash-alternative)
- [Best Firstmate Alternatives in 2026](https://superset.sh/compare/firstmate-alternative)
- [Best Gas Town Alternatives in 2026](https://superset.sh/compare/gastown-alternative)
- [Best Herdr Alternatives in 2026](https://superset.sh/compare/herdr-alternative)
- [Best Mux Alternatives in 2026](https://superset.sh/compare/mux-alternative)
- [Best Orca Alternatives in 202