MCPcopy
hub / github.com/superset-sh/superset

github.com/superset-sh/superset @desktop-v1.13.0 sqlite

repository ↗ · DeepWiki ↗ · release desktop-v1.13.0 ↗
12,016 symbols 38,416 edges 4,708 files 479 documented · 4%
README

Superset

The Code Editor for AI Agents

GitHub stars GitHub release License Twitter Discord

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

Wait less, ship more.

Features

Feature Description
Parallel Execution Run 10+ coding agents simultaneously on your machine
Worktree Isolation Each task gets its own branch and working directory
Agent Monitoring Track agent status and get notified when changes are ready
Built-in Diff Viewer Inspect and edit agent changes without leaving the app
Workspace Presets Automate env setup, dependency installation, and more
Universal Compatibility Works with any CLI agent that runs in a terminal
Quick Context Switching Jump between tasks as they need your attention
IDE Integration Open any workspace in your favorite editor with one click

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 | |

 Mastra Code | Fully supported | |

 OpenCode | Fully supported | |

 Pi | Fully supported | | Any other CLI agent | Works without configuration |

If it runs in a terminal, it runs on Superset

Requirements

Requirement Details
OS macOS (Windows/Linux untested)
Runtime Bun v1.0+
Version Control Git 2.20+
GitHub CLI gh
Caddy caddy (for dev server)

Install

Download Superset for macOS

Builds for Windows and Linux are not yet available.

Development

Want to hack on Superset or contribute a PR? Spin up a local dev environment in one command:

git clone https://github.com/superset-sh/superset.git
cd superset
./.superset/setup.local.sh
bun run dev

