AI 에이전트를 위한 코드 에디터 (Code Editor)

Claude Code, Codex 등을 병렬로 군집화하여 오케스트레이션 (Orchestrate) 하세요.<br />
모든 CLI 에이전트와 함께 작동합니다. 로컬 워크트리 (worktree) 기반 개발을 위해 구축되었습니다.

macOS용 다운로드  •  문서 (Documentation)  •  변경 이력 (Changelog)  •  Discord

전환 비용 없이 10배 더 빠른 코딩

Superset은 터미널, 리뷰, 에디터에서 열기 워크플로 (workflow)가 내장되어 있으며, 격리된 git 워크트리 (worktree)를 통해 CLI 기반 코딩 에이전트들을 오케스트레이션 (orchestrate) 합니다.

• 여러 에이전트를 동시에 실행: 컨텍스트 스위칭 (context switching) 오버헤드 없이 여러 에이전트를 실행합니다.
• 각 작업을 격리: 각 작업을 개별 git 워크트리 (git worktree)에 격리하여 에이전트들이 서로 간섭하지 않도록 합니다.
• 모든 에이전트 모니터링: 한 곳에서 모든 에이전트를 모니터링하고, 주의가 필요한 경우 알림을 받습니다.
• 변경 사항을 빠르게 검토 및 편집: 내장된 디프 뷰어 (diff viewer) 및 에디터를 사용하여 변경 사항을 빠르게 검토하고 편집합니다.
• 필요한 모든 워크스페이스 열기: 클릭 한 번으로 에디터나 터미널로 작업을 넘길 수 있습니다.

기다림은 줄이고, 더 많이 배포하세요.

기능 (Features)

지원되는 에이전트 (Supported Agents)

Superset은 다음을 포함하여 모든 CLI 기반 코딩 에이전트와 함께 작동합니다:

요구 사항 (Requirements)

시작하기 (Getting Started)

빠른 시작 (Quick Start) (사전 빌드됨)

macOS용 Superset 다운로드

소스에서 빌드하기 (Build from Source)

1. 저장소 복제 (Clone the repository)

git clone https://github.com/superset-sh/superset.git
cd superset

2. 환경 변수 설정 (Set up environment variables) (하나를 선택하세요):

옵션 A: 전체 설정 (Full setup)

cp .env.example .env
# .env 파일을 편집하여 값을 채워 넣으세요

옵션 B: 환경 변수 검증 건너뛰기 (빠른 로컬 테스트용)

cp .env.example .env
echo 'SKIP_ENV_VALIDATION=1' >> .env

3. Caddy 설정 (Set up Caddy) (Electric SQL 스트림을 위한 리버스 프록시 (reverse proxy)):

# Caddy 설치: brew install caddy (macOS) 또는 https://caddyserver.com/docs/install 참조
cp Caddyfile.example Caddyfile

...

4. 의존성 설치 및 실행 (Install dependencies and run)

bun install
bun run dev

5. 데스크톱 앱 빌드 (Build the desktop app)

bun run build
open apps/desktop/release

키보드 단축키 (Keyboard Shortcuts)

모든 단축키는 Settings > Keyboard Shortcuts (⌘/)를 통해 사용자 정의할 수 있습니다. 전체 문서를 참조하세요.

워크스페이스 탐색 (Workspace Navigation)

터미널 (Terminal)

레이아웃 (Layout)

설정 (Configuration)

.superset/config.json에서 워크스페이스 설정(setup) 및 정리(teardown)를 구성하세요. 전체 문서를 참조하세요.

{
  "setup": ["./.superset/setup.sh"],
  "teardown": ["./.superset/teardown.sh"]
...

설정 스크립트 예시 (Example setup script)

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

...

스크립트는 다음과 같은 환경 변수 (Environment variables)에 접근할 수 있습니다:

• SUPERSET_WORKSPACE_NAME — 워크스페이스 이름
• SUPERSET_ROOT_PATH — 메인 저장소 (Main repository) 경로

Mastra 의존성 (Dependencies)

이 저장소는 배포된 업스트림 (Upstream) mastracode 및 @mastra/* 패키지를 직접 사용합니다. 저장소 특유의 차단 요소가 없는 한, 커스텀 타르볼 (Custom tarball) 오버라이드를 추가하는 것은 피하십시오.

기술 스택 (Tech Stack)

기본적으로 비공개 (Private by Default)

• 소스 공개 (Source Available) — 전체 소스는 GitHub에서 Elastic License 2.0 (ELv2) 라이선스 하에 이용 가능합니다.
• 명시적 연결 (Explicit Connections) — 어떤 에이전트 (Agents), 프로바이더 (Providers), 통합 (Integrations)을 연결할지는 사용자가 직접 선택합니다.

기여하기 (Contributing)

우리는 기여를 환영합니다! Superset을 더 좋게 만들 제안이 있다면 다음 단계를 따라주세요:

1. 저장소 (Repository)를 포크 (Fork) 합니다.
2. 기능 브랜치 (Feature branch)를 생성합니다 (git checkout -b feature/amazing-feature)
3. 변경 사항을 커밋 (Commit) 합니다 (git commit -m 'Add amazing feature')
4. 브랜치로 푸시 (Push) 합니다 (git push origin feature/amazing-feature)
5. 풀 리퀘스트 (Pull Request)를 생성합니다

버그 리포트나 기능 요청을 위해 이슈 (Issues)를 생성할 수도 있습니다.

자세한 지침과 행동 강령 (Code of conduct)은 CONTRIBUTING.md를 참조하세요.

커뮤니티 (Community)

도움을 받고, 피드백을 공유하며, 다른 사용자들과 연결되려면 Superset 커뮤니티에 참여하세요:

• Discord — 팀 및 커뮤니티와 채팅
• Twitter — 업데이트 및 공지사항 팔로우
• GitHub Issues — 버그 보고 및 기능 요청
• GitHub Discussions — 질문 및 아이디어 공유

팀 (Team)

라이선스 (License)

Elastic License 2.0 (ELv2)에 따라 배포됩니다. 자세한 내용은 LICENSE.md를 참조하세요.