<div align="center">
<img width="full" alt="Superset" src="https://raw.githubusercontent.com/superset-sh/superset/HEAD/apps/marketing/public/images/readme-hero.png" />
AI 에이전트를 위한 코드 에디터 (Code Editor)
<br />
Claude Code, Codex 등을 병렬로 군집화하여 오케스트레이션 (Orchestrate) 하세요.<br />
모든 CLI 에이전트와 함께 작동합니다. 로컬 워크트리 (worktree) 기반 개발을 위해 구축되었습니다.
<br />
macOS용 다운로드 • 문서 (Documentation) • 변경 이력 (Changelog) • Discord
<br />
</div>
전환 비용 없이 10배 더 빠른 코딩
Superset은 터미널, 리뷰, 에디터에서 열기 워크플로 (workflow)가 내장되어 있으며, 격리된 git 워크트리 (worktree)를 통해 CLI 기반 코딩 에이전트들을 오케스트레이션 (orchestrate) 합니다.
- 여러 에이전트를 동시에 실행: 컨텍스트 스위칭 (context switching) 오버헤드 없이 여러 에이전트를 실행합니다.
- 각 작업을 격리: 각 작업을 개별 git 워크트리 (git worktree)에 격리하여 에이전트들이 서로 간섭하지 않도록 합니다.
- 모든 에이전트 모니터링: 한 곳에서 모든 에이전트를 모니터링하고, 주의가 필요한 경우 알림을 받습니다.
- 변경 사항을 빠르게 검토 및 편집: 내장된 디프 뷰어 (diff viewer) 및 에디터를 사용하여 변경 사항을 빠르게 검토하고 편집합니다.
- 필요한 모든 워크스페이스 열기: 클릭 한 번으로 에디터나 터미널로 작업을 넘길 수 있습니다.
기다림은 줄이고, 더 많이 배포하세요.
기능 (Features)
| 기능 | 설명 |
|---|
| 병렬 실행 (Parallel Execution) | 당신의 머신에서 10개 이상의 코딩 에이전트를 동시에 실행 |
| ... | |
지원되는 에이전트 (Supported Agents)
Superset은 다음을 포함하여 모든 CLI 기반 코딩 에이전트와 함께 작동합니다:
| 에이전트 | 상태 |
|---|
| Amp Code | 완벽 지원 |
| ... | |
| 터미널에서 실행될 수 있다면, Superset에서도 실행됩니다. | |
요구 사항 (Requirements)
| 요구 사항 | 세부 사항 |
|---|
| OS | macOS (Windows/Linux는 테스트되지 않음) |
| ... | |
시작하기 (Getting Started)
빠른 시작 (Quick Start) (사전 빌드됨)
macOS용 Superset 다운로드
소스에서 빌드하기 (Build from Source)
<details>
<summary>클릭하여 빌드 지침 펼치기</summary>
1. 저장소 복제 (Clone the repository)
git clone https://github.com/superset-sh/superset.git
cd superset
2. 환경 변수 설정 (Set up environment variables) (하나를 선택하세요):
옵션 A: 전체 설정 (Full setup)
옵션 B: 환경 변수 검증 건너뛰기 (빠른 로컬 테스트용)
cp .env.example .env
echo 'SKIP_ENV_VALIDATION=1' >> .env
3. Caddy 설정 (Set up Caddy) (Electric SQL 스트림을 위한 리버스 프록시 (reverse proxy)):
cp Caddyfile.example Caddyfile
...
4. 의존성 설치 및 실행 (Install dependencies and run)
5. 데스크톱 앱 빌드 (Build the desktop app)
bun run build
open apps/desktop/release
</details>
키보드 단축키 (Keyboard Shortcuts)
모든 단축키는 Settings > Keyboard Shortcuts (⌘/)를 통해 사용자 정의할 수 있습니다. 전체 문서를 참조하세요.
워크스페이스 탐색 (Workspace Navigation)
| 단축키 | 동작 |
|---|
⌘1-9 | 워크스페이스 1-9로 전환 |
| ... | |
터미널 (Terminal)
레이아웃 (Layout)
설정 (Configuration)
.superset/config.json에서 워크스페이스 설정(setup) 및 정리(teardown)를 구성하세요. 전체 문서를 참조하세요.
{
"setup": ["./.superset/setup.sh"],
"teardown": ["./.superset/teardown.sh"]
...
| 옵션 | 타입 | 설명 |
|---|
setup | string[] | 워크스페이스 생성 시 실행할 명령 |
teardown | string[] | 워크스페이스 삭제 시 실행할 명령 |
설정 스크립트 예시 (Example setup script)
스크립트는 다음과 같은 환경 변수 (Environment variables)에 접근할 수 있습니다:
SUPERSET_WORKSPACE_NAME — 워크스페이스 이름SUPERSET_ROOT_PATH — 메인 저장소 (Main repository) 경로
Mastra 의존성 (Dependencies)
이 저장소는 배포된 업스트림 (Upstream) mastracode 및 @mastra/* 패키지를 직접 사용합니다. 저장소 특유의 차단 요소가 없는 한, 커스텀 타르볼 (Custom tarball) 오버라이드를 추가하는 것은 피하십시오.
기술 스택 (Tech Stack)
<p>
<a href="https://www.electronjs.org/"><img src="https://img.shields.io/badge/Electron-191970?logo=Electron&logoColor=white" alt="Electron" /></a>
<a href="https://reactjs.org/"><img src="https://img.shields.io/badge/React-%2320232a.svg?logo=react&logoColor=%2361DAFB" alt="React" /></a>
<a href="https://tailwindcss.com/"><img src="https://img.shields.io/badge/Tailwindcss-%2338B2AC.svg?logo=tailwind-css&logoColor=white" alt="TailwindCSS" /></a>
<a href="https://bun.sh/"><img src="https://img.shields.io/badge/Bun-000000?logo=bun&logoColor=white" alt="Bun" /></a>
<a href="https://turbo.build/"><img src="https://img.shields.io/badge/Turborepo-EF4444?logo=turborepo&logoColor=white" alt="Turborepo" /></a>
<a href="https://vitejs.dev/"><img src="https://img.shields.io/badge/Vite-%23646CFF.svg?logo=vite&logoColor=white" alt="Vite" /></a>
<a href="https://biomejs.dev/"><img src="https://img.shields.io/badge/Biome-339AF0?logo=biome&logoColor=white" alt="Biome" /></a>
<a href="https://orm.drizzle.team/"><img src="https://img.shields.io/badge/Drizzle%20ORM-FFE873?logo=drizzle&logoColor=black" alt="Drizzle ORM" /></a>
<a href="https://neon.tech/"><img src="https://img.shields.io/badge/Neon-00E9CA?logo=neon&logoColor=white" alt="Neon" /></a>
<a href="https://trpc.io/"><img src="https://img.shields.io/badge/tRPC-2596BE?logo=trpc&logoColor=white" alt="tRPC" /></a>
</p>
기본적으로 비공개 (Private by Default)
- 소스 공개 (Source Available) — 전체 소스는 GitHub에서 Elastic License 2.0 (ELv2) 라이선스 하에 이용 가능합니다.
- 명시적 연결 (Explicit Connections) — 어떤 에이전트 (Agents), 프로바이더 (Providers), 통합 (Integrations)을 연결할지는 사용자가 직접 선택합니다.
기여하기 (Contributing)
우리는 기여를 환영합니다! Superset을 더 좋게 만들 제안이 있다면 다음 단계를 따라주세요:
- 저장소 (Repository)를 포크 (Fork) 합니다.
- 기능 브랜치 (Feature branch)를 생성합니다 (
git checkout -b feature/amazing-feature)
- 변경 사항을 커밋 (Commit) 합니다 (
git commit -m 'Add amazing feature')
- 브랜치로 푸시 (Push) 합니다 (
git push origin feature/amazing-feature)
- 풀 리퀘스트 (Pull Request)를 생성합니다
버그 리포트나 기능 요청을 위해 이슈 (Issues)를 생성할 수도 있습니다.
자세한 지침과 행동 강령 (Code of conduct)은 CONTRIBUTING.md를 참조하세요.
<a href="https://github.com/superset-sh/superset/graphs/contributors">
<img src="https://contrib.rocks/image?repo=superset-sh/superset" />
</a>
도움을 받고, 피드백을 공유하며, 다른 사용자들과 연결되려면 Superset 커뮤니티에 참여하세요:
팀 (Team)
라이선스 (License)
Elastic License 2.0 (ELv2)에 따라 배포됩니다. 자세한 내용은 LICENSE.md를 참조하세요.
