Development
Plugin
superset
Code Editor for the AI Agents Era - Run an army of Claude Code, Codex, etc. on your machine
Plugin Signal83/100Strong
maintained100
capable50
documented100
adopted87
Install on Claude Code
> /plugin marketplace add superset-sh/superset> /plugin install superset@superset
What's inside
Skills
8/10xPersonalized audit that teaches advanced Superset features the user isn't using yet — automations, parallel agents, tasks, multi-host, terminals, custom commands, MCP. Use when the user wants to get more out of Superset, learn advanced Superset features, or 10x their Superset/automateTurn a recurring chore into a Superset automation — drafts the agent prompt, confirms schedule and target, creates it with the CLI, and reviews the first run together. Use when the user wants a scheduled or recurring agent, a daily/weekly job, or to automate a repeating task/contributeSet up a Superset open-source contribution — fork and clone superset-sh/superset, run local dev setup, and follow the repo's contribution rules through to a merge-ready PR. Use when the user wants to contribute to Superset, fix a Superset bug themselves, or prepare a PR against/doctorDiagnose and fix Superset problems — connection failures, offline hosts, terminals not attaching, auth or update issues. Use when the user reports something broken or misbehaving in Superset itself, before filing feedback./feedbackCollect and submit feedback about Superset — bug reports, feature requests, or general feedback — privately to the Superset team or as a public GitHub issue. Use when the user wants to report a Superset bug, request a feature, or send feedback about Superset./orchestrateCoordinate multiple terminal coding agents through the Superset CLI by creating isolated workspaces, launching workers, sending follow-ups, reading terminal output, tracking dependencies, and collecting structured results. Use when asked to delegate or parallelize coding work,
Show all 8 skillsShow fewer
/setupMake a repository Superset-ready — author .superset/config.json with setup/teardown/run scripts so every new workspace boots configured, then verify with a real workspace. Use when the user wants to set up a project or repo for Superset, configure workspace setup scripts, or fix/standupDigest of what your Superset agents did — sweeps workspaces, tasks, and agent terminals, then reports what finished, what needs review, and what's blocked. Use when the user asks what their agents did, wants a standup or summary of agent work, or returns after being away.
Badges
5
README
1The Code Editor for AI Agents
Orchestrate swarms of Claude Code, Codex, and more in parallel. Works with any CLI agent. Built for local worktree-based development.
Download for macOS • Documentation • Changelog • Discord
Code 10x Faster With No Switching Cost
Superset orchestrates CLI-based coding agents across isolated git worktrees, with built-in terminal, review, and open-in-editor workflows.
- Run multiple agents simultaneously without context switching overhead
- Isolate each task in its own git worktree so agents don't interfere with each other
- Monitor all your agents from one place and get notified when they need attention
- Review and edit changes quickly with the built-in diff viewer and editor
- Open any workspace where you need it with one-click handoff to your editor or terminal
- Reach your workspaces from anywhere via remote hosts, the CLI, the SDK, or MCP
Wait less, ship more.
Features
Parallel Workspaces
Run 10+ coding agents at once, each in its own git worktree with its own branch, terminal, and environment. Compare the results and merge the winner.
Agent Monitoring
Track every agent from the sidebar, with working indicators, completion chimes, and dock badges when one needs your attention.
Built-in Terminal
Tabs, infinite splits, presets, and persistent sessions that survive restarts. Press ⌘I for a rich prompt editor with multiline editing and @-file mentions.
Built-in Diff Viewer
Inspect, comment on, and edit agent changes without leaving the app, then commit and push when it's ready.
In-App Browser & Ports
Preview running dev servers in a browser pane. Ports are detected per workspace, so every worktree gets its own preview.
Automations
Run agent sessions on a schedule: triage issues overnight, draft the weekly changelog, keep dependencies fresh.
Remote Workspaces
Connect another machine and reach its workspaces from anywhere: the desktop app, the CLI, or your phone. Wake offline hosts with a custom command.
Command Palette
Jump to any workspace, action, or setting from one search box.
Also in the box:
- Built-in skills: agents come pre-loaded with
superset:*skills — orchestrate parallel agents, schedule automations, file feedback, diagnose issues — provisioned automatically at launch - Model picker & custom agents: choose a model and reasoning effort at launch, and add any terminal agent with its own icon
- Workspace setup scripts: automate env setup, dependency installs, and dev servers per workspace
- Terminal presets: save agent and shell layouts and open them with one keystroke
- Slack & Linear: spin up workspaces from Slack messages or Linear issues
- Open in your IDE: one-click handoff to Cursor, VS Code, or any editor
- Custom themes: build, edit, and import theme files
- Keyboard shortcuts: every action is remappable via Settings → Keyboard Shortcuts (⌘/)
- Bring your own providers: connect OpenRouter, Bedrock, Vertex, or Vercel AI Gateway
- And many more: we ship daily, so this list is perpetually behind. The changelog is the real feature list.
Supported Agents
Superset works with any CLI-based coding agent, including:
| Agent | Status |
|---|---|
| Amp Code | Fully supported |
| Claude Code | Fully supported |
| OpenAI Codex CLI | Fully supported |
| Cursor Agent | Fully supported |
| Droid | Fully supported |
| Gemini CLI | Fully supported |
| GitHub Copilot | Fully supported |
| Grok | Fully supported |
| Kimi Code | Fully supported |
| Mastra Code | Fully supported |
| Mistral Vibe | Fully supported |
| OpenCode | Fully supported |
| Pi | Fully supported |
| Polygraph | Fully supported |
| Any other CLI agent | Works without configuration |
If it runs in a terminal, it runs on Superset
Agents get more than a terminal:
- Model picker: choose a model and reasoning effort when you launch an agent
- Per-agent settings: tune launch commands, prompt templates, and model overrides in Settings → Agents
- Custom agents: add any terminal agent with its own icon and it works like a built-in
- Status and notifications: working indicators, completion chimes, and dock badges when an agent needs you
- Built-in chat: talk to models in a chat pane, with inline tool approvals and plan review
More Than a Desktop App
Every surface talks to the same workspaces, so you can start a task in the app and check on it from anywhere.
| Surface | What you get |
|---|---|
| Desktop App | The full IDE: terminals, diff viewer, in-app browser, automations |
| CLI | A single superset binary to manage workspaces, agents, terminals, and hosts from any shell |
| TypeScript SDK | Drive Superset programmatically with @superset_sh/sdk from Node, Bun, or Deno |
| MCP Server | Let Claude Code, Codex, Cursor, and other agents create and manage workspaces themselves |
The CLI comes bundled with the desktop app, or install it standalone:
curl -fsSL https://superset.sh/cli/install.sh | sh
# or
brew install superset-sh/tap/superset
An iOS app is coming soon so you can check on your agents from your phone.
Install
Download the desktop app:
- macOS: Apple Silicon (.dmg) · Intel (.dmg)
- Linux: x64 AppImage (experimental; macOS is the primary target)
- Windows: not yet available
- All builds
All you need installed is Git. gh is optional and unlocks the PR workflows; Superset offers to install it for you.
Development
Want to hack on Superset or contribute a PR? Clone the repository, add it to the installed Superset app, and create a workspace for your change:
git clone https://github.com/superset-sh/superset.git
Then run the development setup from that workspace terminal:
./.superset/setup.local.sh
bun run dev
Run setup.local.sh once in every new worktree. It configures workspace-specific
app identity and ports so the development desktop app can run alongside the
installed Superset app and other development worktrees.
No Neon account or third-party credentials are needed. setup.local.sh brings
up a local Postgres + Electric stack via Docker and seeds a dev account. Sign in
with the "Sign in as dev" button (or admin@local.test / supersetdev).
Prereqs: Bun v1.3.14+ (pinned in .bun-version), docker, jq, and caddy, which bun dev runs as the local HTTPS proxy (brew install jq caddy && caddy trust).
See DEVELOPMENT.md for the full guide: what the setup script does, manual setup against real services, common commands, troubleshooting, and how to build the desktop app. Contribution process lives in CONTRIBUTING.md.
Configuration
Configure workspace setup, teardown, and run scripts in .superset/config.json. See full documentation.
{
"setup": ["./.superset/setup.sh"],
"teardown": ["./.superset/teardown.sh"],
"run": ["./.superset/run.sh"]
}
Keyboard shortcuts are customizable via Settings → Keyboard Shortcuts (⌘/); see the full shortcut list.
Tech Stack
Private by Default
- Source Available: full source is on GitHub under Elastic License 2.0 (ELv2).
- Explicit Connections: you choose which agents, providers, and integrations to connect.
Contributing
We welcome contributions! See CONTRIBUTING.md for how to get set up and open a PR. Bugs and feature requests go in issues.
Community
Join the Superset community to get help, share feedback, and connect with other users:
- Discord: chat with the team and community
- Twitter: follow for updates and announcements
- GitHub Issues: report bugs and request features
- GitHub Discussions: ask questions and share ideas
Team
License & what's free forever
The desktop app is free forever. Running agents in parallel on your own machine will never require payment. Anything we charge for will be an optional service on top.
The whole app is in this repo under the Elastic License 2.0: use it, fork it, modify it, self-host it for your team. The only thing off the table is repackaging Superset itself as a service you sell to others.
File tree
1455superset-sh/supersetView on GitHub
.agents/
commands/
canaryrelease.md
ci-check.md
clean-neon-branches.md
create-plan.md
create-pr.md
deslop.md
draft.md
pr/
create-pr.md
refresh-compare-pages.md
respond-to-pr-comments.md
task-run.md
task.md
skills/
db-migrations/
SKILL.md
decide/
agents/
openai.yaml
SKILL.md
redesign/
agents/
openai.yaml
SKILL.md
ticket-format/
SKILL.md
.bun-version
.claude/
.claude-plugin/
marketplace.json
agents/
project-structure-validator.md
commands
settings.json
skills
.codex/
commands
config.toml
prompts
.cursor/
commands
.dockerignore
.env.example
.env.local.example
.github/
actions/
merge-mac-manifests/
action.yml
merge-mac-manifests.mjs
dependabot.yml
ISSUE_TEMPLATE/
bug_report.yml
config.yml
feature_request.yml
prompts/
beautify-screenshot.ts
triage-issue.md
update-roadmap.md
pull_request_template.md
templates/
cleanup-comment.md
preview-comment.md
workflows/
build-cli.yml
build-desktop.yml
bump-homebrew.yml
ci.yml
cleanup-preview.yml
deploy-preview.yml
deploy-production.yml
deploy-relay.yml
e2e-mobile.yml
release-cli-lockstep.yml
release-cli.yml
release-desktop-canary.yml
release-desktop.yml
triage-issue.yml
.gitignore
.mastracode/
mcp.json
.superset/
config.json
lib/
common.sh
setup/
args.sh
main.sh
steps.sh
teardown/
args.sh
main.sh
steps.sh
setup.local.sh
setup.sh
teardown.local.sh
teardown.sh
AGENTS.md
apps/
admin/
next.config.ts
package.json
postcss.config.mjs
public/
favicon-192.png
icon.png
yc-logo.png
sentry.edge.config.ts
sentry.server.config.ts
src/
app/
(dashboard)/
components/
AppSidebar/
AppSidebar.tsx
components/
AppSidebarHeader/
AppSidebarHeader.tsx
index.ts
NavUser/
index.ts
NavUser.tsx
SearchForm/
index.ts
SearchForm.tsx
index.ts
DemoCountdown/
DemoCountdown.tsx
index.ts
FunnelChart/
FunnelChart.tsx
index.ts
LeaderboardTable/
index.ts
LeaderboardTable.tsx
MetricCard/
index.ts
MetricCard.tsx
RetentionCard/
index.ts
RetentionCard.tsx
RevenueTrendChart/
index.ts
RevenueTrendChart.tsx
SignupsTrendChart/
index.ts
SignupsTrendChart.tsx
TimeRangePicker/
index.ts
TimeRangePicker.tsx
TrafficSourcesChart/
index.ts
TrafficSourcesChart.tsx
WAUTrendChart/
index.ts
WAUTrendChart.tsx
WeekPicker/
index.ts
WeekPicker.tsx
layout.tsx
page.tsx
users/
components/
UsersTable/
index.ts
UsersTable.tsx
page.tsx
favicon.ico
global-error.tsx
globals.css
layout.tsx
providers.tsx
components/
PostHogUserIdentifier/
index.ts
PostHogUserIdentifier.tsx
env.ts
instrumentation-client.ts
instrumentation.ts
proxy.ts
trpc/
query-client.ts
react.tsx
server.tsx
tsconfig.json
api/
.gitignore
next.config.ts
package.json
sentry.edge.config.ts
sentry.server.config.ts
src/
app/
.well-known/
mcp/
mcp.json/
route.ts
route.ts
server-card.json/
route.ts
oauth-authorization-server/
[...path]/
route.ts
route.ts
oauth-protected-resource/
[...path]/
route.ts
route.ts
openid-configuration/
[...path]/
route.ts
route.ts
api/
[...unmatched]/
route.ts
agent/
[transport]/
route.ts
auth/
[...all]/
route.ts
desktop/
connect/
route.ts
automations/
dispatch/
[id]/
route.ts
evaluate/
route.ts
run-failed/
route.ts
chat/
chat-attachments/
[id]/
route.ts
[sessionId]/
route.ts
stream/
route.ts
lib.ts
tools/
web-search/
route.ts
desktop/
version/
route.ts
github/
callback/
route.ts
install/
route.ts
jobs/
initial-sync/
route.ts
octokit.ts
sync/
route.ts
webhook/
route.ts
webhooks.ts
hosts/
jobs/
sync-presence/
route.ts
integrations/
linear/
callback/
route.ts
connect/
route.ts
jobs/
initial-sync/
route.ts
syncWorkflowStates.ts
utils.ts
refresh-tokens/
route.ts
sync-task/
route.ts
webhook/
route.ts
slack/
callback/
route.ts
connect/
route.ts
constants.ts
events/
process-app-home-opened/
build-home-view.ts
index.ts
process-app-home-opened.ts
process-assistant-message/
index.ts
process-assistant-message.ts
process-entity-details/
index.ts
process-entity-details.ts
process-link-shared/
index.ts
process-link-shared.ts
process-mention/
index.ts
process-mention.ts
route.test.ts
route.ts
utils/
generate-connect-url/
generate-connect-url.ts
index.ts
run-agent/
index.ts
mcp-clients.ts
run-agent.ts
slack-blocks/
index.ts
slack-blocks.ts
slack-client/
index.ts
slack-client.ts
slack-image-assets/
index.ts
slack-image-assets.ts
work-objects/
index.ts
work-objects.ts
interactions/
route.test.ts
route.ts
jobs/
process-assistant-message/
route.ts
process-mention/
route.ts
link/
route.ts
manifest.json
verify-signature.ts
stripe/
jobs/
notify-slack/
route.ts
slack-blocks.test.ts
slack-blocks.ts
proxy/
linear-image/
route.ts
route.ts
trpc/
[trpc]/
route.ts
v2/
agent/
[transport]/
route.ts
favicon.ico
global-error.tsx
mcp/
route.ts
openapi.json/
route.ts
bun-test.d.ts
env.ts
instrumentation.ts
lib/
agent-auth-metadata.ts
analytics.ts
oauth-metadata.ts
oauth-state.ts
relay-url.ts
strip-null-chars.ts
proxy.ts
trpc/
context.ts
tsconfig.json
desktop/
.github/
FUNDING.yml
.gitignore
.npmrc
AGENTS.md
BUILDING.md
bunfig.toml
CLAUDE.md
components.json
docs/
artifacts/
renderer-churn-visible-lifecycle-checkpoints.mp4
BRANCH_WORKSPACE_IMPROVEMENTS.md
BRANCH_WORKSPACE_UX.md
CHAT_PANEL_FEATURE.md
DESKTOP_NOTICES.md
EXTERNAL_FILES.md
HOST_SERVICE_ARCHITECTURE.md
HOST_SERVICE_BOUNDARIES.md
HOST_SERVICE_LIFECYCLE.md
INPUT_LAG_FIXES.md
KEYBOARD_SYSTEM.md
... 1600 moreShowing a partial view of a very large repo.
FAQ
superset is a Claude Code plugin with 8 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes 10x, automate, contribute. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is superset?
- Code Editor for the AI Agents Era - Run an army of Claude Code, Codex, etc. on your machine
- How do I install superset?
- Run these in Claude Code: /plugin marketplace add superset-sh/superset then /plugin install superset@superset. Then prompt normally.
- Does superset auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is superset free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.