https://github.com/superset-sh/superset
Code Editor for the AI Agents Era - Run an army of Claude Code, Codex, etc. on your machine
https://github.com/superset-sh/superset
agentic-ai ai-agents claude-code cli codex coding-agents cursor-agent desktop-app developer-tools electron git-worktree llm mcp opencode orchestration parallel-agents terminal tui vibe-coding worktrees
Last synced: 3 days ago
JSON representation
Code Editor for the AI Agents Era - Run an army of Claude Code, Codex, etc. on your machine
- Host: GitHub
- URL: https://github.com/superset-sh/superset
- Owner: superset-sh
- License: other
- Created: 2025-10-21T09:16:51.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-04-30T23:28:23.000Z (about 1 month ago)
- Last Synced: 2026-05-01T00:25:00.081Z (about 1 month ago)
- Topics: agentic-ai, ai-agents, claude-code, cli, codex, coding-agents, cursor-agent, desktop-app, developer-tools, electron, git-worktree, llm, mcp, opencode, orchestration, parallel-agents, terminal, tui, vibe-coding, worktrees
- Language: TypeScript
- Homepage: https://superset.sh
- Size: 174 MB
- Stars: 10,189
- Watchers: 26
- Forks: 842
- Open Issues: 980
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-ai-agents - superset-sh/superset - Superset is a desktop application (macOS) designed to orchestrate and manage multiple CLI-based AI coding agents in parallel, using Git worktrees for isolated task execution. (Agent Integration & Deployment Tools / AI Agent Orchestration)
- awesome-github-projects - superset - Code Editor for the AI Agents Era - Run an army of Claude Code, Codex, etc. on your machine ⭐10,687 `TypeScript` 🔥 (🤖 AI & Machine Learning)
- AiTreasureBox - superset-sh/superset - 03-09_6314_422](https://img.shields.io/github/stars/superset-sh/superset.svg)|IDE for the AI Agents Era - Run an army of Claude Code, Codex, etc. on your machine| (Repos)
- awesome - superset-sh/superset - Code Editor for the AI Agents Era - Run an army of Claude Code, Codex, etc. on your machine (TypeScript)
- awesome-vibe-coding - Superset - 桌面应用，可并行编排多个AI编程代理（Claude Code、Codex等），具有Git worktree隔离。 (本地应用)
- awesome-claude-code - superset-sh/superset - sh/superset?style=flat-square&logo=github) | Command center for running teams of Claude Code, OpenCode, Codex, and other agents | (Agent Orchestration)
- awesome-cli-agents - superset-sh/superset - Code Editor for the AI Agents Era - Run an army of Claude Code, Codex, etc. on your machine [Terminal] (10k⭐) (🚀 AI Tools for Vim, Neovim, and Terminal)
- awesome-ChatGPT-repositories - superset - Code Editor for the AI Agents Era - Run an army of Claude Code, Codex, etc. on your machine (CLIs)
- awesome-agent-orchestrators - superset - A terminal built for coding agents. (Parallel Agent Runners)
- awesome-claude-code - superset-sh/superset - sh/superset?style=flat) | Code editor built for running multiple Claude Code, Codex, and other AI agents in parallel using git worktrees | (📱 Interface Options)
- awesome-mcp - superset-sh/superset - Superset is a desktop application designed to orchestrate and manage multiple CLI-based AI coding agents in parallel, isolating each task within its own git worktree for efficient, concurrent devel... (MCP Clients / Agent Orchestration Platforms)
- awesome-agent-desktop - Superset - The terminal for orchestrating agents (Uncategorized / Uncategorized)
- awesome-openclaw-skills - superset-sh/superset - Run an army of Claude Code, Codex, etc. on your machine | 8.1k | (MCP Servers & Protocol)
- awesome-cli-coding-agents - Superset
- awesome-agent-cli - superset - sh/superset?style=flat-square&label=) | TypeScript | ![community][community] ![agent-first][agent-first] ![agent-app][agent-app] | Code editor for agents. Run multiple Claude Code / Codex. | (Agent Applications)
README
### The Code Editor for AI Agents
[](https://github.com/superset-sh/superset/stargazers)
[](https://github.com/superset-sh/superset/releases)
[](LICENSE.md)
[](https://x.com/superset_sh)
[](https://discord.gg/cZeD9WYcV7)
Orchestrate swarms of Claude Code, Codex, and more in parallel.
Works with any CLI agent. Built for local worktree-based development.
[**Download for macOS**](https://github.com/superset-sh/superset/releases/latest) • [Documentation](https://docs.superset.sh) • [Changelog](https://github.com/superset-sh/superset/releases) • [Discord](https://discord.gg/cZeD9WYcV7)
## 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](https://ampcode.com/) | Fully supported |
| 
[Claude Code](https://github.com/anthropics/claude-code) | Fully supported |
| 
[OpenAI Codex CLI](https://github.com/openai/codex) | Fully supported |
| 
[Cursor Agent](https://docs.cursor.com/agent) | Fully supported |
| 
[Droid](https://www.factory.ai/) | Fully supported |
| 
[Gemini CLI](https://github.com/google-gemini/gemini-cli) | Fully supported |
| 
[GitHub Copilot](https://github.com/features/copilot) | Fully supported |
| 
[Mastra Code](https://mastra.ai/) | Fully supported |
| 
[OpenCode](https://github.com/opencode-ai/opencode) | Fully supported |
| 
[Pi](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent) | 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](https://bun.sh/) v1.0+ |
| **Version Control** | Git 2.20+ |
| **GitHub CLI** | [gh](https://cli.github.com/) |
| **Caddy** | [caddy](https://caddyserver.com/docs/install) (for dev server) |
## Install
**[Download Superset for macOS](https://github.com/superset-sh/superset/releases/latest)**
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:
```bash
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**](./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**](./CONTRIBUTING.md).
## Keyboard Shortcuts
All shortcuts are customizable via **Settings > Keyboard Shortcuts** (`⌘/`). See [full documentation](https://docs.superset.sh/keyboard-shortcuts).
### 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](https://docs.superset.sh/setup-teardown-scripts).
```json
{
"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
```bash
#!/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
## 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](https://github.com/superset-sh/superset/issues) for bugs or feature requests.
See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions and code of conduct.
## Community
Join the Superset community to get help, share feedback, and connect with other users:
- **[Discord](https://discord.gg/cZeD9WYcV7)** — Chat with the team and community
- **[Twitter](https://x.com/superset_sh)** — Follow for updates and announcements
- **[GitHub Issues](https://github.com/superset-sh/superset/issues)** — Report bugs and request features
- **[GitHub Discussions](https://github.com/superset-sh/superset/discussions)** — Ask questions and share ideas
### Team
[](https://x.com/avimakesrobots)
[](https://x.com/flyakiet)
[](https://x.com/saddle_paddle)
## License
Distributed under the Elastic License 2.0 (ELv2). See [LICENSE.md](LICENSE.md) for more information.