No Neon account or third-party credentials 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, docker, jq, caddy (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.

Keyboard Shortcuts

All shortcuts are customizable via Settings > Keyboard Shortcuts (⌘/). See full documentation.

Workspace Navigation

Shortcut Action
⌘1-9 Switch to workspace 1-9
⌘⌥↑/↓ Previous/next workspace
⌘N New workspace
⌘⇧N Quick create workspace
⌘⇧O Open project

Terminal

Shortcut Action
⌘T New tab
⌘W Close pane/terminal
⌘D Split right
⌘⇧D Split down
⌘K Clear terminal
⌘F Find in terminal
⌘⌥←/→ Previous/next tab
Ctrl+1-9 Open preset 1-9

Layout

Shortcut Action
⌘B Toggle workspaces sidebar
⌘L Toggle changes panel
⌘O Open in external app
⌘⇧C Copy path

Configuration

Configure workspace setup and teardown in .superset/config.json. See full documentation.

{
  "setup": ["./.superset/setup.sh"],
  "teardown": ["./.superset/teardown.sh"]
}
Option Type Description
setup string[] Commands to run when creating a workspace
teardown string[] Commands to run when deleting a workspace

Example setup script

#!/bin/bash
# .superset/setup.sh

# Copy environment variables
cp ../.env .env

# Install dependencies
bun install

# Run any other setup tasks
echo "Workspace ready!"

Scripts have access to environment variables: - SUPERSET_WORKSPACE_NAME — Name of the workspace - SUPERSET_ROOT_PATH — Path to the main repository

Mastra Dependencies

This repo uses the published upstream mastracode and @mastra/* packages directly. Avoid adding custom tarball overrides unless there is a repo-specific blocker.

Tech Stack

Electron React TailwindCSS Bun Turborepo Vite Biome Drizzle ORM Neon tRPC

Private by Default

  • Source Available — Full source is available on GitHub under Elastic License 2.0 (ELv2).
  • Explicit Connections — You choose which agents, providers, and integrations to connect.

Contributing

We welcome contributions! If you have a suggestion that would make Superset better:

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

You can also open issues for bugs or feature requests.

See CONTRIBUTING.md for detailed instructions and code of conduct.

Community

Join the Superset community to get help, share feedback, and connect with other users:

Team

Avi Twitter Kiet Twitter Satya Twitter

License

Distributed under the Elastic License 2.0 (ELv2). See LICENSE.md for more information.

Extension points exported contracts — how you extend this code

PtyDataDisposer (Interface)
* Thin adapter exposing approximately the IPty surface that the rest of * this file (and teardown.ts) was built against [15 …
packages/host-service/src/terminal/terminal.ts
FsHostService (Interface)
(no doc) [9 implementers]
packages/workspace-fs/src/host/service.ts
LinkProviderDisposable (Interface)
(no doc) [15 implementers]
apps/desktop/src/renderer/lib/terminal/terminal-link-manager.ts
Conn (Interface)
(no doc) [5 implementers]
packages/pty-daemon/src/handlers/handlers.ts
SpeechRecognition (Interface)
(no doc) [4 implementers]
packages/ui/src/components/ai-elements/prompt-input.tsx
ScannerSpy (Interface)
* Regression tests for #3372 ("excessive lsof spawning"). * * Three behaviors the fix guarantees: * 1. No scans run
packages/port-scanner/src/port-manager.test.ts
BlobLike (Interface)
* Intended to match DOM Blob, node-fetch Blob, node:buffer Blob, etc. * Don't add arrayBuffer here, node-fetch doesn't
packages/sdk/src/internal/to-file.ts
Pane (Interface)
(no doc)
packages/panes/src/types.ts

Core symbols most depended-on inside this repo

string
called by 1665
packages/cli-framework/src/option.ts
push
called by 1292
apps/desktop/src/renderer/lib/terminal/write-coalescer.ts
get
called by 868
packages/sdk/src/client.ts
cn
called by 864
apps/mobile/lib/utils.ts
slice
called by 559
packages/sdk/src/internal/to-file.ts
getState
called by 518
apps/desktop/src/renderer/routes/_authenticated/_dashboard/v2-workspace/$workspaceId/hooks/usePaneRegistry/components/BrowserPane/browserRuntimeRegistry.ts
has
called by 498
apps/desktop/src/renderer/lib/terminal/terminal-runtime-registry.ts
query
called by 484
packages/sdk/src/client.ts

Shape

Function 8,198
Interface 2,414
Method 1,125
Class 272
Enum 7

Languages

TypeScript100%
Python1%

Modules by API surface

apps/desktop/src/main/lib/terminal-host/client.ts66 symbols
packages/ui/src/components/ai-elements/prompt-input.tsx59 symbols
apps/desktop/src/lib/trpc/routers/workspaces/utils/git.ts57 symbols
packages/host-service/src/terminal/terminal.ts54 symbols
packages/host-service/src/runtime/chat/chat.ts51 symbols
apps/desktop/src/main/terminal-host/session.ts51 symbols
packages/host-service/src/daemon/DaemonSupervisor.ts50 symbols
apps/desktop/src/renderer/stores/tabs/utils.ts43 symbols
packages/workspace-fs/src/search.ts40 symbols
apps/desktop/src/renderer/lib/terminal/terminal-runtime-registry.ts40 symbols
packages/sdk/src/client.ts38 symbols
packages/host-service/src/runtime/pull-requests/pull-requests.ts38 symbols

Dependencies from manifests, versioned

@ai-sdk/anthropic3.0.64 · 1×
@ai-sdk/openai3.0.36 · 1×
@ai-sdk/react3.0.143 · 1×
@anthropic-ai/sdk0.78.0 · 1×
@ast-grep/napi0.41.1 · 1×
@babel/preset-typescript7.29.7 · 1×
@better-auth/api-key1.6.13 · 1×
@better-auth/expo1.6.13 · 1×
@better-auth/oauth-provider1.6.13 · 1×
@better-auth/stripe1.6.13 · 1×
@biomejs/biome2.4.2 · 1×
@clack/prompts0.10.1 · 1×

Datastores touched

dbDatabase · 1 repos
mainDatabase · 1 repos
prodDatabase · 1 repos

For agents

$ claude mcp add superset \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact