{"id":35085436,"url":"https://github.com/superset-sh/superset","last_synced_at":"2026-06-12T03:01:23.769Z","repository":{"id":323079853,"uuid":"1080370450","full_name":"superset-sh/superset","owner":"superset-sh","description":"Code Editor for the AI Agents Era - Run an army of Claude Code, Codex, etc. on your machine","archived":false,"fork":false,"pushed_at":"2026-04-30T23:28:23.000Z","size":182602,"stargazers_count":10189,"open_issues_count":980,"forks_count":842,"subscribers_count":26,"default_branch":"main","last_synced_at":"2026-05-01T00:25:00.081Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://superset.sh","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/superset-sh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-10-21T09:16:51.000Z","updated_at":"2026-04-30T23:50:57.000Z","dependencies_parsed_at":"2026-02-26T04:07:33.129Z","dependency_job_id":null,"html_url":"https://github.com/superset-sh/superset","commit_stats":null,"previous_names":["superset-sh/superset"],"tags_count":149,"template":false,"template_full_name":null,"purl":"pkg:github/superset-sh/superset","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superset-sh%2Fsuperset","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superset-sh%2Fsuperset/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superset-sh%2Fsuperset/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superset-sh%2Fsuperset/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/superset-sh","download_url":"https://codeload.github.com/superset-sh/superset/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superset-sh%2Fsuperset/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32629704,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-04T10:08:07.713Z","status":"ssl_error","status_checked_at":"2026-05-04T10:08:02.005Z","response_time":58,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2025-12-27T13:33:23.674Z","updated_at":"2026-05-29T03:01:44.906Z","avatar_url":"https://github.com/superset-sh.png","language":"TypeScript","funding_links":[],"categories":["🤖 AI \u0026 Machine Learning","TypeScript","Repos","本地应用","Agent Orchestration","AI Agent Frameworks \u0026 SDKs","🚀 AI Tools for Vim, Neovim, and Terminal","CLIs","Parallel Agent Runners","A01_文本生成_文本对话","📱 Interface Options","MCP Clients","Uncategorized","MCP Servers \u0026 Protocol","Harnesses \u0026 orchestration","Agent Applications","Catalog"],"sub_categories":["Multi-Agent Collaboration Systems","大语言对话模型及数据","Agent Orchestration Platforms","Uncategorized","Session managers \u0026 parallel runners","Reference Harness Implementations"],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg width=\"full\" alt=\"Superset\" src=\"apps/marketing/public/images/readme-hero.png\" /\u003e\n\n### The Code Editor for AI Agents\n\n[![GitHub stars](https://img.shields.io/github/stars/superset-sh/superset?style=flat\u0026logo=github)](https://github.com/superset-sh/superset/stargazers)\n[![GitHub release](https://img.shields.io/github/v/release/superset-sh/superset?style=flat\u0026logo=github)](https://github.com/superset-sh/superset/releases)\n[![License](https://img.shields.io/github/license/superset-sh/superset?style=flat)](LICENSE.md)\n[![Twitter](https://img.shields.io/badge/@superset__sh-555?logo=x)](https://x.com/superset_sh)\n[![Discord](https://img.shields.io/badge/Discord-555?logo=discord)](https://discord.gg/cZeD9WYcV7)\n\n\u003cbr /\u003e\n\nOrchestrate swarms of Claude Code, Codex, and more in parallel.\u003cbr /\u003e\nWorks with any CLI agent. Built for local worktree-based development.\n\n\u003cbr /\u003e\n\n[**Download for macOS**](https://github.com/superset-sh/superset/releases/latest) \u0026nbsp;\u0026bull;\u0026nbsp; [Documentation](https://docs.superset.sh) \u0026nbsp;\u0026bull;\u0026nbsp; [Changelog](https://github.com/superset-sh/superset/releases) \u0026nbsp;\u0026bull;\u0026nbsp; [Discord](https://discord.gg/cZeD9WYcV7)\n\n\u003cbr /\u003e\n\n\n\u003c/div\u003e\n\n## Code 10x Faster With No Switching Cost\n\nSuperset orchestrates CLI-based coding agents across isolated git worktrees, with built-in terminal, review, and open-in-editor workflows.\n\n- **Run multiple agents simultaneously** without context switching overhead\n- **Isolate each task** in its own git worktree so agents don't interfere with each other\n- **Monitor all your agents** from one place and get notified when they need attention\n- **Review and edit changes quickly** with the built-in diff viewer and editor\n- **Open any workspace where you need it** with one-click handoff to your editor or terminal\n\nWait less, ship more.\n\n## Features\n\n| Feature | Description |\n|:--------|:------------|\n| **Parallel Execution** | Run 10+ coding agents simultaneously on your machine |\n| **Worktree Isolation** | Each task gets its own branch and working directory |\n| **Agent Monitoring** | Track agent status and get notified when changes are ready |\n| **Built-in Diff Viewer** | Inspect and edit agent changes without leaving the app |\n| **Workspace Presets** | Automate env setup, dependency installation, and more |\n| **Universal Compatibility** | Works with any CLI agent that runs in a terminal |\n| **Quick Context Switching** | Jump between tasks as they need your attention |\n| **IDE Integration** | Open any workspace in your favorite editor with one click |\n\n## Supported Agents\n\nSuperset works with any CLI-based coding agent, including:\n\n| Agent | Status |\n|:------|:-------|\n| \u003cimg height=\"16\" align=\"top\" src=\"packages/ui/src/assets/icons/preset-icons/amp.svg\" /\u003e \u0026nbsp;[Amp Code](https://ampcode.com/) | Fully supported |\n| \u003cimg height=\"16\" align=\"top\" src=\"packages/ui/src/assets/icons/preset-icons/claude.svg\" /\u003e \u0026nbsp;[Claude Code](https://github.com/anthropics/claude-code) | Fully supported |\n| \u003cpicture\u003e\u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"packages/ui/src/assets/icons/preset-icons/codex-white.svg\" /\u003e\u003cimg height=\"16\" align=\"top\" src=\"packages/ui/src/assets/icons/preset-icons/codex.svg\" /\u003e\u003c/picture\u003e \u0026nbsp;[OpenAI Codex CLI](https://github.com/openai/codex) | Fully supported |\n| \u003cimg height=\"16\" align=\"top\" src=\"packages/ui/src/assets/icons/preset-icons/cursor.svg\" /\u003e \u0026nbsp;[Cursor Agent](https://docs.cursor.com/agent) | Fully supported |\n| \u003cpicture\u003e\u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"packages/ui/src/assets/icons/preset-icons/droid-white.svg\" /\u003e\u003cimg height=\"16\" align=\"top\" src=\"packages/ui/src/assets/icons/preset-icons/droid.svg\" /\u003e\u003c/picture\u003e \u0026nbsp;[Droid](https://www.factory.ai/) | Fully supported |\n| \u003cimg height=\"16\" align=\"top\" src=\"packages/ui/src/assets/icons/preset-icons/gemini.svg\" /\u003e \u0026nbsp;[Gemini CLI](https://github.com/google-gemini/gemini-cli) | Fully supported |\n| \u003cpicture\u003e\u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"packages/ui/src/assets/icons/preset-icons/copilot-white.svg\" /\u003e\u003cimg height=\"16\" align=\"top\" src=\"packages/ui/src/assets/icons/preset-icons/copilot.svg\" /\u003e\u003c/picture\u003e \u0026nbsp;[GitHub Copilot](https://github.com/features/copilot) | Fully supported |\n| \u003cpicture\u003e\u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"packages/ui/src/assets/icons/preset-icons/mastracode-white.svg\" /\u003e\u003cimg height=\"16\" align=\"top\" src=\"packages/ui/src/assets/icons/preset-icons/mastracode.svg\" /\u003e\u003c/picture\u003e \u0026nbsp;[Mastra Code](https://mastra.ai/) | Fully supported |\n| \u003cpicture\u003e\u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"packages/ui/src/assets/icons/preset-icons/opencode-white.svg\" /\u003e\u003cimg height=\"16\" align=\"top\" src=\"packages/ui/src/assets/icons/preset-icons/opencode.svg\" /\u003e\u003c/picture\u003e \u0026nbsp;[OpenCode](https://github.com/opencode-ai/opencode) | Fully supported |\n| \u003cpicture\u003e\u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"packages/ui/src/assets/icons/preset-icons/pi-white.svg\" /\u003e\u003cimg height=\"16\" align=\"top\" src=\"packages/ui/src/assets/icons/preset-icons/pi.svg\" /\u003e\u003c/picture\u003e \u0026nbsp;[Pi](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent) | Fully supported |\n| Any other CLI agent | Works without configuration |\n\nIf it runs in a terminal, it runs on Superset\n\n## Requirements\n\n| Requirement | Details |\n|:------------|:--------|\n| **OS** | macOS (Windows/Linux untested) |\n| **Runtime** | [Bun](https://bun.sh/) v1.0+ |\n| **Version Control** | Git 2.20+ |\n| **GitHub CLI** | [gh](https://cli.github.com/) |\n| **Caddy** | [caddy](https://caddyserver.com/docs/install) (for dev server) |\n\n## Install\n\n**[Download Superset for macOS](https://github.com/superset-sh/superset/releases/latest)**\n\nBuilds for Windows and Linux are not yet available.\n\n## Development\n\nWant to hack on Superset or contribute a PR? Spin up a local dev environment in one command:\n\n```bash\ngit clone https://github.com/superset-sh/superset.git\ncd superset\n./.superset/setup.local.sh\nbun run dev\n```\n\nNo 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`).\n\nPrereqs: `bun`, `docker`, `jq`, `caddy` (`brew install jq caddy \u0026\u0026 caddy trust`).\n\nSee [**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).\n\n## Keyboard Shortcuts\n\nAll shortcuts are customizable via **Settings \u003e Keyboard Shortcuts** (`⌘/`). See [full documentation](https://docs.superset.sh/keyboard-shortcuts).\n\n### Workspace Navigation\n\n| Shortcut | Action |\n|:---------|:-------|\n| `⌘1-9` | Switch to workspace 1-9 |\n| `⌘⌥↑/↓` | Previous/next workspace |\n| `⌘N` | New workspace |\n| `⌘⇧N` | Quick create workspace |\n| `⌘⇧O` | Open project |\n\n### Terminal\n\n| Shortcut | Action |\n|:---------|:-------|\n| `⌘T` | New tab |\n| `⌘W` | Close pane/terminal |\n| `⌘D` | Split right |\n| `⌘⇧D` | Split down |\n| `⌘K` | Clear terminal |\n| `⌘F` | Find in terminal |\n| `⌘⌥←/→` | Previous/next tab |\n| `Ctrl+1-9` | Open preset 1-9 |\n\n### Layout\n\n| Shortcut | Action |\n|:---------|:-------|\n| `⌘B` | Toggle workspaces sidebar |\n| `⌘L` | Toggle changes panel |\n| `⌘O` | Open in external app |\n| `⌘⇧C` | Copy path |\n\n## Configuration\n\nConfigure workspace setup and teardown in `.superset/config.json`. See [full documentation](https://docs.superset.sh/setup-teardown-scripts).\n\n```json\n{\n  \"setup\": [\"./.superset/setup.sh\"],\n  \"teardown\": [\"./.superset/teardown.sh\"]\n}\n```\n\n| Option | Type | Description |\n|:-------|:-----|:------------|\n| `setup` | `string[]` | Commands to run when creating a workspace |\n| `teardown` | `string[]` | Commands to run when deleting a workspace |\n\n### Example setup script\n\n```bash\n#!/bin/bash\n# .superset/setup.sh\n\n# Copy environment variables\ncp ../.env .env\n\n# Install dependencies\nbun install\n\n# Run any other setup tasks\necho \"Workspace ready!\"\n```\n\nScripts have access to environment variables:\n- `SUPERSET_WORKSPACE_NAME` — Name of the workspace\n- `SUPERSET_ROOT_PATH` — Path to the main repository\n\n## Mastra Dependencies\n\nThis repo uses the published upstream `mastracode` and `@mastra/*` packages directly. Avoid adding custom tarball overrides unless there is a repo-specific blocker.\n\n## Tech Stack\n\n\u003cp\u003e\n  \u003ca href=\"https://www.electronjs.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Electron-191970?logo=Electron\u0026logoColor=white\" alt=\"Electron\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://reactjs.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/React-%2320232a.svg?logo=react\u0026logoColor=%2361DAFB\" alt=\"React\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://tailwindcss.com/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Tailwindcss-%2338B2AC.svg?logo=tailwind-css\u0026logoColor=white\" alt=\"TailwindCSS\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://bun.sh/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Bun-000000?logo=bun\u0026logoColor=white\" alt=\"Bun\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://turbo.build/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Turborepo-EF4444?logo=turborepo\u0026logoColor=white\" alt=\"Turborepo\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://vitejs.dev/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Vite-%23646CFF.svg?logo=vite\u0026logoColor=white\" alt=\"Vite\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://biomejs.dev/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Biome-339AF0?logo=biome\u0026logoColor=white\" alt=\"Biome\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://orm.drizzle.team/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Drizzle%20ORM-FFE873?logo=drizzle\u0026logoColor=black\" alt=\"Drizzle ORM\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://neon.tech/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Neon-00E9CA?logo=neon\u0026logoColor=white\" alt=\"Neon\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://trpc.io/\"\u003e\u003cimg src=\"https://img.shields.io/badge/tRPC-2596BE?logo=trpc\u0026logoColor=white\" alt=\"tRPC\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Private by Default\n\n- **Source Available** — Full source is available on GitHub under Elastic License 2.0 (ELv2).\n- **Explicit Connections** — You choose which agents, providers, and integrations to connect.\n\n## Contributing\n\nWe welcome contributions! If you have a suggestion that would make Superset better:\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\nYou can also [open issues](https://github.com/superset-sh/superset/issues) for bugs or feature requests.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions and code of conduct.\n\n\u003ca href=\"https://github.com/superset-sh/superset/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=superset-sh/superset\" /\u003e\n\u003c/a\u003e\n\n## Community\n\nJoin the Superset community to get help, share feedback, and connect with other users:\n\n- **[Discord](https://discord.gg/cZeD9WYcV7)** — Chat with the team and community\n- **[Twitter](https://x.com/superset_sh)** — Follow for updates and announcements\n- **[GitHub Issues](https://github.com/superset-sh/superset/issues)** — Report bugs and request features\n- **[GitHub Discussions](https://github.com/superset-sh/superset/discussions)** — Ask questions and share ideas\n\n### Team\n\n[![Avi Twitter](https://img.shields.io/badge/Avi-@avimakesrobots-555?logo=x)](https://x.com/avimakesrobots)\n[![Kiet Twitter](https://img.shields.io/badge/Kiet-@flyakiet-555?logo=x)](https://x.com/flyakiet)\n[![Satya Twitter](https://img.shields.io/badge/Satya-@saddle__paddle-555?logo=x)](https://x.com/saddle_paddle)\n\n## License\n\nDistributed under the Elastic License 2.0 (ELv2). See [LICENSE.md](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperset-sh%2Fsuperset","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuperset-sh%2Fsuperset","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperset-sh%2Fsuperset/lists"}